Общая инструкция по настройке postback URL

From Справочник сервиса Kadam.net
Jump to: navigation, search

Для уведомления о целевых действиях (конверсиях и статусов конверсий) из партнерских программ (ПП) используется механизм 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:

рис. 1

Если не знаете, где посмотреть рекламируемую ссылку на свой оффер, пожалуйста, обращайтесь в поддержку ПП.
1.2 Обычно в рекламируемой ссылке можно указывать разные метки. Со списком меток, которые может передавать наша сеть в ПП, можно ознакомиться здесь.
Обязательное условие корректного уведомления о целевых действиях - это наличие метки [CPA] в рекламируемой ссылке.
Метки в ссылках могут присваиваться с помощью get параметров партнерской сети или же указываться по другим правилам строения ссылки партнерской сети.
Пример рекламируемой ссылки с метками нашей сети и параметрами: 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

рис. 2

- dr.cash

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

- advertise

рис. 4
рис. 5

К ссылке добавляется параметр - ?tid=[CPA]
Пример готовой ссылки выглядит так: http://avertise.com/go/XXXXXXXXXXXXXXXX/?tid=[CPA]
- admitad

рис. 6
рис. 7

К ссылке добавляется параметр - ?subid=[CPA]
Пример готовой ссылки выглядит так: http://ad.admitad.com/goto/xxxxxxxxxxxxxxxxxxx/?subid=[CPA]
Если самостоятельно не находите, где указываются метки в ссылке или не знаете, какие параметры используются для указания меток, пожалуйста, обращайтесь в поддержку ПП.
1.3 Полученная рекламируемая ссылка указывается в поле URL в рекламной кампании в кабинете Kadam. Пример для ссылки сети admitad:

рис. 8

1.4 В параметрах рекламной кампании нужно выбрать в поле "Модель оплаты" - Smart Ads, в поле "Уведомление о конверсии" - Postback URL, а в поле "Шаблон принятия" необходимо выбрать шаблон текущей нужной партнерской программы:

рис. 9

1.5 После клика по рекламному объявлению на площадке пользователь попадает на сайт рекламодателя, ссылка этого сайта будет уже со значением метки (уникальный clickID), которое будет присвоено параметру партнерской сети. Пример рекламируемой ссылки с произвольным значением метки: http://domen_partnerskoi_seti.offer.com/id_offera/?subid=0000x4a7d1ed414474e4033ac29ccb8653d9b
где subid - это параметр партнерской сети, со значением метки 0000x4a7d1ed414474e4033ac29ccb8653d9b. Значение параметра генерируется автоматически нашей сетью при клике по объявлению и отличается для каждого уникального перехода.

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

2.1 Разделяют 2 понятия postback URL: глобальный и локальный.
Глобальный postback настраивается в партнерской сети сразу для всех офферов. Обычно для настройки глобального postback URL выделено отдельное меню в инструментах партнерской сети, где вы 1 раз настраиваете postback URL, и он будет работать для всех последующих ваших потоков в этой партнерской сети.
Локальный postback настраивается в партнерской сети для конкретного оффера. Обычно локальный postback URL настраивается в конкретном потоке выбранного оффера партнерской сети, настраивается каждый раз для каждого нового потока.
ВАЖНО!!! Указывать нашу ссылку postback нужно только в одном из этих 2-х мест - или в настройках глобального postback URL или только в настройках локального postback URL, т.к. возможны дублирующие вызовы постбек ссылок или же вообще некорректная их отправка в нашу сеть со стороны партнерской сети. Но в некоторых партнерских сетях можно настроить postback только в одном конкретном меню, например, где не предусмотрена настройка глобального постбека, потому там и настраивайте.

2.2 После клика по рекламируемой ссылке объявления и совершения целевого действия пользователем (регистрация, заказ и т.п.), партнерская программа должна вызвать нашу postback ссылку, которая выглядит следующим образом: http://postback.kadam.net/ru/postback/?data={subid}
Название метки (subid) может быть любым (например, sub, sub1, sub_id, sid и т.д.) - обычно в партнерской программе уже будут готовые метки, которые можно использовать для передачи в постбеке.
Отправка постбека должна происходить обязательно методом GET, потому именно этот метод нужно выбирать всегда в настройках постбека в ПП.
Обычно параметр в рекламируемой ссылке, который принимает значения метки [CPA] совпадает с тем, который потом указывается и отправляется обратно в нашу сеть в качестве метки в постбеке.
Произвольные примеры рекламируемой ссылки и постбека:
Рекламируемая ссылка - http://domen_partnerskoi_seti.offer.com/id_offera/?subid=[CPA]
Постбек - http://postback.kadam.net/ru/postback/?data={subid}
или
Рекламируемая ссылка - http://domen_partnerskoi_seti.offer.com/id_offera/?sub1=[CPA]
Постбек - http://postback.kadam.net/ru/postback/?data={sub1}

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

