Difference between revisions of "Общая инструкция по настройке postback URL"

Revision as of 12:42, 21 December 2018

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

Для корректной работы уведомлений о целевых действий необходимо настроить 2 вещи:
1. Передача в рекламируемой ссылке партнерской сети нашей метки: [CPA].
2. Вызов партнерской сетью нашего postback URL со значением метки того клика, по которому было целевое действие.

Теперь подробнее о настройках каждого пункта.

1. Настройка передачи значений нашей метки [CPA] в рекламируемой ссылке партнерской сети

1.1 Для рекламы любого оффера партнерская сеть выдает вам рекламируемую ссылку. Например: http://domen_partnerskoi_seti.offer.com/id_offera
Эту ссылку обычно вы получаете при выборе оффера из списка в партнерской сети, в меню настроек потока на оффер или же после окончания настройки потока на оффер. Пример получения ссылки на оффер в ПП ad-x:
centre|frame|рис. 1 Если не знаете, где посмотреть рекламируемую ссылку на свой оффер, пожалуйста, обращайтесь в поддержку ПП.
1.2 Обычно в рекламируемой ссылке можно указывать разные метки. Со списком меток, которые может передавать наша сеть в ПП, можно ознакомиться здесь. Метки в ссылках могут присваиваться параметрам партнерской сети или же указываться по другим правилам строения ссылки партнерской сети.
Пример рекламируемой ссылки с метками нашей сети и параметрами: http://domen_partnerskoi_seti.offer.com/id_offera/?sub1=[CPA]&sub2=[SID]&sub3=[CID]&sub4=[ID]
где sub1, sub2, sub3, sub4 - это параметры партнерской сети, в которых указаны метки нашей сети - [CPA],[SID],[CID],[ID], а каждый параметр в паре с меткой разделяются символом &.
У каждой ПП свои названия параметров (могут быть любыми, например, sub, sub1, sub_id, sid и т.д.), также свое количество таких параметров (в одной партнерской сети параметров может быть 10, а в другой 2), а также в некоторых ПП метки могут вообще указываться без параметров по своим правилам строения рекламируемой ссылки.
Метки обычно указываются в меню настроек оффера (потока на оффер) или же указываются вручную.
Вот примеры того, где указываются метки в рекламируемой ссылке в разных партнерских сетях:

• Например, в сетях advendor и dr.cash в меню настроек потока сразу есть поля, где можно указать метки, потом метки автоматически дописываются к рекламируемой ссылке:
  

- advendor
centre|frame|рис. 2 - dr.cash
centre|frame|рис. 3

• Например, в сетях advertise и admitad необходимо получить основную рекламируемую ссылку, а уже вручную дописать к ней метку при создании рекламной кампании в нашей сети:
  

- advertise
centre|frame|рис. 4 centre|frame|рис. 5 К ссылке добавляется параметр - ?tid=[CPA]
Пример готовой ссылки выглядит так: http://avertise.com/go/XXXXXXXXXXXXXXXX/?tid=[CPA]
- admitad
centre|frame|рис. 6 centre|frame|рис. 7 К ссылке добавляется параметр - ?subid=[CPA]
Пример готовой ссылки выглядит так: http://ad.admitad.com/goto/xxxxxxxxxxxxxxxxxxx/?subid=[CPA]
Полученная ссылка пишется с параметром CPA в поле URL в рекламной кампании в кабинете Kadam. centre|frame|рис. 8 А в параметрах рекламной кампании в поле "Шаблон принятия" необходимо выбрать шаблон текущей нужной партнерской программы: centre|frame|рис. 9 Если самостоятельно не находите, где указываются метки в ссылке или не знаете, какие параметры используются для указания меток, пожалуйста, обращайтесь в поддержку ПП.

2. Настройка postback URL в партнерской сети

Если не знаете, где посмотреть рекламируемую ссылку на свой оффер, пожалуйста, обращайтесь в поддержку ПП.

Например: http://domen_partnerskoi_seti.offer.com/id_offera/?sub=[CPA]& Метки в ссылках присваиваются параметрам, например: Для передачи postback-метки (ClickId) из сервиса Kadam, Вам необходимо добавить в ссылку рекламного объявления макрос [CPA], например:

http://www.test.ru/home/?subid=[CPA]

После клика по рекламному объявлению на площадке пользователь попадает на сайт рекламодателя, ссылка этого сайта будет уже со специальной меткой в виде обычного get параметра.

Пример рекламируемой ссылки с произвольным значением метки:

