Как настроить постбэк (S2S) паблишеру

Постбэк — это HTTP-запрос, который Indoleads отправляет на ваш URL при создании конверсии и при каждой смене её статуса, чтобы ваш трекер/CRM синхронизировался без ручных выгрузок. Один запрос на событие.

Глобальный постбэк (все офферы)

1. Settings → Postback → Add.
2. Вставьте postback-URL вашего трекера и добавьте макросы, кликая по ним под полем. Типичный минимум:

https://your-tracker.com/postback?cid={p1}&status={status}&payout={payout_usd}&txid={conversion_id}
— где свой click ID вы передавали в p1 при сборке трекинг-ссылки.

1. By events: Create only (один постбэк при создании конверсии) или Create and status update (плюс при каждой смене статуса: pending → approved/declined/paid). Выбирайте второе, если трекер умеет обновлять статусы — большинство умеет.
2. Test — платформа отправит тестовый запрос; проверьте, что он дошёл до трекера.
3. Save. Постбэк уходит на модерацию; после одобрения запросы начинают приходить.

Постбэк на конкретный оффер: страница оффера → раздел Postback → Add (та же форма). Нужен, когда трекеру нужен свой URL под каждый оффер.

Доступные токены (клик — вставить): {conversion_id} {click_id} {status} (pending/approved/declined/paid) {payout} {payout_usd} {currency} {sale_amount} {sale_amount_usd} {txn_id} {offer_id}/{campaign_id} {offer_title}/{campaign_title} {p1}…{p4} {sub_publisher_id} {sub1}…{sub4} (параметры рекламодателя) {conversion_date} {conversion_time} {conversion_datetime} (UTC+8) {click_time} {country_id} {ip} {agent} {referer} {publisher_id}/{aff_id} {advertiser_id}/{adv_id} {random}.

Советы

• Ваш эндпоинт должен ответить HTTP 200 с первой попытки — повторов нет. Если сервер лежал, доберите пропущенные конверсии через API /conversions.
• Статусы меняются со временем (pending → approved), поэтому на одну конверсию придёт несколько постбэков — обновляйте запись, а не создавайте вторую.
• Не вставляйте API-токен в postback-URL.
• Нужна история массово? Используйте Publisher API, метод /conversions.

Интеграция рекламодателя (передача конверсий в Indoleads) — это другое, см. Интеграция для рекламодателей.