Постбэки
Постбэк — запрос «сервер — серверу», которым одна система сообщает другой о конверсии. В Lidvanto они бывают двух видов:
- входящий — партнёрка сообщает трекеру о регистрации, лиде или депозите;
- исходящий — трекер сам сообщает партнёру или другому трекеру о событии клика.
Оба настраиваются на странице кампании, вкладка Постбеки.
Входящий постбэк#
- В ссылке оффера передайте партнёрке ID клика макросом
{click_id}. - Во вкладке Постбеки скопируйте Адрес постбека и секрет — общий или секрет кампании.
- В кабинете партнёрки вставьте адрес, подставив в него 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_id | ID события у партнёрки — защита от дублей |
Пример регистрации:
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¤cy=USD&external_id=partner-dep-999
Конверсия записывается к клику, появляется в статистике и уходит в пиксели по правилам вкладки Конверсии — см. Пиксели Meta и TikTok.
Исходящие постбэки#
Нажмите Добавить правило в блоке Исходящие постбеки:
- Название и Событие — на какое событие клика отправлять;
- Метод — GET или POST;
- URL — адрес получателя с макросами клика;
- Не слать пустые параметры — параметр без значения не попадёт в адрес: некоторые трекеры путают пустое значение с нулём.
Правило можно выключить переключателем, не удаляя. Результаты отправки видны в логах.
Частые вопросы#
Партнёрка шлёт постбэк, а конверсии нет.
Проверьте, что в адресе подставлен настоящий ID клика, а не {click_id} буквально, и что секрет совпадает. Ответ трекера и причину отказа видно в Статистика → Логи.
Повторный постбэк задвоит депозит?
Нет, если партнёрка передаёт external_id: событие с тем же ID повторно не засчитывается.