Conversion Postback¶

Создание Conversion Postback¶

На странице инструментов Conversion Postback нажмите на кнопку Создать — откроется окно, где можно создать новый инструмент.

1. Введите адрес страницы, на которую вам будут отправляться запросы с уведомлениями о конверсиях в поле Postback URL.

2. Настройте выборку Conversion Postback в разделе Фильтры.

   1. Тип запроса: GET или POST.

   2. Тип действия — это тип конверсии, который вы хотите получать для обработки:

      • Все — уведомления о лидах (CPL), и о действиях или продажах (CPA).
      • CPL — уведомления только о новых лидах.
      • CPS — уведомления только о новых действиях или продажах.

   3. Фильтрация по офферам:

      • Да – Postback будет приходить по всем подключенным офферам
      • Нет – Postback будет приходить только по тем офферам, которые вы выберите в списке Подключенные офферы.

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

4. При необходимости задайте свои статические переменные.
5. Здесь вы можете посмотреть cформированный в итоге формат запроса, по которому партнерка будет отсылать Conversion Postback.
6. По окончанию настройки нажмите на кнопку Сохранить Postback URL.

Модерация Conversion Postback¶

Как видите, есть два варианта ответа от нашей техподдержки: позитивный и не очень. В результате модерации ваш инструмент:

1. Либо подтвердят, тогда вы начнете получать на указанный URL постбеки. И вам станут доступны функции Изменить и Проверить в таблице инструментов Conversion Postback.
2. Либо не подтвердят, тогда на основной странице инструмента будет указана причина отказа.

Проверка Conversion Postback¶

Инструмент Conversion Postback, который успешно прошел модерацию, можно протестировать. То есть необязательно дожидаться реальной конверсии, чтобы получить постбек от нашей системы.

Для того, чтобы проверить работоспособность вашего инструмента, в таблице со всеми инструментами нажмите на кнопку Проверить. В ходе проверки в значения ваших переменных подставятся рандомные значения, и сформированный таким образом ответ от системы будет отправлен на указанный вами URL. Результатом (на который указывает стрелка в скриншоте) будет ответ вашего сервера на наш запрос.

Обработка Conversion Postback¶

Вы можете обрабатывать и анализировать данные конверсий на свое усмотрение. В качестве примера мы привели простой код на php на главной странице инструмента:

<?php
//получение переменных отправленных в запросе
$offer_id = $_REQUEST['offer_id'];
$offer_name = $_REQUEST['offer_name'];
$sa = $_REQUEST['sa'];
$action_type = $_REQUEST['action_type'];
$payout = $_REQUEST['payout'];
//формируем строку лога
$line = 'Оффер: ' . $offer_name . '; Субаккаунт: ' . $sa . '; Тип действия: ' . $action_type . '; Сумма выплаты: ' . $payout . "\n";
//открываем файл для логгирования запросов
if ($handle = fopen($_SERVER['DOCUMENT_ROOT'] . '/conversion_postback.log', 'a')) {
       fwrite($handle, '[' . date('Y-m-d H:i:s') . ']:' . $line . "\n");
        fclose($handle);
}
?>

Пример

Вебмастер Сережа работает с нашей партнерской сетью, он на своих ресурсах (одним из которых является postback.test.ru) рекламирует магазины одежды.

1. У вебмастера Сережи есть жгучее желание узнавать, что и когда происходит с конверсиями по одному из офферов — ClothesTestOffer от магазина одежды ClothesTestShop.ru. Для этого Сережа настроил в системе GET Conversion Postback с названием test:

http://postback.test.ru/ru/postback?offer_id={offer_id}&offer_name={offer_name}&wp_id={wp_id}&wp_name={wp_name}&order_total={order_total}&action_type={action_type}&target_id={target_id}&target_name={target_name}&payout_id={payout_id}&payout={payout}&payout_currency={payout_currency}&xid={xid}&click_time={click_time}&event_time={event_time}&conversion_time={conversion_time}&ip={ip}&country={country}&user_device={user_device}&cpl_id={cpl_id}&open_commission={open_commission}&order_amount={order_amount}&status={status}&offer=ClothesTest

2. Еще Сережа добавил к своей партнерской ссылке на ClothesTestOffer уникальную метку xid = test_xid_1234567890: http://cityads.com/click-GCQE6T5C-JHFDQDT8?xid=test_xid_1234567890 и не забыл запросить в своем Conversion Postback параметр ID клика, чтобы получать от сервера системы xid.
3. Девушка Надя на сайте Сережи увидела классную рекламу и перешла по партнерской ссылке на сайт ClothesTestShop.ru. Так она положила в свою корзину 5 платьев на сумму 15000RUR и оформила заказ – вебмастеру пришел CPL Conversion Postback вот такого вида:

http://postback.test.ru/ru/postback/?offer_id=3135&offer_name=ClothesTestOffer&wp_id=51935&wp_name=test&order_total=15000&action_type=CPL&target_id=89153&target_name=NewTarget&payout_id=&payout=&payout_currency=&xid=test_xid_1234567890&click_time=1461595009&event_time=1461595182&conversion_time=&ip=212.233.125.98&country=RU&user_device=stationary&cpl_id=1555693533&open_commission=1500&order_amount=&status=open&offer=ClothesTest

4. Однако, когда Наде привезли платья, в 2 из них она не влезла и в итоге оплатила только 3 штуки на 10000RUR – вебмастеру пришел CPS Conversion Postback вот такого вида:

http://postback.test.ru/ru/postback/?offer_id=3135&offer_name=ClothesTest_Dress&wp_id=51935&wp_name=test&order_total=15000&action_type=CPA&target_id=89752&target_name=Оплаченный заказ&payout_id=3424973352&payout=942&payout_currency=RUR&data=test_xid_1234567890&click_time=1461595009&event_time=1461595947&conversion_time=1461596078&ip=212.233.125.98&country=RU&user_device=stationary&cpl_id=1555693533&open_commission=1500&order_amount=10000&status=approved&offer=ClothesTest