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

Telegram

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

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

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

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

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

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

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

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

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

подсказка

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

:::

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

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

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

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

1. с параметром старт:

https://t.me/ВАШБОТ/?start=СТАРТСЛОВО&nochange=1

2. без параметра старт:

https://t.me/ВАШ_БОТ/?nochange=1

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

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

Max

Как подключить BotHunter к "Откуда Подписки" в Max

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

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

Для того чтобы передавать старты бота или глубокие цели в рекламные системы (Яндекс, VK), необходимо выполнить несколько шагов:

1. Подключить своего чат-бота к "Откуда Подписки". Это позволит фиксировать каждый старт бота.
2. Настроить передачу глубоких целей. Если нужно передавать глубокие цели.
3. Подключить лендинг, с которого вы ведете трафик в чат-бота. Для этого нужно получить от "Откуда подписки" бота скрипт и установить его на ваш лендинг.

Подробные инструкции по подключению рекламных систем Яндекс.Директ и VK получите в боте:

Выберите в боте команду: /new_integration (Интеграция с Яндекс/ВК), далее по кнопке Я.Директ или VK.

Бот пришлёт инструкцию, выполните все шаги.

Как подключить чат-бота к Откуда Подписки.

1. Для интеграции необходимо получить API ключ. В личном кабинете Max для бизнеса (https://business.max.ru/) запросить токен и скопировать его.

2. Прислать этот API ключ в бота, когда он попросит.

Всё готово! Для передачи стартов в рекламную систему осталось только сделать интеграцию и установить скрипт на ленд.

Как проверить работает ли интеграция.

Для проверки передачи стартов в наш сервис используйте страницу проверки https://max.tgtrack.ru/API/last_events/

Введите API ключ, который получили от Откуда Подписки на шаге 2.