Жарнама API және SDK қосу нұсқаулығы

ЖИ-қосымшаны қосу

Жарнама карточкасы ЖИ жауабынан бөлек көрсетіліп, «Жарнама» деп белгіленеді.

Қолданбаны қосыңыз

ЖИ иесінің кабинетіндегі «Қолданбалар» бөлімін ашыңыз. Атау мен HTTPS-мекенжайды көрсетіңіз. Қолданба тексеруге жіберіледі.

Кабинетті ашу

Сервер кілтін сақтаңыз

Кілт бір рет қана көрсетіледі. Оны сервер құпияларында сақтаңыз. Промптқа, браузер кодына не Git-ке жібермеңіз. Жоғалса, кабинетте ауыстырыңыз.

CONTEXTA_URL=https://inai.ad
CONTEXTA_PUBLISHER_KEY=ctx_pub_YOUR_SERVER_KEY

SDK қосыңыз

SDK файлдарын сервердегі бір бумаға жүктеп, клиент құрыңыз. Жарнама сұрауы қолданбамен қатар жұмыс істейді; ЖИ негізгі жауабы бөлек жасалады.

SDK файлдары

Сервер файлдарын бірге сақтаңыз. React үшін AdCard.tsx қосыңыз. Қарапайым сайт үшін contexta-sdk.js бар.

server.ts types.ts classify.ts need.ts catalog.ts partner.ts AdCard.tsx

import { createContexta } from "./inai/server.ts";

const ads = createContexta({
  baseUrl: process.env.CONTEXTA_URL!,
  apiKey: process.env.CONTEXTA_PUBLISHER_KEY!,
  classifier: classifyWithYourExistingModel,
});

Таңдау деректерін жіберіңіз

Жас, жарнамаға рұқсат пен географияны сенімді деректен алыңыз. sessionId сұраулар арасында, requestId бір операция қайталанғанда өзгермеуі керек. need ішінде нақты тауарды, пайдаланушы айтқан бюджетті және міндетті сипаттарды беріңіз.

const result = await ads.decideConversation({
  context: {
    requestId: stableOpportunityUuid,
    sessionId: stableRandomAdSessionId,
    country: trustedCountry, city: trustedCity,
    language: "ru", placement: "chat_card",
    age: trustedAge, adsAllowed: trustedConsent,
    sensitive: safetyResult.isSensitive,
  },
  messages: recentConversation,
  userTurn: fullSessionUserTurnCount,
});
// Only structured need/context leaves your backend.
// Raw conversation stays with your application.

Карточканы көрсетіңіз

ad өрісін жауап жанында не ағынның бөлек оқиғасы ретінде жіберіңіз. «Жарнама» белгісі бар бір карточканы көрсетіңіз. Пайдаланушы бас тартса, келесі жарнама сұрауларын тоқтатыңыз.

Көрсетілім мен басуды тексеріңіз

Алаң мақұлданып, көрсетілім қосылған соң тексеріңіз: карточка кемінде бір секунд көрінеді — есепте бір көрсетілім; пайдаланушы басады — бір басу. Сол оқиғаның қайталануы қайта есептен шығаруға әкелмеуі керек.

Сайттан қандай дерек аламыз

Бетте көрсетілсе, атау, сипаттама, сурет, баға мен валюта, сипаттамалар мен география алынады. Санат пен ұсыныс түрін тексеру керек. Баға аралықпен берілсе, жазылым мерзімі белгісіз болса не дерек тек JavaScript орындалған соң ашылса, қолмен нақтылаңыз. Google Ads CSV арқылы қолдау табады; аккаунтты тікелей қосу әлі жоқ.

Іске қосар алдында не тексеру керек

Кілт серверде сақталған. Науқан мен алаң мақұлданған.
Тауар, ел, тіл, баға мен сипаттамалар сұрауға сай.
Алаң баптаулары көрсетілімге рұқсат етеді: аралық пен лимиттер сақталған.
Қате, таймаут, жас белгісіздігі, жарнамадан бас тарту не сезімтал тақырып кезінде қолданба жарнамасыз жауап береді.
Карточка көрінеді, сілтеме ашылады, көрсетілім мен басу есепке түседі.

Жарнама неге шықпады

Бұл әрдайым қате емес. Көрсетілім өшірулі, сұрау дерегі жеткіліксіз, сәйкес ұсыныс жоқ не лимитке жеткен болуы мүмкін. Себебін API жауабынан, қосылым күйін кабинеттен тексеріңіз. Көрсетілім алу үшін ғана сұрауды қайталамаңыз.

Әзірлеушіге не ЖИ көмекшісіне

Integrate inai.ad into the existing backend. Read:
https://inai.ad/sdk/partner-integration.md
https://inai.ad/sdk/integrator-agent.md
https://inai.ad/sdk/context-prompt.md

Keep the current AI provider, auth and independent answer.
Use server-only credentials and structured need.
Verify real visibility, native click navigation and reports.
Never fabricate production integration evidence.

Техникалық нұсқаулықты жүктеу

inai.ad жарнамасын қалай іске қосамыз