Разделы документации

Постбэки

Постбэк — запрос «сервер — серверу», которым одна система сообщает другой о конверсии. В Lidvanto они бывают двух видов:

  • входящий — партнёрка сообщает трекеру о регистрации, лиде или депозите;
  • исходящий — трекер сам сообщает партнёру или другому трекеру о событии клика.

Оба настраиваются на странице кампании, вкладка Постбеки.

Входящий постбэк#

  1. В ссылке оффера передайте партнёрке ID клика макросом {click_id}.
  2. Во вкладке Постбеки скопируйте Адрес постбека и секрет — общий или секрет кампании.
  3. В кабинете партнёрки вставьте адрес, подставив в него ID клика, который она получила.

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

Если партнёрка умеет отправлять только GET-ссылку без своих заголовков, используйте постбэк партнёрки: секретный токен в нём уже вшит в ссылку.

Что передаёт партнёрка:

ПараметрЗначение
kindсобытие: registration, deposit, lead, subscribe, unsubscribe, dialog или custom
amountсумма — для депозита
currencyвалюта суммы, по умолчанию USD
external_idID события у партнёрки — защита от дублей

Пример регистрации:

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

Пример депозита на $50:

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

Конверсия записывается к клику, появляется в статистике и уходит в пиксели по правилам вкладки Конверсии — см. Пиксели Meta и TikTok.

Исходящие постбэки#

Нажмите Добавить правило в блоке Исходящие постбеки:

  • Название и Событие — на какое событие клика отправлять;
  • Метод — GET или POST;
  • URL — адрес получателя с макросами клика;
  • Не слать пустые параметры — параметр без значения не попадёт в адрес: некоторые трекеры путают пустое значение с нулём.

Правило можно выключить переключателем, не удаляя. Результаты отправки видны в логах.

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

Партнёрка шлёт постбэк, а конверсии нет.
Проверьте, что в адресе подставлен настоящий ID клика, а не {click_id} буквально, и что секрет совпадает. Ответ трекера и причину отказа видно в Статистика → Логи.

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