Варианты интеграции для рекламодателей: постбэк (S2S), пиксель, контейнер, API

Изменено Пн, 17 Авг на 11:07 PM

Чтобы платить паблишерам, Indoleads должен узнавать о каждой конверсии на вашей стороне. Один из четырёх способов — от самого надёжного к менее надёжному.

Как работает атрибуция. Каждый клик по трекинг-ссылке паблишера получает уникальный click_id. Мы добавляем его в URL вашего оффера (например, https://yoursite.com/?click_id={click_id}), а вы возвращаете его вместе с конверсией. Конверсия без валидного click_id (или с неверным security_token) отклоняется. Страна конверсии = страна IP клика.

1. Постбэк (S2S) — рекомендуем

Ваш сервер вызывает наш URL при подтверждении заказа/лида:


https://app.indoleads.com/acquisition?click_id=CLICK_ID&security_token=SECURITY_TOKEN&txn_id=ORDER_ID&sale_amount=AMOUNT&currency=USD

(trk.indoleads.com работает так же, как app.indoleads.com.)

Параметр	Обяз.	Значение
`click_id`	да	Значение, которое мы передали в URL оффера. Сохраняйте его в сессии/заказе.
`security_token`	да	Ваш токен рекламодателя, показан на странице оффера. Подтверждает, что постбэк от вас.
`txn_id`	да	Ваш уникальный ID заказа/транзакции — защита от дублей.
`sale_amount` + `currency`	одно из	Сумма заказа; выплату паблишеру считаем мы по комиссии оффера (CPS % / CPA фикс).
`rate` (или `revenue`) + `currency`	одно из	Точная сумма комиссии, если считаете сами; комиссия оффера тогда не применяется (выплата паблишеру = rate − комиссия сети).
`cat`	нет	Код категории, если выплаты различаются по категориям (fashion, electronics…).
`status`	нет	`pending` (по умолчанию), `approved`, `declined`. Отправьте повторно с новым статусом, чтобы обновить.
`sub1`–`sub4`	нет	Любые свои значения для отчётов (SKU, количество, session ID…).

Плюсы: без куки, не режется браузерами/адблоками, проверяемо (токен + известные IP).

2. Пиксель

<img> на странице «спасибо»; click_id читается из куки посетителя, поставленной при клике:


<img src="https://app.indoleads.com/api/pixel?adid=OFFER_ID&txn_id=ORDER_ID&sale_amount=AMOUNT&currency=USD">

Те же необязательные параметры, что у постбэка (rate, cat, sub1–4; click_id можно передать явно — для не-нашего трафика оставляйте пустым). В трекинг-ссылки ничего добавлять не нужно. Минус: блокируется частью браузеров/расширений → только если не можете хранить click_id на сервере.

3. Контейнер (JS)

Скрипт на странице «спасибо» — та же идея, что пиксель, но JS-сниппет: TXN_ID, RATE, CURRENCY, OFFER_ID, NETWORK = "https://app.indoleads.com". sub1–4 не поддерживаются.

4. API

Если у вашей платформы есть API конверсий (Impact, Partnerize, Awin, TUNE, отчёты AppsFlyer/Adjust, своё), пришлите документацию — наши разработчики сделают выгрузку на нашей стороне, включая нужные вам sub-поля.

Что выбрать?

Ваш бэкенд может хранить click_id и слать запросы? → Постбэк.
Только фронтенд? → Пиксель или контейнер.
Уже есть API/сеть? → API.
Всегда передавайте txn_id, чтобы не было дублей.

Тест перед запуском

Откройте трекинг-ссылку своего оффера в браузере → попадите на сайт → сделайте тестовый заказ → конверсия должна появиться в вашем дашборде Reports → Conversions log в течение минут. Если нет — проверьте передачу click_id, токен и что пиксель реально срабатывает на странице «спасибо». Наш интеграционный менеджер делает это вместе с вами.

После запуска: валидация конверсий

Вы подтверждаете/отклоняете конверсии в Reports → Conversions log (кнопки в строке), через status= в постбэках или присылая ежемесячный сверочный файл — в рамках холда, который задали на оффере. Отклонено = паблишеру не оплачивается. См. Валидация конверсий.