2.3 Если в партнерской сети есть возможность передачи статусов конверсий (холд, подтверждена, отклонена), тогда в потбеке можно указать еще и параметр статуса:
&status - параметр используется для передачи статуса конверсии в нашей ссылке postback. Если параметр не используется, то целевое действие будет принято системой как подтвержденная конверсия. Обычно вы можете определить передаются ли статусы в партнерской сети, найдя в списке шаблонов принятия свою партнерскую сеть - если нашли, то значит статусы можно передавать. Также возможность передачи статусов конверсий партнерской сетью вы всегда можете уточнить в поддержке ПП.
Если партнерская сеть имеет возможность передавать статусы заказов, то используйте следующие параметры:

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

Пример указания списка параметров postback ссылки, которые может передавать партнерская сеть everad:

рис. 10

Список этих параметров вам и поможет для указания верной постбек ссылки для любой партнерской сети.
Видим из списка, что эта партнерская сеть может передавать статусы конверсий, потому постбек ссылка будет иметь вид:
http://postback.kadam.net/ru/postback/?data={sid1}&status={status}
где data - это обязательный параметр в ссылке postback для отправки clickid, {sid1} - метка партнерской сети, вместо которой при целевом действии отправляется значение clickid, status - это параметр в ссылке postback для отправки значения статуса конверсии, {status} - метка партнерской сети, вместо которой при целевом действии отправляется значение статуса конверсии (для каждой партнерской сети значения статусов свои и регулируются выбранным шаблоном принятия в настройках рекламной кампании в нашей сети - пункт 1.4), а каждый параметр в паре с меткой разделяются символом &.

  • В некоторых партнерских сетях необходимо самостоятельно ввести значения нужных параметров, в которых будут передаваться метки в постбек ссылке. Например, в ПП advertise:
рис. 11
  • В некоторых партнерских сетях нет возможности указать переменную статуса, но есть возможность указать отдельный постбек для каждого статуса конверсии. В этом случае вам необходимо самостоятельно указать все постбеки с нужными значениями статусов для каждого статуса конверсии. Например, в ПП salesdoubler нужно указывать 3 постбека для каждого из 3-х статусов конверсий ('в ожидании/pending' ; 'активно/approve' ; 'отклонено/rejected'):
рис. 12

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

Примеры ссылок и постбеков из произвольных партнерских программ

Название ПП Вид рекламируемой ссылки Вид ссылки постбека
ad1 http://c.cpl1.ru/XXXX/[CPA] http://postback.kadam.net/ru/postback/?data={subid}&status={status}
adinfo http://domen_lendinga.org/log/str?sub_id=[CPA] http://postback.kadam.net/ru/postback/?data={sub_id}&status={status}
admitad http://ad.admitad.com/goto/xxxxxxxxxxxxxxxxxxx/?subid=[CPA] http://postback.kadam.net/ru/postback/?data=[[[subid]]]&status=[[[payment_status]]]
advendor http://track.advendor.net/click?pid=XXXX&offer_id=XXX&sub1=[CPA] http://postback.kadam.net/ru/postback/?data={sub1}&status={status}
advertstar http://goto.astdn.ru/XXXXXX?cpa=[CPA] http://postback.kadam.net/ru/postback/?data={CUSTOM.cpa}&status={STATUS}
advgame https://r.advg.agency/t/XXXXX/?sub1=[CPA] http://postback.kadam.net/ru/postback/?data={sub1}&status={status}
ad-x http://track.trackurl.ru/click?pid=XXXXX&offer_id=XXX&sub1=[CPA] http://postback.kadam.net/ru/postback/?data={sub1}&status={status}
badboys.network http://primer.domen.com/?h=XXXXXXXXXXXXXXX&h_5=sub_id_2&h_2=[CPA] http://postback.kadam.net/ru/postback/?data={id}