Постбэки
Постбэк — это запрос, который партнёрка (CPA-сеть или рекламодатель) присылает вашему трекеру, когда клиент совершил действие: зарегистрировался, внёс депозит, сделал редеп или вывод. Постбэки — это то, благодаря чему вы видите деньги, а не только переходы.
Если базовые понятия ещё не знакомы — начните с раздела Трекер: обзор.
Зачем нужен clickid#
Постбэк должен «найти» нужного клиента среди тысяч. Делает он это по clickid — уникальному идентификатору клика, который трекер выдал клиенту при переходе по рекламе.
- Клиент кликает по рекламе → трекер выдаёт ему clickid и запоминает кампанию/источник.
- clickid передаётся дальше — на лендинг, в бота и в партнёрку.
- Клиент вносит депозит → партнёрка шлёт постбэк с тем же clickid.
- Трекер по clickid находит клиента и засчитывает ему депозит.
Без clickid постбэки не привязываются. Если партнёрка не вернёт clickid, событие останется бесхозным — деньги не засчитаются нужному клиенту.
События постбэков#
Трекер использует свой набор событий. Партнёрке нужно отдать те, что она поддерживает:
| Событие | Что означает | Что передавать |
|---|---|---|
registration | Регистрация клиента | clickid |
deposit (FTD) | Первый депозит | clickid, сумма, валюта |
resale (редеп) | Повторный депозит | clickid, сумма, валюта |
withdrawal | Вывод средств | clickid (и сумма/валюта, если есть) |
Трекер понимает разные написания названий (например, reg, sale, dep, fd, rd, redeposit, withdraw) и приводит их к своим событиям. При депозитах важно передавать сумму и валюту — иначе аналитика покажет факт депозита, но не деньги.
Как собрать postback-URL — через «Интеграции»#
Самый надёжный способ — не собирать URL вручную, а взять готовый в разделе трекера Integrations (Интеграции):
- Откройте Трекер → Integrations.
- Выберите свою партнёрку из каталога (там уже есть популярные брокеры с преднастроенными событиями) — или создайте свою (custom) интеграцию.
- Трекер покажет готовый postback-URL с вашим токеном аккаунта. Его и вставляете в кабинет партнёрки.
Условно URL выглядит так:
https://<домен-трекера>/postbacks/<токен-аккаунта>/tracker-postback?tracker.event=<событие>&clickid={макрос_партнёрки}&tracker.cost={сумма}&tracker.currency={валюта}
<токен-аккаунта>— секретный токен вашей компании (берётся из раздела Integrations, менять не нужно).tracker.event— какое событие (registration,deposit,resale,withdrawal).clickid— сюда партнёрка подставляет свой макрос с clickid.tracker.costиtracker.currency— сумма и валюта депозита (макросы партнёрки).
Постбэк принимается только с секретным токеном (аккаунта или кампании) — это защита от подделки событий. Берите готовый URL из раздела Integrations, а не сочиняйте его вручную.
Auto Actions — авто-перевод на этап#
После получения постбэка система может автоматически перевести клиента на нужный этап воронки. Например: пришёл постбэк о депозите → клиент переводится на этап «внёс депозит» → бот продолжает диалог уже по сценарию для тех, кто заплатил.
Чтобы это работало:
- у кампании должен быть назначен бот (см. Кампании);
- нужный этап воронки должен существовать у этого бота;
- постбэк должен прийти с корректным clickid.
Воркфлоу подключения партнёрки#
- Убедитесь, что у кампании назначен бот и созданы нужные этапы воронки.
- В разделе Integrations возьмите готовый postback-URL (выберите брокера или создайте custom).
- В кабинете партнёрки добавьте этот URL для каждого события (регистрация, депозит, редеп, вывод).
- Подставьте макросы партнёрки для clickid, суммы и валюты.
- Убедитесь, что clickid передаётся при переходе (через ссылку кампании/источника и лендинг).
- Проверьте по логам, что постбэки приходят.
Как проверить через логи#
После настройки обязательно проверьте, что постбэки доходят.
- Сделайте тестовое событие (или попросите менеджера партнёрки прислать тестовый постбэк).
- Откройте логи в трекере (раздел Logs).
- Проверьте, что событие появилось, у него есть clickid и оно привязалось к клиенту.
- Для депозитов убедитесь, что подтянулись сумма и валюта.
Если постбэк пришёл, но не привязался к клиенту — почти всегда виноват clickid: он не передался по цепочке или партнёрка прислала пустое значение.
Подробнее про логи — в разделе Аналитика.
Частые вопросы#
Постбэки приходят, но Auto Actions не срабатывают. Проверьте, что у кампании назначен бот и что целевой этап воронки существует у этого бота.
Партнёрка спрашивает «формат постбэка» — что ей дать? Готовый URL из раздела Integrations и список событий с параметрами из таблицы выше. URL не сочиняйте — берите из трекера.
Депозит засчитался без суммы. Партнёрка не передала сумму/валюту. Добавьте эти макросы в URL депозитных событий.