Настройка S2S-постбэка: гайд для байеров за 5 минут

Что такое S2S постбэк

Серверный постбэк (S2S) — обычный HTTP-запрос, который партнёрская сеть отправляет в ваш трекер при конверсии. JavaScript в браузере посетителя не задействован, поэтому блокировщики рекламы, настройки cookie и скорость страницы на него не влияют. Поэтому это стандартный способ учёта конверсий в арбитраже трафика.

Как передаётся click ID

1. Посетитель кликает по рекламе и переходит по трекинговой ссылке. Трекер фиксирует клик и присваивает ему уникальный click ID.
2. Трекер редиректит посетителя на оффер и передаёт click ID дальше, например как ?sub_id=….
3. Сеть сохраняет это значение вместе с посетителем. Когда происходит конверсия, сеть обращается к вашему постбэк URL с тем же значением.
4. Трекер сопоставляет click ID с исходным кликом и добавляет конверсию и выплату к кампании, потоку, лендингу и офферу, которые её принесли.

Настройка в XPNSR Tracker

1. Передайте click ID в оффер

Укажите в кампании Click ID forward parameter (например, clickid), и трекер добавит его к каждой ссылке на оффер, либо вставьте макрос в ссылку оффера сами:

https://offer.example/landing?sub_id={click_id}&country={country_code}

Используйте имя параметра, которое ожидает партнёрка: sub_id, aff_sub, s2 и так далее. 331 пресет партнёрских сетей в трекере уже знает их.

2. Передайте партнёрке ваш постбэк-URL

https://your-tracking-domain/api/postback?click_id={clickid}&revenue={payout}&status=lead

Замените значения в фигурных скобках на макросы вашей партнёрки. В кабинете партнёрской сети это поле обычно называется Postback, S2S или Server callback.

Защита постбэка

Любой, кто узнает URL, может отправить фейковые конверсии. У каждой кампании есть секретный ключ постбэка: добавьте &token=YOUR_SECRET к URL (или передайте его в заголовке X-Postback-Token) и включите Require token. Также можно ограничить приём постбэков только с IP-адресов партнёрской сети. Повторные постбэки по одной и той же конверсии игнорируются.

Тестирование и устранение неполадок

1. Откройте трекинговую ссылку сами и завершите тестовую конверсию, либо используйте тестовый постбэк партнёрки.
2. Откройте Clicks Log в трекере и найдите свой клик: конверсия появится на нём в течение нескольких секунд.

• Ничего не приходит: проверьте URL в партнёрке на опечатки и убедитесь, что названия макросов точно совпадают с документацией партнёрки.
• Приходит, но не совпадает: click ID не передался в оффер. Откройте URL оффера из тестового клика и найдите его там.
• Неверные суммы: передавайте выплату простым числом, без знака валюты; для выплат не в USD используйте currency.
• Ошибки 401: токен отсутствует или неверный при включённой опции Require token.