Документация 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.

Скачать техническую инструкцию