Интеграция через postback-запрос для финансовых программ

При интеграции через postback-запрос сервер рекламодателя отправляет запрос с данными о совершенных на его сайте действиях серверу Admitad Affiliate. Сервер Admitad Affiliate забирает эти данные и загружает их в статистику.

Особенности интеграции через postback:

• Изменения на сайте не затрагивают отправку запросов через postback.
• Более безопасный тип интеграции, т.к. в запросе есть приватный ключ авторизации. Кроме того, отправка запросов идет с заранее вам известных IP-адресов, и источник запросов можно проверить в любой момент по логам.
• Для реализации решения необходим доступ к серверной части сайта (back-end).
• При наличии мобильной версии сайта или мобильного приложения их также необходимо проинтегрировать.
• При наличии на сайте разных форм подачи заявок необходимо проинтегрировать их все.
• Postback-запрос отправляется непосредственно с вашего сервера, а не с клиентской стороны (браузер пользователя).
• Postback-запрос должен отправляться только для действий пользователей, пришедших от Admitad Affiliate. Для идентификации таких пользователей служит параметр admitad_uid.
  
  

Что такое admitad_uid. Механизм работы партнерской ссылки

В ходе работы с партнерской программой веб-мастер размещает на своей площадке её партнерскую ссылку. Партнерская ссылка генерируется на основании ссылки для перехода — ссылки, ведущей на сайт программы и содержащей необходимые Admitad Affiliate GET-параметры и utm-метки рекламодателя.

Один из GET-параметров обязательно должен передавать значение admitad_uid — уникального идентификатора, который генерируется на стороне Admitad Affiliate в момент перехода пользователя по ссылке. В admitad_uid хранится служебная информация о веб-мастере и источнике перехода, на основании которой система Admitad Affiliate распознает, кто из веб-мастеров привел пользователя на сайт и кому должны быть засчитаны его действия.

Пример ссылки для перехода:

https://site.ru/?admitad_uid={{admitad_uid}}

Значение admitad_uid необходимо получить из GET-параметра на входе пользователя на сайт и сохранить его на 90 дней в cookies. После авторизации пользователя при наличии cookie необходимо записать admitad_uid в базу данных и связать с личным кабинетом пользователя.

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

Cookie или срок ее жизни не должны изменяться при переходе из других бесплатных источников, таких как органический поиск или e-mail рассылка. Admitad Affiliate работает по модели атрибуции Last Paid Click, согласно которой действие должно засчитываться последнему платному источнику трафика.

Общая схема работы

Краткие шаги интеграции

1. Реализация алгоритма создания cookie и записи значения admitad_uid в нее.
2. Реализация алгоритма чтения admitad_uid из cookie и записи в базу данных при авторизации пользователя.
3. Реализация механизма отправки postback-запроса с вашего сервера (например, cURL, Wget, file_get_contents).
4. Написание функций для подстановки динамических значений в postback-запрос (например uid, order_id) и т.д.

Специального ответа сервера Admitad Affiliate на postback-запрос нет. Возвращается статус HTTP 200 OK.

Запись GET-параметра admitad_uid в cookies с помощью PHP

if (isset($_GET['admitad_uid'])) {
$days = 90;
setcookie('_aid', $_GET['admitad_uid'], time() + 60 * 60 * 24 * $days, '/');
}

function get_admitad_uid() {
if (!isset($_COOKIE[‘_aid’])) {
return null;
}
return $_COOKIE['_aid'];
} 

Настройка postback-запроса

Обязательные параметры

Пример postback-запроса

https://ad.admitad.com/r?campaign_code=constanta&postback=1&postback_key=constanta&action_code=1&
uid=&order_id=&tariff_code=1&price=1000&currency_code=RUB&payment_type=lead

Настройка передачи уникальных промокодов

Уникальные промокоды — промокоды, закрепленные за конкретным веб-мастером. Подробнее о них здесь.

Если вы намерены работать с уникальными промокодами:

1. Убедитесь, что в форме оформления заказа на сайте присутствует поле «Промокод».

2. Запишите уникальный промокод из формы оформления заказа в параметр promocode.

Пример postback-запроса для заказов с уникальным промокодом

https://ad.admitad.com/r?campaign_code=your_campaign_code&postback=1&postback_key=constanta
&action_code=1&uid=&order_id=&tariff_code=1&currency_code=RUB&price=50000
&payment_type=lead&promocode=admitad500

3. Убедитесь, что все заказы с уникальным промокодом отправляются в Admitad Affiliate.

В Admitad Affiliate заказ должен передаваться в следующих случаях:

• присутствует и admitad_uid, и уникальный промокод;
• присутствует только уникальный промокод;
• присутствует только admitad_uid.

В другие каналы информация о заказе с уникальным промокодом передаваться не должна.

Порядок тестирования 

1. После того как вы настроите алгоритм отправки postback-запросов с сервера, свяжитесь с отделом трекинга Admitad Affiliate и запросите партнерскую ссылку для тестирования.

2. Сделайте тестовые заказы. Убедитесь, что:

• admitad_uid обрабатывается на всех страницах сайта;
• admitad_uid сохраняется в cookie и в базу данных и привязывается к личному кабинету пользователя;
• срок жизни cookie с admitad_uid соответствует договору, cookie не удаляется при переходе пользователя через органический поиск;
• при выполнении целевого действия postback-запросы отправляются с вашего сервера, а не с клиентской стороны;
• запросы отправляются для всех целевых действий и тарифов вашей партнерской программы;
• отправляется запрос на каждую уникальную заявку (желательно настроить отсечение дублей);
• номер заявки передается корректно;
• трекинг настроен на мобильной версии сайта (если есть), и всех формах для подачи заявок.

3. Если трекинг настроен корректно, действия появятся в статистике Admitad Affiliate (Личный кабинет — «Статистика» — «По действиям»).

Сообщите техническому специалисту Admitad Affiliate, что тестирование прошло успешно. После этого программа будет поставлена на подготовку к запуску.

4. Если действие не появилось в статистике в течение часа, проблема либо в неверной реализации механизма отправки запроса, либо в неверных параметрах запроса. Убедитесь, что:

• вы не допустили ошибок при реализации механизма отправки postback-запросов;
• в запросе именно те campaign_code и postback_key, которые были вам отправлены в начале интеграции.

Чтобы выявить ошибку, перейдите в журнал запросов («Инструменты» — «Запросы на платеж»). Текст ошибки указан в поле «Результат». Исправьте ошибку и проведите повторный тест.  Инструкцию по разделу «Запросы на платеж» можно найти здесь.