Как работает передача событий
Эта статья — ментальная модель того, как Tracker связывает события партнёрки с конкретными лидами.
Эта статья — ментальная модель того, как Tracker связывает события партнёрки с конкретными лидами. После прочтения вы понимаете, почему постбек должен содержать
clickid, что произойдёт, если макрос не подставлен, и как Tracker отличает «лид от вашей рекламы» от «случайной регистрации».Если у вас события не приходят, или приходят без привязки — эту статью обязательно читать перед Настройка готовой интеграции / Custom Postback — кастомная интеграция.
Для кого статья
Если впервые подключаете партнёрку — обязательно к прочтению. Если события партнёрки идут хаотично, без привязки или с пропусками — здесь объяснение причин. Если льёте трафик в стандартной связке и всё работает — можно пропустить.
Большая картина
- — Рождается в момент первого клика по рекламной ссылке.
- — Передаётся дальше: сохраняется в cookie, попадает в регистрационную ссылку партнёрки через макрос {{tracker.clickid}}.
- — Возвращается от партнёрки в постбеке (вместе с информацией о событии — registration, sale, resale).
- — Используется для поиска лида: Tracker по clickid находит запись в своей базе и связывает событие с этим лидом.
Без
clickid Tracker не может связать событие с лидом — оно записывается как «органика», не учитывается в аналитике конкретной кампании / buyer-а.Этапы передачи событий
1. Пользователь приходит из рекламы
Клиент видит вашу рекламу в Facebook / Google / Telegram. Кликает по ссылке. Открывается лендинг.
В этот момент Tracker:
- — Создаёт уникальный clickid — это случайная строка вида 67wgwWkaR0. Уникальная навсегда.
- — Сохраняет clickid в cookie браузера и в своей базе вместе с параметрами ссылки (sub1, ad_name, buyer и так далее, см. ).
- — Связывает clickid с конкретной кампанией.
2. Лид попадает в Telegram и пишет боту
Пользователь нажимает кнопку «Открыть Telegram» на лендинге. Попадает в канал / бот, проходит этап Subscribe. Когда первый раз пишет в боте — событие
Contact фиксируется. С этого момента Tracker «знает», что лид вышел из «трафика» и стал «лидом CRM».Связь между clickid и Telegram-лидом устанавливается через DM-бот: при открытии deep-link бота передаётся
start_param, который содержит clickid (или передаётся через метаданные). Это техническая магия, в которую обычному оператору не нужно вникать — главное знать что Tracker это умеет.3. Лид получает регистрационную ссылку
Бот / оператор отправляет лиду регистрационную ссылку партнёрской программы. В этой ссылке должен быть макрос
{{tracker.clickid}}:Что прописано в Flowplaintext
https://partner.com/signup?sub1={{tracker.clickid}}Когда сообщение реально отправляется — Tracker подставляет конкретный clickid этого лида:
Что отправлено лидуplaintext
https://partner.com/signup?sub1=67wgwWkaR0Когда лид жмёт по ссылке и регистрируется в партнёрке, партнёрка сохраняет
sub1=67wgwWkaR0 в своей базе.4. Партнёрка отправляет постбек
Когда лид совершает целевое действие (регистрация, депозит, повторный депозит) у партнёрки, она отправляет HTTP-запрос (postback) на ваш Postback URL в Tracker:
Постбек на регистрациюplaintext
https://api.chatterfy.ai/api/postbacks/.../tracker-postback?clickid=67wgwWkaR0&tracker.event=registrationПартнёрка передаёт:
- — clickid — то значение, которое было в регистрационной ссылке.
- — tracker.event — тип события: registration, sale, resale, withdraw.
- — Доп. параметры: сумма tracker.cost, валюта tracker.currency, ID транзакции tracker.tid, кастомные fields.*.
5. Tracker связывает событие с лидом
Tracker:
- — Извлекает clickid из запроса.
- — Ищет в своей базе лида с таким clickid (он там с этапа 1).
- — Связывает событие с этим лидом и кампанией.
- — Записывает в, и в карточку лида в CRM (раздел Events).
- — Если настроено — применяет автодействие (переключает Flow / меняет Status).
Что может сломаться
Регистрационная ссылка без макроса
Самая частая ошибка. Оператор скопировал ссылку партнёрки и забыл вставить
{{tracker.clickid}}. В таком виде партнёрка получает регистрацию без clickid, отправляет постбек без clickid, Tracker не может найти лида.Симптом: в Logs — журнал событий постбеки приходят, но колонка Click ID пустая, событие со статусом Error «User not found».
Решение: проверить регистрационную ссылку в шаге Flow ( Статья). Должен быть макрос. Поправить, переотправить ссылку существующим лидам если возможно, либо ждать новых лидов.
Партнёрка не сохраняет sub1 / clickid
Некоторые партнёрки используют свой параметр имени (например,
pbclick вместо sub1). Если в Tracker указан Click ID Parameter = sub1, а партнёрка ждёт pbclick — clickid не передастся в постбек.Решение: в Custom Postback — кастомная интеграция / Настройка готовой интеграции указать правильное имя параметра под партнёрку. И в регистрационной ссылке использовать соответствующее имя —
pbclick={{tracker.clickid}}.Лид зарегистрировался без захода в бот
Лид кликнул по рекламе, попал на лендинг, перешёл в канал, но до бота не дошёл (не нажал Start). На этом этапе Tracker имеет clickid, но не имеет привязки к Telegram-юзеру (нет события Contact). Если лид пошёл по ссылке партнёрки в этом момент — clickid есть в URL, регистрация пройдёт, но событие будет «висеть» без привязки к лиду CRM.
Решение: убедитесь, что DM-бот настроен в General — маршрут пользователя и быстро ловит лидов в личку. Регистрационную ссылку отправляет уже DM-бот (после Contact), а не ставится на лендинге.
Где видны события
После того как Tracker связал событие с лидом, оно отображается:
- — В — как столбцы Registration / FD / RD / Unique RD.
- — В — KPI и графики воронки.
- — В → Postback logs — детальный журнал входящих событий.
- — В карточке лида в CRM в разделе Events — оператор видит «лид зарегистрировался такого-то числа, сделал FD на $200».
- — Дополнительно — кастомные параметры fields.* создают Custom Fields в, оператор видит «trader_id = 12345».
Что дальше
Теперь, когда понимаете механику — можно настраивать конкретную интеграцию:
Эта статья была полезна?