Просмотр исходного текста страницы Общая инструкция по настройке postback URL

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

Для корректной работы уведомлений о целевых действий необходимо произвести 2 основные настройки:<br/>
'''1.''' Передача в рекламируемой ссылке партнерской сети нашей метки: {click_id}.<br/>
'''2.''' Вызов партнерской сетью нашего postback URL со значением метки того клика, по которому было целевое действие.<br/>

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

== 1. Настройка передачи значений нашей метки {click_id} в рекламируемой ссылке партнерской сети  ==

'''1.1''' Для рекламы любого оффера партнерская сеть выдает вам рекламируемую ссылку. Например: <span style="color:red"><code>http<nowiki/>://domen_partnerskoi_seti.offer.com/id_offera</code></span> <br/>
Эту ссылку обычно вы получаете при выборе оффера из списка в партнерской сети, в меню настроек потока на оффер или же после окончания настройки потока на оффер. Пример получения ссылки на оффер в ПП ad-x:<br/>
[[Файл:Adxpost.png|centre|frame|рис. 1]]
'''Если не знаете, где посмотреть рекламируемую ссылку на свой оффер, пожалуйста, обращайтесь в поддержку ПП.'''<br/>
'''1.2''' Обычно в рекламируемой ссылке можно указывать разные метки. Со списком меток, которые может передавать наша сеть в ПП, можно ознакомиться [[Настройка_макросов|здесь]].<br/>
'''Обязательное условие корректного уведомления о целевых действиях - это наличие метки <span style="color:red">{click_id}</span> в рекламируемой ссылке.'''<br/>
Метки в ссылках могут присваиваться с помощью <span style="color:red">get</span> параметров партнерской сети или же указываться по другим правилам строения ссылки партнерской сети.<br/>
Пример рекламируемой ссылки с метками нашей сети и параметрами: <span style="color:red"><code>http<nowiki/>://domen_partnerskoi_seti.offer.com/id_offera/?sub1={click_id}&sub2={site_id}&sub3={campaign_id}&sub4={ad_id}</code></span> <br/>
где <span style="color:red">sub1, sub2, sub3, sub4</span> - это параметры партнерской сети, в которых указаны метки нашей сети - <span style="color:red">{click_id},{site_id},{campaign_id},{ad_id}</span>, а каждый параметр в паре с меткой разделяются символом &.<br/>
У каждой ПП свои названия параметров (могут быть любыми, например, sub, sub1, sub_id, sid и т.д.), также свое количество таких параметров (в одной партнерской сети параметров может быть 10, а в другой 2), а также в некоторых ПП метки могут вообще указываться без параметров по своим правилам строения рекламируемой ссылки.<br/>
Метки обычно указываются в меню настроек оффера (потока на оффер) или же указываются вручную.<br/>
Вот примеры того, где указываются метки в рекламируемой ссылке в разных партнерских сетях:<br/>

