Перейти к основному содержимому

Как подключить BotHunter/TargetHunter

BotHunter/TargetHunter поддерживает ограниченную интеграцию с Откуда Подписки, доступен функционал:

  • Передача активаций бота в рекламные системы Яндекс/ФБ/Гугл/ВК, оптимизация на старты бота
  • Аналитическая отчётность по аудитории: источники трафика, срок жизни в боте, полный список подписчиков, utm метки откуда пришли
  • Аналитическая отчетность по подпискам: переходы в бота, конверсии в подписку
  • Глубокие цели
  • Ежедневные отчеты бота “подписки 24ч”
  • Досье подписчика: только подписки

Следуйте по шагам подключения:​

1. Настройка отправки API запроса для BotHunter​

  • Для интеграции необходимо получить API ключ. Как получить API ключ тут.
  • Откройте настройки проекта на платформе BotHunter.
  • В самом боте перед началом воронки создайте блок внешнего запроса
  • Выберите метод отправки POST JSON

Пример URL, на который надо послать запрос:

https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/user_did_start_bot

Заполните параметры полей как на примере настроенной воронки на рисунке

Скопируйте значение каждого поля и вставьте в настройки запроса в BotHunter:

Поле-JSON: user_id
Значение:

{user_id}

Поле-JSON: start_value
Значение:

"{tg_start}"

Поле-JSON: full_name
Значение:

"{first_last_name}"

Поле-JSON: first_name
Значение:

"{first_name}"

2. Проверка подключения​

подсказка

Для проверки работоспособности интеграции используйте нашу 🔗 страницу проверки.

Укажите ваш API ключ (который получили на шаге 1) и проверьте последние 100 запросов.

Проверим, что BotHunter действительно передаёт старт, стоп, а сервис Откуда Подписки принимает его без ошибок. Статус обработки событий должен быть – 0.

3. Особенности:​

Если ваша воронка не запускается, то допишите на ленде к ссылке бота параметр ?nochange.

  1. с параметром старт:
https://t.me/ВАШБОТ/?start=СТАРТСЛОВО&nochange=1

  1. без параметра старт:
https://t.me/ВАШ_БОТ/?nochange=1

Если у вас несколько воронок, которые запускаются по разным значениям параметра start бота, то в ссылке на вашего бота укажите нужный параметр: СтартСлово – слово по которому стартует та или иная воронка.

nochange – запрещает нашему сервису изменять значение параметра старт.