документация · шаг 03

Подключение Сейлбот

Чтобы Трафик Трекерс начал считать подписчиков, в воронку Сейлбот нужно добавить два блока: один сохраняет токен на входе, второй один раз отправляет запрос на сервер сервиса. Остальная воронка не меняется и продолжает работать как раньше.

Если воронка в Сейлбот уже собрана и работает - менять её структуру не нужно. Задача сводится к тому, чтобы добавить два новых блока: один ловит вход из рекламы и сохраняет токен, второй один раз сообщает серверу Трафик Трекерс, что человек подписался.

Токен передаётся в Сейлбот особым способом - не через стандартные метки UTM (пометки в ссылке, по которым видно источник перехода). Сейлбот сам умеет сохранять только utm_-параметры, а токен tt под них не подпадает. Поэтому его нужно явно сохранить в калькуляторе блока - иначе он потеряется ещё до того, как дойдёт до блока засчёта.

Шаг 1 - блок входа

Блок, который ловит вход из рекламы

У этого блока есть Условие, Переменная и Калькулятор.

  • Условие по ключам должно содержать tt- - так блок ловит вход с параметром ?tt=tt-….
  • В калькуляторе обязательно должна быть строка:

tt = '#{tt}'

Эта строка сохраняет токен в переменную. Без неё Сейлбот токен теряет: он по умолчанию держит только utm_-параметры, а tt - нет.

Если в калькуляторе есть обёртка proxy(...) вокруг ссылки - её нужно убрать. Она добавляет лишний редирект и ломает передачу токена.

Шаг 2 - блок засчёта подписки

Ключевой блок: сообщает серверу о новой подписке

Тип запроса: GET.

URL вида:

https://api.traffic-trackers.ru/v1/track/k/<TRACK_KEY>/start?start=#{tt}

TRACK_KEY выдаёт сервис в кабинете бота.

Важно: в конце URL должно быть именно #{tt}, а не #{start}. Переменная #{start} из обычной телеграм-ссылки всегда пустая и токен не передаст.

Калькулятор этого блока:

tt = '#{tt}'

Переход к следующему блоку - по времени, примерно 2-3 секунды. Опцию «Отменить, если покинул блок» нужно выключить.

Хост запроса - api.traffic-trackers.ru. Это отдельный технический адрес сервиса, не путать с адресом лендинга traffic-trackers.ru. Разные адреса для разных задач - это нормально.

Передача ника подписчика (необязательно, но полезно для отчётов)

Чтобы ники подписчиков появлялись в утренних отчётах бота, добавьте в запрос засчёта параметр username=#{username} - это переменная самого Сейлбот с юзернеймом подписавшегося человека.

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

Какие площадки поддерживает инструкция

Инструкция подходит для воронок Сейлбот в телеграм и МАКС - шаги блоков одинаковые для обеих площадок.

Итог

Если всё настроено верно - первые старты бота с токеном видно в утреннем отчёте, а первые цели - в Яндекс.Метрике примерно через 25 часов после подключения счётчика.