* Например, в сетях advendor и dr.cash в меню настроек потока <span style="color:red">сразу есть поля, где можно указать метки</span>, потом метки автоматически дописываются к рекламируемой ссылке:<br/>
'''- advendor'''<br/>
[[Файл:Addorcpa.png|centre|frame|рис. 2]]
'''- dr.cash'''<br/>
[[Файл:Drcashmetkanazv.png|centre|frame|рис. 3]]
* Например, в сетях advertise и admitad необходимо получить основную рекламируемую ссылку, а уже <span style="color:red">вручную дописать к ней метку</span> при создании рекламной кампании в нашей сети:<br/>
'''- advertise'''<br/>
[[Файл:Advertise6.png|centre|frame|рис. 4]]
[[Файл:Advertise7.png|centre|frame|рис. 5]]
К ссылке добавляется параметр - ?tid={click_id}<br/>
Пример готовой ссылки выглядит так: <code>http:<nowiki/>//avertise.com/go/XXXXXXXXXXXXXXXX/?tid={click_id}</code><br/>
'''- admitad'''<br/>
[[Файл:Admitad_postback12.png|centre|frame|рис. 6]]
[[Файл:Admitad_postback13.png|centre|frame|рис. 7]]
К ссылке добавляется параметр - ?subid={click_id}<br/>
Пример готовой ссылки выглядит так: <code>http<nowiki/>://ad.admitad.com/goto/xxxxxxxxxxxxxxxxxxx/?subid={click_id}</code> <br/>
'''Если самостоятельно не находите, где указываются метки в ссылке или не знаете, какие параметры используются для указания меток, пожалуйста, обращайтесь в поддержку ПП.'''<br/>
'''1.3''' Полученная рекламируемая ссылка указывается в поле URL в рекламной кампании в кабинете Kadam. Пример для ссылки сети admitad:
[[Файл:Admitad_postback14.png|centre|frame|рис. 8]]
'''1.4''' В параметрах рекламной кампании нужно выбрать в поле "Модель оплаты" - '''Smart Ads''', в поле "Уведомление о конверсии" - '''Postback URL''', а в поле <b>"Шаблон принятия"</b> необходимо выбрать шаблон текущей нужной партнерской программы:
[[Файл:Admitad prin.png|centre|frame|рис. 9]]
'''1.5''' После клика по рекламному объявлению на площадке пользователь попадает на сайт рекламодателя, ссылка этого сайта будет уже со значением метки (уникальный <span style="color:red">clickID</span>), которое будет присвоено параметру партнерской сети.
Пример рекламируемой ссылки с произвольным значением метки:
<span style="color:red"><code>http<nowiki/>://domen_partnerskoi_seti.offer.com/id_offera/?subid=0000x4a7d1ed414474e4033ac29ccb8653d9b</code> <br/></span>
где <span style="color:red">subid</span> - это параметр партнерской сети, со значением метки <span style="color:red">0000x4a7d1ed414474e4033ac29ccb8653d9b</span>. Значение параметра генерируется автоматически нашей сетью при клике по объявлению и отличается для каждого уникального перехода.

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

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

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

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