http://www.test.ru/home/?subid=0000x4a7d1ed414474e4033ac29ccb8653d9b

где get параметром в данном случае выступает параметр subid, со значением 0000x4a7d1ed414474e4033ac29ccb8653d9b. Значение параметра генерируется динамически и отличается для каждого уникального перехода.

Название параметра (subid) может быть любым (например, sub, sub1, sub_id, sid и т.д.) - устанавливается самим рекламодателем или в партнерской программе уже будут готовые параметры, которые можно использовать для передачи метки.

Значение параметра subid необходимо сохранить на стороне рекламируемого ресурса или партнерской программы.

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

После совершения действия пользователем (регистрация и т.п), рекламируемый ресурс или партнерская программа должна вызвать нашу postback ссылку, которая выглядит следующим образом: http://postback.kadam.net/ru/postback/?data={subid}

где {subid} - это пример параметра, которому передается метка [CPA] в рекламируемой ссылке. В зависимости от разных факторов (партнерская сеть, CRM рекламодателя и т.д.) параметр может может быть любым (например, {sub}, {sub1}, {sub_id}, {sid} и т.д.).

Для данных из примера рекламируемой ссылки выше (с указанным произвольным значением метки) postback ссылка будет выглядеть следующим образом:

http://postback.kadam.net/ru/postback/?data=0000x4a7d1ed414474e4033ac29ccb8653d9b

Обычно параметр в рекламируемой ссылке, который принимает значения метки [CPA] совпадает с тем, который потом указывается и отправляется обратно в нашу сеть в постбеке.
Произвольные примеры рекламируемой ссылки и постбека:
Рекламируемая ссылка - http://www.test.ru/home/?subid=[CPA]
Постбек - http://postback.kadam.net/ru/postback/?data={subid}
или
Рекламируемая ссылка - http://www.test.ru/home/?sub1=[CPA]
Постбек - http://postback.kadam.net/ru/postback/?data={sub1}

Но бывают и исключения (очень редко в некоторых партнерских сетях, например, Vlk.partners), когда параметр в рекламируемой ссылке может не совпадать с параметром в постбеке.
Например:
Рекламируемая ссылка - http://www.test.ru/home/?сid=[CPA]
Постбек - http://postback.kadam.net/ru/postback/?data={url.cid}
Или пример, когда параметр указывается не в фигурных скобках (очень редко в некоторых партнерских сетях, например, admitad):
Рекламируемая ссылка - http://www.test.ru/home/?subid=[CPA]
Постбек - http://postback.kadam.net/ru/postback/?data=[[[subid]]]
Т.е. вид рекламируемой ссылки с нашей меткой [CPA] и вид ссылки postback будет зависеть от того, с какой партнерской сетью (трекером, crm) вы интегрируетесь.

ВАЖНО! В случае если вы используете прокладку, с которой осуществляется переход на лендинги нескольких офферов, для создания корректных уведомлений о конверсиях для всех KSA кампаний текущих офферов, Вам необходимо прописать у себя ссылки с подстановкой get параметров <?php echo $_GET['параметр'];?> (данный способ работает для PHP страниц).

Пример получения параметра subid для партнерки actionpay.ru:

http://domen.ru/index/biznes/059/?subid=[CPA]

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

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

Сервис Kadam поддерживает передачу дополнительных параметров в postback.

Данные параметры могут передаваться при необходимости:

&status - параметр используется для передачи статуса конверсии. Если параметр не используется, то конверсия будет принята системой как подтвержденная и за неё будут списаны средства.

Если вы имеете возможность передавать статусы заказов, то используйте следующие параметры:

1. &status=hold - лид в "холде"
2. &status=approved - лид подтвержден
3. &status=reject - лид отклонен

&cost - параметр используется, если стоимость лида может варьироваться в зависимости от каких-либо параметров. Если параметр не будет указан, информация о стоимости лида будет взята из оффера/кампании. Пример: &cost=200

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

В других случаях используйте следующие параметры:

1. &currency=UAH - гривна
2. &currency=USD - доллар
3. &currency=EUR - евро
4. &currency=KZT - тенге

Если вы работаете с партнерской программой, обратитесь в службу поддержки партнерской программы для помощи в настройке уведомлений об успешных конверсиях.

Настоятельно советуем после настройки проводить тестовые конверсии до запуска кампании, чтобы не потерять данные об успешных конверсиях.

Инструкция по настройке уведомлений об успешных конверсиях из популярных партнерских программ