Постбеки и конверсии

Постбек — это то, как партнёрка сообщает Roitrack, что клик сконвертился. Партнёрка дёргает ваш URL, Roitrack находит клик и записывает конверсию.

Ваш URL постбека

Он показан в настройках на вкладке Постбек и выглядит так:

https://your-tracking-domain.com/api/conversions/postback/<code>?click_id={clickid}

Вставьте его в поле постбека в кабинете партнёрки, заменив {clickid} на тот макрос, которым эта партнёрка обозначает переданный вами click ID.

Код безопасности

Сегмент <code> — это общий секрет. Запросы без актуального кода отклоняются с 403, и это не даёт подделать конверсии тому, кто угадал ваш домен.

Перегенерация кода в панели мгновенно обнуляет все выданные URL. Делайте это только когда есть время сразу обновить каждую партнёрку — иначе конверсии молча перестанут приходить.

Параметры

click_id обязателен. Остальное — по желанию.

Параметр	Что делает
`click_id`	Клик, к которому привязать конверсию. Обязателен.
`payout`	Выплата по этой конверсии
`status`	Произвольный статус от партнёрки
`event1` … `event10`	Записать в счётчик события это значение
`add_event1` … `add_event10`	Прибавить к счётчику. Отрицательное значение вычитает.

Принимаются и GET, и POST — подойдёт любой вариант вашей партнёрки.

Записать против прибавить

event3=25.5 перезаписывает событие 3 значением 25.5. add_event3=10 прибавляет 10 к тому, что уже есть, а add_event3=-10 вычитает 10.

Записывать удобно, когда партнёрка присылает накопительный итог; прибавлять — когда она присылает каждое событие отдельно. Смешение обоих подходов на одном событии даёт цифры, которые потом никто не сведёт: выберите одно правило на событие и запишите его.

Отрицательный add_ естественно подходит для отмен и возвратов.

Примеры макросов партнёрок

Каждая партнёрка называет макрос click ID по-своему. Подставьте свой:

Стиль партнёрки	URL постбека
`{clickid}`	`…/postback/<code>?click_id={clickid}&payout={payout}`
`{subid}`	`…/postback/<code>?click_id={subid}&payout={amount}`
`#s2s#`	`…/postback/<code>?click_id=#s2s#&payout=#payout#`
`[click_id]`	`…/postback/<code>?click_id=[click_id]&payout=[payout]`

Правило везде одно: то, что вы отправили партнёрке как click ID, должно вернуться в click_id. Про передачу наружу см. Источники трафика и макросы.

Проверка

В большинстве партнёрок есть кнопка «тестовый постбек» или «отправить тестовую конверсию». Нажмите её и загляните в лог кликов — конверсия должна появиться у клика через несколько секунд.

Кнопки нет? Пройдите по своей трекинговой ссылке, возьмите click ID из лога кликов и попросите менеджера партнёрки отправить по нему тестовую конверсию.

Если партнёрка показывает полученный ответ:

Ответ	Что значит
`200`	Принято
`403`	Неверный код безопасности — обычно его перегенерировали, а эту партнёрку не обновили
`404`	URL ведёт на домен без роли трекинга
`422`	click ID не дошёл — макрос партнёрки не подставляется

200 означает «принято», а не «уже видно». Конверсии идут через очередь и появляются чуть позже.

Как работает привязка

Roitrack находит исходный клик и переносит на конверсию всю его атрибуцию — кампанию, поток, оффер, лендинг, страну, устройство, браузер, ОС. Именно поэтому конверсии можно разбирать по любому срезу, хотя партнёрка прислала лишь click ID и выплату.

Отсюда два следствия:

Клик должен существовать. Постбеку с неизвестным click_id не к чему привязываться.
Побеждает последний постбек. Пришлите payout дважды по одному клику — возьмётся последнее значение. Именно так работают корректировки выплат.

Если конверсии не появляются

Найдите в логе кликов тот click ID, который прислала партнёрка. Нет клика — нет привязки.
Посмотрите код ответа, который получила партнёрка — обычно он есть в её логах. 403 означает устаревший код безопасности, чаще всего после перегенерации.
Убедитесь, что вы дали трекинговый домен, а не домен панели.
Проверьте режим отчёта. В режиме кликов конверсия попадает на дату своего клика, а не сегодняшнюю. Конверсия по клику прошлой недели лежит в прошлой неделе. См. Метрики и правила подсчёта.
Проверьте макрос click ID. Если партнёрка подставляет пустую строку, запросы будут приходить вообще без click_id.