'''2.3''' Если в партнерской сети есть возможность передачи статусов конверсий (холд, подтверждена, отклонена), тогда в потбеке можно указать еще и параметр статуса:<br/>
'''&status''' - параметр используется для передачи статуса конверсии в нашей ссылке postback. Если параметр не используется, то целевое действие будет принято системой как подтвержденная конверсия. Обычно вы можете определить передаются ли статусы в партнерской сети, найдя в списке шаблонов принятия свою партнерскую сеть - если нашли, то значит статусы можно передавать. Также возможность передачи статусов конверсий партнерской сетью вы всегда можете уточнить в поддержке ПП. <br/>
Если партнерская сеть имеет возможность передавать статусы заказов, то используйте следующие параметры:<br/>
<ol>
<li>&status=hold - лид в "холде"</li>
<li>&status=approved - лид подтвержден</li>
<li>&status=reject - лид отклонен</li>
</ol>
Пример указания списка параметров postback ссылки, которые может передавать партнерская сеть everad:<br/>
[[Файл:4. сохранить поток.jpg|centre|frame|рис. 10]]
<!--[[Файл:4. Smartnatrkom.png|centre|frame|рис. 10]]-->
Список этих параметров вам и поможет для указания верной постбек ссылки для любой партнерской сети.<br/>
Видим из списка, что эта партнерская сеть может передавать статусы конверсий, потому постбек ссылка будет иметь вид:<br/>
<code>http<nowiki/>://postback.kadam.net/ru/postback/?data={sid1}&status={status}</code><br/>
где <span style="color:red">data</span> - это обязательный параметр в ссылке postback для отправки clickid, <span style="color:red">{sid1}</span> - метка партнерской сети, вместо которой при целевом действии отправляется значение clickid, <span style="color:red">status</span> - это параметр в ссылке postback для отправки значения статуса конверсии, <span style="color:red">{status}</span> - метка партнерской сети, вместо которой при целевом действии отправляется значение статуса конверсии (для каждой партнерской сети значения статусов свои и регулируются выбранным шаблоном принятия в настройках рекламной кампании в нашей сети - пункт 1.4), а каждый параметр в паре с меткой разделяются символом &.<br/>
*В некоторых партнерских сетях необходимо самостоятельно ввести значения нужных параметров, в которых будут передаваться метки в постбек ссылке. Например, в ПП advertise:<br/>
[[Файл:Advertisefirstsetpost.png|centre|frame|рис. 11]]
*В некоторых партнерских сетях нет возможности указать переменную статуса, но есть возможность указать отдельный постбек для каждого статуса конверсии. В этом случае вам необходимо самостоятельно указать все постбеки с нужными значениями статусов для каждого статуса конверсии. Например, в ПП salesdoubler нужно указывать 3 постбека для каждого из 3-х статусов конверсий ('в ожидании/pending' ; 'активно/approve' ; 'отклонено/rejected'):<br/>
[[Файл:Salesscr11.png|centre|frame|рис. 12]]
'''Если самостоятельно не получается указать необходимые параметры и метки в меню настроек postback в партнерской сети, пожалуйста, обращайтесь в поддержку ПП.'''<br/> 
==Примеры ссылок и постбеков из произвольных партнерских программ==
<table>
   <tr bgcolor = #DCDCDC>
       <th width = 130 align = left>Название ПП</th>
       <th width = 550 align = left>Вид рекламируемой ссылки</th>
       <th width = 650 align = left>Вид ссылки постбека</th>
   </tr>
   <tr bgcolor = #F5F5F5>
       <td>ad1</td>
       <td><code>http<nowiki/>://c.cpl1.ru/XXXX/{click_id}</code></td>
       <td><code>http<nowiki/>://postback.kadam.net/ru/postback/?data={subid}&status={status}</code></td>
   </tr>
   <tr bgcolor = #F5F5F5>
       <td>adinfo</td>
       <td><code>http<nowiki/>://domen_lendinga.org/log/str?sub_id={click_id}</code></td>
       <td><code>http<nowiki/>://postback.kadam.net/ru/postback/?data={sub_id}&status={status}</code></td>
   </tr>
   <tr bgcolor = #F5F5F5>
       <td>admitad</td>
       <td><code>http<nowiki/>://ad.admitad.com/goto/xxxxxxxxxxxxxxxxxxx/?subid={click_id}</code></td>
       <td><code>http<nowiki/>://postback.kadam.net/ru/postback/?data=[[[subid]]]&status=[[[payment_status]]]</code></td>
   </tr>
   <tr bgcolor = #F5F5F5>
       <td>advendor</td>
       <td><code>http<nowiki/>://track.advendor.net/click?pid=XXXX&offer_id=XXX&sub1={click_id}</code></td>
       <td><code>http<nowiki/>://postback.kadam.net/ru/postback/?data={sub1}&status={status}</code></td>
   </tr>
   <tr bgcolor = #F5F5F5>
       <td>advertstar</td>
       <td><code>http<nowiki/>://goto.astdn.ru/XXXXXX?cpa={click_id}</code></td>
       <td><code>http<nowiki/>://postback.kadam.net/ru/postback/?data={CUSTOM.cpa}&status={STATUS}</code></td>
   </tr>
   <tr bgcolor = #F5F5F5>
       <td>advgame</td>
       <td><code>https<nowiki/>://r.advg.agency/t/XXXXX/?sub1={click_id}</code></td>
       <td><code>http<nowiki/>://postback.kadam.net/ru/postback/?data={sub1}&status={status}</code></td>
   </tr>
   <tr bgcolor = #F5F5F5>
       <td>ad-x</td>
       <td><code>http<nowiki/>://track.trackurl.ru/click?pid=XXXXX&offer_id=XXX&sub1={click_id}</code></td>
       <td><code>http<nowiki/>://postback.kadam.net/ru/postback/?data={sub1}&status={status}</code></td>
   </tr>
   <tr bgcolor = #F5F5F5>
       <td>badboys.network</td>
       <td><code>http<nowiki/>://primer.domen.com/?h=XXXXXXXXXXXXXXX&h_5=sub_id_2&h_2={click_id}</code></td>
       <td><code>http<nowiki/>://postback.kadam.net/ru/postback/?data={id}</code></td>
   </tr>
<table>