Налаштування S2S постбека: гайд на 5 хвилин для афіліатів

Що таке S2S постбек

Server-to-server постбек — це звичайний HTTP-запит, який партнерська мережа надсилає до вашого трекера в момент конверсії. JavaScript у браузері відвідувача не виконується, тому блокувальники реклами, правила cookies і швидкість завантаження сторінки на нього не впливають. Саме тому це стандартний спосіб обліку конверсій в афіліат-маркетингу.

Як подорожує 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), і трекер автоматично додасть його до кожного URL офера, або вставте макрос у URL офера вручну:

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 офера з тестового кліку та знайдіть його.
• Неправильні суми: передавайте виплату як просте число, без знака валюти; використовуйте currency для виплат не в USD.
• Помилки 401: токен відсутній або невірний, тоді як увімкнено Require token.