Гайд - Постбэки

Постбэки: каждая конверсия — в ваш трекер

Если вы льёте трафик через Keitaro или RedTrack, или работаете по офферам партнёрской сети, клик выпадает из поля зрения трекера в тот момент, когда попадает в Telegram. Регистрации и депозиты происходят там, куда трекер не дотягивается, а без данных о конверсиях незаметно умирают отчёты по расходам, авто-правила и сверка выплат. Постбэки замыкают эту цепочку: на каждую конверсию, которую фиксирует Leadgram, платформа стучится в S2S-URL вашего трекера - и денежная сторона воронки остаётся видна там, где вы реально оптимизируете.

Как работают постбэки

Правило постбэка - это три вещи: событие-триггер, шаблон URL и HTTP-метод. Как только по одному из ваших кликов фиксируется конверсия - через server-to-server вызов events API от рекламодателя или через узел «Триггер события» внутри флоу сообщений, - срабатывают все включённые правила с этим типом события. Одно событие, одно правило, один HTTP-запрос.

Постбэки срабатывают только на события, прошедшие биллинг. Прежде чем правило вообще увидит конверсию, биллинг уже решает - списать деньги или пропустить бесплатно: платно проходит только первое биллинг-событие подписчика, все последующие события от него бесплатны. Если в момент этого первого списания организация на паузе или у неё кончился баланс, событие блокируется, и постбэк по нему не уходит; события от подписчиков, за которых вы уже платили, остаются бесплатными и продолжают срабатывать. Отдельного индикатора на самом правиле для этого нет, так что если правило вдруг замолчало, хотя должно стрелять, - сначала проверьте баланс организации, а потом уже разбирайтесь с URL.

Создание правила

  1. Откройте «Постбэки» и нажмите «Добавить постбэк».
  2. Выберите пресет: Keitaro и RedTrack подставят шаблон URL, «Свой» оставит поле пустым.
  3. Назовите правило - чтобы потом узнать его в таблице.
  4. Выберите событие-триггер: «Лид», «Регистрация», «Депозит», FTD, «Покупка», «Старт бота» или «Вступление в канал».
  5. Вставьте URL эндпоинта с макросами (список ниже).
  6. Выберите GET или POST. При POST макросы в URL по-прежнему работают, а те же поля дополнительно уходят JSON-телом.
  7. Нажмите «Добавить постбэк», чтобы сохранить - правило включается сразу же и появляется в таблице вместе с событием, методом, временем последнего срабатывания и статусом.
Форма правила постбэка с событием-триггером и шаблоном URLФорма правила постбэка с событием-триггером и шаблоном URL

Макросы URL

Эти плейсхолдеры подставляются при каждом срабатывании:

  • {click_id} - id клика в Leadgram; ключ, по которому трекер матчит сессию
  • {event_type} - название события (deposit, ftd и так далее)
  • {sub1}-{sub5} - суб-цепочка, пойманная на клике
  • {platform} - рекламная площадка кампании (meta, google, tiktok)
  • {fbclid}, {gclid}, {gbraid}, {wbraid}, {ttclid} - нативные click id рекламных площадок

Пустые значения превращаются в пустую строку, так что &fbclid={fbclid} не сломает постбэк на Google-трафике. Всё, чего нет в этом списке, остаётся в URL как обычный текст. Рабочий пример для Keitaro: https://your-keitaro.com/postback?subid={click_id}&status={event_type}.

Доставка, ретраи и повторная отправка

На каждое срабатывание даётся 10 секунд; доставленным считается любой HTTP-статус от 200 до 399. Неудачное срабатывание повторяется ещё до 2 раз с нарастающей паузой (всего 3 попытки), и каждое срабатывание зеркалится в надёжный журнал на странице «Доставка конверсий»:

  • «В очереди» - поставлено, ещё не доставлено
  • «Отправлено» - эндпоинт ответил 200-399
  • «Сбой» - последняя попытка завершилась ошибкой, повторы ещё возможны
  • «Мёртвая» - все попытки исчерпаны; оживить может только ручная повторная отправка

«Доставка конверсий» открывается сводкой ещё до всех таблиц: по карточке на каждое правило и на каждое подключение к рекламной площадке, с бейджем статуса («Без проблем», «Есть сбои» или «Есть мёртвые») и счётчиками отправленных, сбойных, мёртвых и ожидающих доставок за последние 24 часа и за последние 7 дней. Это самый быстрый способ заметить, что правило сбоит, не читая таблицу построчно.

Ниже - таблица «Проблемные доставки» (вкладки CAPI | Постбэки): в ней перечислена каждая сбойная или мёртвая доставка с точным текстом ошибки, по 20 строк на страницу. Временным окном она не ограничена - это свойство только сводки выше; доставка, упавшая месяцы назад, будет висеть здесь, пока вы её не переотправите или она не пройдёт сама. «Переотправить» ставит доставку в очередь заново с тем же payload. Сначала почините эндпоинт, потом переотправляйте - ничего не теряется.

Гарантия дедупликации: одна и та же логическая конверсия никогда не уйдёт на ваш эндпоинт дважды. Дедупликация держится через ретраи очереди, краши и повторную обработку событий. Настоящая повторная конверсия (второй депозит, пришедший новым событием) сработает отдельно - как и должна.

Частые грабли

  • Правило показывает статус «Отключён» и не стреляет. Новые правила всегда создаются включёнными, а дашборд сегодня умеет только создавать правила - редактировать, отключать или удалять их после сохранения нельзя, так что отключённое правило кто-то переключил другим путём. Текущее состояние смотрите через фильтры «Все / Активные / Отключённые».
  • Имена макросов точные: {clickid} (без подчёркивания) не подставится и уйдёт в трекер как есть.
  • Только публичные http(s)-адреса: localhost и адреса приватных сетей отклоняются по соображениям безопасности. Эта проверка срабатывает при редактировании URL и при срабатывании правила, но не при первом создании - так что неверный URL может сохраниться и споткнуться только на реальном срабатывании.
  • Если ваш эндпоинт отвечает 4xx/5xx, срабатывание становится «Сбоем», а затем «Мёртвой». Проблема на принимающей стороне: почините её, потом переотправьте со страницы «Доставка конверсий».
  • Лимит - 50 правил постбэков на организацию.