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

Как подключить SaleBot и передавать старт бота, глубокие цели в Яндекс/ФБ/Гугл/ВК

Как подключить SaleBot

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

  • Передача активаций бота в рекламные системы Яндекс/ФБ/Гугл/ВК, оптимизация на старты бота

  • Глубокие цели: передача в рекламные системы Яндекс/ФБ/Гугл/ВК глубоких целей воронки. Например, просмотр урока №2, регистрация на вебинар, покупка.

  • Трекинг отписок (блокировок) бота

  • Аналитическая отчетность по аудитории: источники трафика, срок жизни в боте, полный список подписчиков, utm метки откуда пришли

  • Аналитическая отчетность по подпискам: переходы в бота, конверсии в подписку

  • Ежедневные отчеты бота

    “подписки 24ч”

    “отписки 24 ч”

  • Досье подписчика

Пример настроенной воронки на рисунке.

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

Шаг 1 — Настройка отправки webhook для SaleBot​

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

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

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

подсказка

API_КЛЮЧ в url нужно заменить на API ключ вашего бота, полученный от "Откуда Подписки".

Шаг 2 — Значения поля данных в POST JSON запросе​

#{tg_request}

Шаг 3 — Проверка подключения​

Для проверки работоспособности интеграции используйте нашу страницу проверки: https://bot-api.tgtrack.ru/last_events/

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

Подробная видео инструкция для настройки интеграции с SaleBot:​

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

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

https://t.me/ВАШБОТ?start=ВАШЕЗНАЧЕНИЕ

Обратите внимание, что для точного отслеживания подписчиков, "Откуда Подписки" добавит к вашему параметру уникальный идентификатор перехода в бота, поэтому при обработке параметра start в вашем боте используйте поиск подстроки.

Как настроить передачу данных глубокой цели через API в SaleBot​

Если вы используете бота на платформе SaleBot и хотите передавать данные о глубокой цели (например, выполнение теста) и обучать рекламную кампанию на достижение этой цели, выполните следующие шаги:

1. Создайте действие в воронке с передачей данных​

В конструкторе воронки на SaleBot выберите нужный шаг, где требуется передать данные.

Добавьте действие “API-запрос” и укажите URL для передачи данных.

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


https://bot-api.tgtrack.ru/v1/`<mark>`API_КЛЮЧ`</mark>`/send_reach_goal


подсказка

API_КЛЮЧ в url нужно заменить на API ключ вашего бота, полученный от "Откуда Подписки".

2. Настройте API запроса​

подсказка

Для передачи данных по глубокой цели из вашего бота в рекламную систему после настройки интеграции, нужно сделать подключение к рекламной системе по инструкции. Ссылки на инструкции в конце этой страницы.

В поле JSON для передачи данных укажите следующий код:

{
  "user_id":"#{platform_id}",
  "target": "subscribe"
}

user_id: Переменная #{platform_id} автоматически подставит ID пользователя из платформы (например, Telegram или VK). target: Это название глубокой цели. В данном примере “testResult” – завершение теста пользователем.