Монетизация телеграм-бота без токена: как подключить рекламу и получать оплату

Как работает монетизация телеграм-бота без токена

У HiViews два режима подключения. С токеном сеть сама отправляет рекламу от имени бота: с вашей стороны один вызов API. Без токена отправкой занимается ваш код: бот спрашивает у сети, есть ли реклама для этого человека, получает готовый пост и отправляет его сам.

Стоит ли опасаться передачи токена и что с ним может сделать рекламная сеть — отдельная тема, она разобрана в статье «Безопасно ли давать токен бота рекламной сети». Здесь только практика: как подключить бота, что проверить в коде и за что вы получаете оплату.

Что понадобится:

• бот, которым пользуются живые люди;
• доступ к этому боту в @BotFather, чтобы изменить его описание;
• возможность добавить в код бота одну функцию и два её вызова.

Как подключить рекламу в бота без токена: пять шагов

1. Добавьте бота в кабинете

   В веб-кабинете откройте подключение бота и выберите способ «Без токена».

2. Подтвердите, что бот ваш

   Кабинет покажет короткий код. Вставьте его в описание бота: @BotFather → Edit Bot → Edit About. По этому коду HiViews убеждается, что ботом управляете вы.

3. Получите API-ключ

   После подтверждения вы получаете API-ключ. Бот проходит модерацию, как и любой другой в сети. В настройках можно выбрать, какие форматы продавать, и отказаться от отдельных категорий рекламы.

4. Вставьте готовую функцию

   В документации есть готовый код для Python (aiogram), Node.js (Telegraf) и PHP. Функция запрашивает пост и отправляет его нужным методом — с фото, видео, GIF или просто текстом. Остаётся подставить ключ.

5. Вызовите её в двух местах

   В обработчике /start — с StartPlace: true, до собственного приветствия бота. И после того, как бот выдал человеку результат, — с StartPlace: false.

Общие правила для владельцев ботов — в гайде для владельцев.

Запрос рекламы: что бот отправляет и что получает

Запрос один: POST https://hiviews.net/api/partner/ad с заголовком Authorization, в котором передаётся API-ключ.

Ответ — всегда JSON. Если реклама есть, приходит "ok": true и объект ad: текст, кнопки и, если они есть, фото, видео или GIF. Его нужно отправить пользователю как есть. Если подходящей рекламы нет — "ok": false, и бот просто продолжает работу. Поле delete_after, если оно пришло, означает, что пост нужно удалить через указанное число секунд.

Пустой ответ — обычная ситуация, а не ошибка. Сеть бережёт пользователей: один человек видит не больше одной рекламы в час и шести в день во всех ботах сети, а приветственную рекламу в одном боте — не чаще раза в сутки.

Как Telegram подтверждает отправку поста

Без токена сеть не видит, отправил ли бот пост на самом деле. Поэтому отправку подтверждает сам Telegram: текст поста начинается с невидимой ссылки, и когда бот действительно отправляет сообщение, Telegram запрашивает её. Так HiViews узнаёт, что пост ушёл пользователю.

Отсюда три правила, без которых оплата не работает:

• Не отключайте предпросмотр ссылок. Параметр disable_web_page_preview должен оставаться выключенным: без предпросмотра Telegram не обратится к ссылке, и отправка останется неподтверждённой.
• Не меняйте текст. Не убирайте ссылки, не переписывайте пост и не добавляйте к нему своё.
• Не трогайте кнопки. Ссылки в кнопках идут через hiviews.net — так считаются переходы. Переход по изменённой ссылке не оплачивается.

Оплата за показы без токена: что оплачивается с первого дня

Все кампании — сразу

Бот без токена с самого начала получает все кампании сети: приветственные и обычные показы, кампании с оплатой за показы и с фиксированной ценой клика — $0,04 за переход. Отдельного одобрения и ожидания нет. Когда для человека нет подходящей кампании сети, показывается внешняя реклама; она оплачивается только за переходы, цена сильно зависит от страны и аудитории, а доход зачисляется на следующий день.

Как подтверждается показ

Оплачивается каждый показ, отправку которого подтвердил сам Telegram: в посте есть скрытая ссылка, и серверы Telegram запрашивают её, когда сообщение отправлено. Поэтому бот должен отправлять пост ровно в том виде, в каком получил, и не отключать предпросмотр ссылок. Неподтверждённый пост не оплачивается.

Ставка за показ

Ставка за показ без токена ниже, чем с токеном. С токеном это $4,80 за 1000 приветственных и $2,40 за 1000 обычных показов, и подтверждение не требуется: рекламу отправляет сама HiViews. Переходы по рекламе с оплатой за клик оплачиваются как и раньше — $0,04 за переход.

Из-за чего оплату за показы отключают

Каждая рекламная ссылка проходит через трекинг HiViews, и сеть знает, как часто по тем же кампаниям переходят в ботах с токеном. Если переходы у бота не сходятся с показами — их намного меньше или намного больше ожидаемого, — оплата за показы отключается автоматически, и бот возвращается к оплате только за переходы. Бот, который на деле не отправляет большую часть взятых постов, перестаёт получать рекламу. Есть и защита на уровне кликов: не больше одного платного перехода с одного IP-адреса в час, а при неправдоподобно высокой доле кликов оплата приостанавливается. Как сеть отличает живую аудиторию от накрученной — в статье о накрутке в Telegram-ботах.

Заработок становится доступен к выводу через 7 дней, вывод — от $50 в USDT TRC20; заработанное можно и перевести на рекламный баланс. Подробности — в гайде по финансам.

Реклама в боте без передачи токена и с токеном: в чём разница

Режим можно сменить в любой момент: вставьте токен на странице бота в кабинете. Новая модерация не нужна, API-ключ остаётся прежним, код менять не придётся — тот же запрос продолжит работать, а показы начнут оплачиваться по полной ставке. О других способах заработка на боте — в статье «Как монетизировать Telegram-бота».

Частые ошибки при интеграции

• Обычная реклама запрашивается до результата. Сначала отдайте человеку то, за чем он пришёл, — файл, ответ, видео — и только потом запрашивайте рекламу. Тогда пост остаётся последним сообщением в чате; иначе результат сразу вытеснит его из поля зрения.
• Пост изменён. Свой текст в начале, обрезанные строки, заменённые кнопки или ссылки — и отправка не подтверждается, а пост не оплачивается.
• Отключён предпросмотр ссылок. Часто он выключен глобально в настройках бота или библиотеки. Для рекламного сообщения предпросмотр должен быть включён.
• Неверный StartPlace. true — только в обработчике /start. false — после того, как бот выдал результат. Одно и то же значение во всех вызовах — ошибка.
• Запросы без действия пользователя. Рекламу запрашивают в ответ на реальное действие человека, а не по таймеру и не рассылкой. Подделка параметров запрещена правилами.
• Реклама ломает бота. Ставьте таймаут на запрос и ловите ошибки, как в готовом коде: если сеть не ответила, бот должен работать дальше.

Частые вопросы

Читайте также

• Telegram Bot API бесплатно? Лимиты и что платно
• Рекламные сети для монетизации телеграм-ботаСравнение
• Безопасно ли давать токен бота рекламной сети
• Сколько зарабатывает Telegram-бот на рекламеРасчёт по аудитории