Как настроить постбэк рекламодателя (S2S-трекинг) в Rastro

Постбэк (трекинг сервер-сервер, S2S) — самый надёжный способ фиксировать конверсии. Когда происходит продажа или лид, сервер рекламодателя вызывает URL Rastro с идентификатором клика, который привёл клиента. В браузере нет ни cookies, ни скриптов, поэтому блокировщики рекламы и настройки приватности не мешают.

Как это работает

1. Посетитель кликает по трекинговой ссылке партнёра.
2. Rastro фиксирует клик и отправляет посетителя на URL назначения оффера, подставляя вместо {click_id} уникальный идентификатор.
3. Сайт рекламодателя сохраняет этот click_id (например, вместе с заказом или аккаунтом клиента).
4. Когда происходит конверсия, сервер рекламодателя вызывает URL постбэка с тем же click_id.
5. Rastro связывает конверсию с кликом, рассчитывает выплату партнёру и уведомляет его.

1. Передайте click_id рекламодателю

В URL назначения оффера добавьте макрос {click_id} туда, где его ожидает рекламодатель:

https://shop.example/landing?clickid={click_id}

Название параметра (clickid, aff_sub, transaction_id…) — то, которое читает система рекламодателя. Есть и другие макросы, например {affiliate_id} и {sub1}–{sub5}.

2. Дайте рекламодателю URL постбэка

У каждого рекламодателя свой URL с секретным токеном. Он находится на странице рекламодателя (или, если у него есть доступ к панели, на его странице Интеграция):

https://track.rastroaff.com/postback?token=ТОКЕН_РЕКЛАМОДАТЕЛЯ&click_id={clickid}&txn_id={order_id}&amount={order_total}&status=approved

Рекламодатель заменяет значения в фигурных скобках на плейсхолдеры своей системы. Адрес начинается с трекингового домена вашей сети; если вы используете свой домен (например track.yourcompany.com), — с него.

Параметры

Параметр	Обязателен	Назначение
token	да	Идентифицирует рекламодателя. Храните в секрете; при утечке сгенерируйте новый.
click_id	да*	Идентификатор, полученный в URL назначения.
txn_id	рекомендуется	ID заказа или лида у рекламодателя. Без него каждый клик может дать только одну конверсию.
amount	для CPS	Сумма продажи — для расчёта процентных выплат.
status	нет	approved, pending, rejected или reversed.
goal	нет	Цель кампании со своей выплатой (например goal=first_deposit).
coupon	нет	Засчитывает конверсию по коду купона вместо click_id (тогда txn_id обязателен).
country	нет	Страна клиента (код из 2 букв). Помогает выявлять фрод, если не совпадает со страной клика.

* Не нужен, если конверсия засчитывается по coupon.

Изменение статуса конверсии

Отправьте постбэк ещё раз с тем же click_id и txn_id и новым статусом. Так работают возвраты и чарджбэки: status=reversed списывает сумму с баланса партнёра и уведомляет его.

Проверка

Откройте URL постбэка в браузере с реальным click_id тестового клика. Конверсия появится в разделе Конверсии за несколько секунд. Если нет — Журнал постбэков покажет каждый запрос и причину отказа, например неизвестный click_id, неверный токен или клик вне окна атрибуции.

Если рекламодатель не может отправлять постбэки

• Пиксель: изображение или iframe на странице подтверждения. Проще, но менее надёжно: блокировщики рекламы могут ему помешать, а click_id нужно передать с лендинга на страницу подтверждения.
• API: POST /conversions с токеном в заголовке Authorization: Bearer и JSON (click_id, txn_id, status, amount).

Оба способа работают по тем же правилам, что и постбэк. URL и готовые примеры есть на странице интеграции рекламодателя.