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

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

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

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

1. Настройка webhook для PuzzleBot

Получите API-ключ. Как получить API ключ см здесь шаг 1.
Откройте воронку в боте на платформе PuzzlBot.
В разделе Настройки → Интеграция напишите в url:

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

API ключ нужно поменять на ваш, полученный от Откуда Подписки.

подсказка

Готово! Теперь при каждом старте вашего бота, будет посылаться запрос на сервис tgTrack (Откуда подписки бот).

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

подсказка

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

Введите ваш API-ключ (полученный на шаге 1) и проверьте последние 100 запросов.
Убедитесь, что бот PuzzleBot успешно передаёт события старта и блокировки, а сервис "Откуда Подписки" принимает их без ошибок. Статус обработки событий должен быть 0.

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

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

https://t.me/ВАШБОТ?start=ключевое_слово

При переходе бот добавит к ссылке данные для трекинга и старт превратится в уникальный ключ, который начинается с tgTrack_ключевое_слово

Например, если ключевок слово было keyword, то бот сделает так: TGTrack_keyword-PJ1234567, где то, что после PJ каждый раз новое.

В своём боте надо настроить запуск воронки по условию "старт содержит ключевое слово" или "старт начинается с tgTrack_ключевое_слово".

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

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

Создайте блок с внешним запросом

В самой воронке бота создайте блок с внешним запросом на том шаге, на котором нужно передать данные по глубокой цели.

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

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

подсказка

Укажите ваш API ключ, который получили от Откуда Подписки бота на 📘 шаге 1.

Метод send_reach_goal пересылает достижение цели в рекламную систему, откуда пришел пользователь.

Например, в вашей воронке есть шаг получения номера телефона у пользователя. И вы хотите передавать в рекламную систему Яндекс/ФБ/ВК/Гугл тех, кто оставил номер телефона, чтобы реклама обучалась на эти события.

В этом случае метод send_reach_goal пробросит достижение цели в ту рекламную платформу, откуда пришел пользователь.

подсказка

Цель можно передавать с момента клика пользователем по рекламному объявлению в течение 21 дня

В тело запроса напишите:

{

"user_id": {{USER_ID_TEXT}},
"target":"testResult"

}

user_id: Переменная автоматически подставит ID пользователя из PuzzleBot.

target: Это название глубокой цели. В данном примере “testResult” – завершение теста пользователем.

Название	Тип	Описание
`user_id`	string	ID пользователя в Телеграм, с которым связано событие.
`target`	string	Идентификатор события в рекламной системе (Яндекс/Фейсбук/ВК/Google).