Постбэк S2S: как настроить передачу конверсий из партнёрки в трекер

Что такое постбэк S2S, как click ID проходит от клика до конверсии, какой постбэк выбрать и как настроить его в трекере. Плюс частые ошибки, из-за которых конверсии теряются.

Схема постбэка: от клика до конверсии в трекере

Регистрация, заказ или депозит случаются на стороне партнёрки — на её сайте, в её кабинете. Трекер этого не видит. Чтобы он узнал о конверсии и привязал её к клику, партнёрка должна сама сообщить о ней. Этот запрос «сервер — серверу» и называется постбэком, или S2S-постбэком.

Как работает постбэк#

Вся схема держится на одном значении — ID клика:

  1. Человек кликает по объявлению. Трекер записывает клик и присваивает ему ID.
  2. Трекер отправляет человека на оффер и добавляет ID клика в ссылку партнёрки, обычно в параметр вида subid.
  3. Партнёрка сохраняет этот ID вместе с пользователем.
  4. Когда случается конверсия, партнёрка вызывает ссылку постбэка и подставляет в неё ID клика, статус и выплату.
  5. Трекер находит клик по ID и записывает конверсию: она появляется в статистике и уходит в пиксели рекламных сетей.

Если ID клика потерялся на любом шаге, конверсия придёт, но привязать её будет не к чему.

Путь ID клика: от объявления через оффер и партнёрку обратно в трекер
Путь ID клика: от объявления через оффер и партнёрку обратно в трекер

Какой постбэк выбрать#

В Lidvanto два входящих постбэка. Они решают разные задачи.

Постбэк партнёркиПостбэк кампании
Для чегозаказы и их статусы по всем офферам сетисобытия одной кампании
Что приходитстатус заказа и выплата: лид, подтверждение, отказсобытие: регистрация, депозит, лид, подписка и другие
Как защищёнсекретный токен уже в ссылкесекрет в заголовке или в теле POST-запроса
Подходит, если сеть шлёт только GETданет
Где взятькарточка партнёрки → Ссылка постбекакампания → вкладка Постбеки

Короче говоря:

  • CPA-сеть со статусами заказов — например, нутра: лид → подтверждение → выкуп. Берите постбэк партнёрки.
  • Продукт с регистрациями и депозитами, свой или партнёрский, который умеет отправлять POST, — постбэк кампании.

Шаг 1. Передайте ID клика в ссылке оффера#

Без этого шага постбэк не заработает. В Целевом URL оффера поставьте макрос {click_id} в параметр, который партнёрка вернёт в постбэке:

https://partner.example/?aff=123&subid={click_id}

Как называется параметр, смотрите в кабинете партнёрки: subid, sub1, clickid, aff_sub — у каждой сети по-своему. В карточке партнёрки Lidvanto блок Ссылка оффера подсказывает, какие параметры добавить.

Шаг 2, вариант 1: постбэк партнёрки#

  1. Трекер → Партнёрки → Добавить партнёрку. Выберите сеть из каталога — макросы и статусы заполнятся сами. Сети нет в каталоге — Своя партнёрка.
  2. После сохранения скопируйте Ссылку постбека и вставьте её в кабинете партнёрки как глобальный постбэк.
  3. Сверьте Макросы: каким макросом партнёрка подставляет click ID, номер заказа, статус и выплату.
  4. Если сеть называет статусы по-своему, впишите их в Как партнёрка называет статусы. Общие названия — lead, sale, approved, rejected, trash, hold — трекер понимает сам.

В ссылке есть секретный токен — не публикуйте её. Подробно — Постбэк партнёрки.

Шаг 2, вариант 2: постбэк кампании#

На странице кампании, вкладка Постбеки: Адрес постбека и секрет. Адрес выглядит так: https://ваш-домен/traffic/postback/{click_id}/. Секрет передаётся заголовком X-Traffic-Postback-Secret или полем secret в теле POST-запроса.

Регистрация:

POST https://ваш-домен/traffic/postback/{click_id}/
X-Traffic-Postback-Secret: ваш-секрет
kind=registration&external_id=user-555

Депозит на $50:

POST https://ваш-домен/traffic/postback/{click_id}/
X-Traffic-Postback-Secret: ваш-секрет
kind=deposit&amount=50&currency=USD&external_id=dep-999

kind — тип события, amount и currency — сумма, external_id — ID события у партнёрки. Подробно — Постбэки.

Вкладка «Постбеки» кампании: адрес постбэка, секрет и параметры события
Вкладка «Постбеки» кампании: адрес постбэка, секрет и параметры события

Шаг 3. Проверьте связку до запуска трафика#

  • Включите у партнёрки Тестовый режим: заказы отмечаются тестовыми и не уходят в сеть по API, а постбэки принимаются. Можно пройти весь путь самому — от клика до конверсии.
  • Откройте Статистика → Логи: там каждый постбэк и ответ трекера на него. Если конверсия не записалась, причина будет там.

Почему конверсии теряются#

  • ID клика не передан в ссылке оффера. Партнёрке нечего вернуть.
  • Вместо ID пришёл {click_id} буквально. Партнёрка не подставила свой макрос — проверьте ссылку постбэка в её кабинете.
  • Перепутаны макросы. Партнёрка возвращает ID в sub2, а постбэк ждёт sub1.
  • Статус назван иначе. Сеть шлёт confirmed, а трекер ждёт approved. Впишите её названия в настройки партнёрки.
  • Нет external_id. Если партнёрка повторит постбэк, депозит задвоится. С external_id повтор не засчитывается.
  • Секрет не доходит. Сеть отправляет GET без заголовков — для постбэка кампании секрет так не передать. Используйте постбэк партнёрки.

Что даёт постбэк дальше#

Конверсия из постбэка — не только строка в статистике:

  • выплата и сумма депозита попадают в доход: трекер считает прибыль и ROI по кампаниям, гео и объявлениям — об этом в гайде как считать ROI связки;
  • конверсия уходит в пиксели Meta и TikTok по правилам кампании — см. гайды про Conversions API Meta и TikTok Events API;
  • регистрация из постбэка появляется у лида в CRM.

Частые вопросы#

Чем постбэк отличается от пикселя?
Пиксель работает в браузере на вашем сайте. Постбэк отправляет сервер партнёрки, поэтому он сообщает о конверсиях, которые случились у неё: регистрациях, заказах, депозитах.

Партнёрка отправляет постбэк, а конверсии в статистике нет. Что делать?
Откройте Статистика → Логи и найдите запрос. Чаще всего в нём нет настоящего ID клика или не совпал секрет.

Можно ли подключить несколько партнёрок?
Да. У каждой своя ссылка постбэка, а ID клика уникален, поэтому конверсии не перепутаются.

Повторный постбэк задвоит конверсию?
Нет, если партнёрка передаёт external_id или номер заказа: повтор с тем же ID трекер не засчитывает.