Настройка postback для СРА

Для уведомления об успешной конверсии используется механизм postback (он же pingback, он же s2s).
Эта статья содержит информацию о настройке уведомления о конверсии при помощи этого механизма.

1 Прием и сохранение специальной метки на рекламируемом ресурсе или в партнерской программе
2 Отправка метки ресурсом или партнерской программой после совершенного действия в сервис Kadam
- 2.1 Использование дополнительных параметров
3 Инструкция по настройке уведомлений об успешных конверсиях из популярных партнерских программ
4 Инструкция по настройке уведомлений об успешных конверсиях в популярных трекерах

Прием и сохранение специальной метки на рекламируемом ресурсе или в партнерской программе

Для передачи postback-метки (click_id) из сервиса Kadam вам необходимо добавить в ссылку рекламного объявления макрос {click_id}, например:
http://www.test.ru/home/?subid={click_id}
После клика по рекламному объявлению на площадке пользователь попадает на сайт рекламодателя, ссылка этого сайта будет уже со специальной меткой в виде обычного GET-параметра.
Пример рекламируемой ссылки с произвольным значением метки:
http://www.test.ru/home/?subid=0000x4a7d1ed414474e4033ac29ccb8653d9b
где GET-параметром в данном случае выступает параметр subid со значением 0000x4a7d1ed414474e4033ac29ccb8653d9b. Значение параметра генерируется динамически и отличается для каждого уникального перехода.
Название параметра (subid) может быть любым (например, sub, sub1, sub_id, sid и т. д.) — устанавливается самим рекламодателем, или в партнерской программе уже будут готовые параметры, которые можно использовать для передачи метки.
Значение параметра subid необходимо сохранить на стороне рекламируемого ресурса или партнерской программы.
БЕЗ ПЕРЕДАЧИ МАКРОСОВ ИЗ РЕКЛАМНОЙ СЕТИ ПОЛНОЦЕННАЯ РАБОТА ПОСТБЕКА — НЕВОЗМОЖНА!

Отправка метки ресурсом или партнерской программой после совершенного действия в сервис Kadam

После совершения действия пользователем (регистрация и т. п.) рекламируемый ресурс или партнерская программа должна вызвать нашу postback-ссылку, которая выглядит следующим образом: https://kdtrk.net/ru/postback/?data={subid}
где {subid} — это пример параметра, которому передаётся метка {click_id} в рекламируемой ссылке. В зависимости от разных факторов (партнерская сеть, CRM рекламодателя и т. д.) параметр может быть любым (например, {sub}, {sub1}, {sub_id}, {sid} и т. д.).
Для данных из примера рекламируемой ссылки выше (с указанным произвольным значением метки) postback-ссылка будет выглядеть следующим образом:
https://kdtrk.net/ru/postback/?data=0000x4a7d1ed414474e4033ac29ccb8653d9b
Обычно параметр в рекламируемой ссылке, который принимает значения метки {click_id}, совпадает с тем, который потом указывается и отправляется обратно в нашу сеть в постбеке.
Произвольные примеры рекламируемой ссылки и постбека:
Рекламируемая ссылка — http://www.test.ru/home/?subid={click_id}
Постбек — https://kdtrk.net/ru/postback/?data={subid}
или
Рекламируемая ссылка — http://www.test.ru/home/?sub1={click_id}
Постбек — https://kdtrk.net/ru/postback/?data={sub1}
Но бывают и исключения (очень редко в некоторых партнерских сетях, например, Vlk.partners), когда параметр в рекламируемой ссылке может не совпадать с параметром в постбеке.
Например:
Рекламируемая ссылка — http://www.test.ru/home/?cid={click_id}
Постбек — https://kdtrk.net/ru/postback/?data={url.cid}
Или пример, когда параметр указывается не в фигурных скобках (очень редко в некоторых партнерских сетях, например, admitad):
Рекламируемая ссылка — http://www.test.ru/home/?subid={click_id}
Постбек — https://kdtrk.net/ru/postback/?data=[[[subid]]]
То есть вид рекламируемой ссылки с нашей меткой {click_id} и вид ссылки postback будет зависеть от того, с какой партнерской сетью (трекером, CRM) вы интегрируетесь.
ВАЖНО!
Если вы используете прокладку, с которой осуществляется переход на лендинги нескольких офферов, для создания корректных уведомлений о конверсиях для всех кампаний текущих офферов вам необходимо прописать у себя ссылки с подстановкой GET-параметров <?php echo $_GET['параметр'];?> (этот способ работает для PHP-страниц).
Пример получения параметра subid для партнерки actionpay.ru:

Ссылка на стороне Kadam (указываемая в URL кампании и объявлений):

http://domen.ru/index/biznes/059/?subid={click_id}

Ссылка на стороне рекламодателя (указываемая в коде прокладки вместо всех ссылок):

n.actionpay.ru/click/56014f2a8b30a808438b4567/106002/91267/<?php echo $_GET['subid'];?>

Использование дополнительных параметров

Сервис Kadam поддерживает передачу дополнительных параметров в postback.
Эти параметры могут передаваться при необходимости:
&status — параметр используется для передачи статуса конверсии. Шаблон статусов можно выбрать при настройке рекламной кампании или указать свой вариант. Если параметр не используется, то конверсия будет принята системой как подтверждённая.
Если вы имеете возможность передавать статусы заказов, то используйте следующие параметры:

&status=hold — лид в «холде»
&status=approved — лид подтверждён
&status=reject — лид отклонён

&cost — параметр используется, если стоимость лида может варьироваться в зависимости от каких-либо параметров. Если параметр не будет указан, информация о стоимости лида будет взята из оффера/кампании.
Пример: &cost=200
&currency — параметр используется для передачи валюты. Сервис Kadam поддерживает такие валюты: евро, доллар, гривна, тенге. При использовании валюты, отличной от доллара, с вашего баланса будет списана сумма, полученная в результате конвертации указанной валюты в доллары.
Если стоимость лида в долларах, передача параметра с валютой не требуется.
В других случаях используйте следующие параметры:

&currency=UAH — гривна
&currency=USD — доллар
&currency=EUR — евро
&currency=KZT — тенге

key — параметр для учёта дублей конверсий в статистике в кабинете. Подойдёт, например, для офферов e-commerce (видеть повторные заказы), для модели RevShare с оплатой по повторным депозитам и других подобных офферов, где нужно видеть дубли в статистике.
Если параметр не указан, то дубли конверсий не будут учитываться.
Для параметра key указывается метка, которая отвечает за передачу ID конверсии в ПП (партнёрской программе).
Пример: &key={conversionid}
Если вы работаете с партнерской программой, обратитесь в службу поддержки партнерской программы для помощи в настройке уведомлений об успешных конверсиях.
Настоятельно советуем после настройки проводить тестовые конверсии до запуска кампании, чтобы не потерять данные об успешных конверсиях.