Как работает Sidekick
Sidekick подбирает рекламу для ответа бота. Интеграция определяет, как этот ответ попадёт в Telegram.
Запрос и отправка
- 1Ответ ботаБот формирует обычный ответ.
- 2Запрос рекламыПередайте ответ и контекст в Sidekick.
- 3Отправка в TelegramОтправьте сообщение или rich-данные.
- 4СтатистикаПроверьте показы, клики и доход.
Сборка сообщения
Используйте inject() или POST /api/v1/ad, чтобы добавить рекламу к ответу. /ad/fetch возвращает данные текста или изображения, из которых интеграция собирает сообщение сама. Rich-форматы запрашиваются через /ad.
Если рекламы нет
Пустой результат — штатная ситуация. У /ad поле has_ad равно false, а message содержит исходный ответ. Отправьте его как обычно.
Когда учитывается показ
Учёт показа начинается при выдаче рекламы, до отправки ботом в Telegram. Успешный ответ API не подтверждает доставку в Telegram. Повторный запрос может выдать ещё одно объявление; статистика может появиться с задержкой.