Интеграция через 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, согласно которой действие должно засчитываться последнему платному источнику трафика.

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

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

 

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

  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-запроса

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

Имя параметра
(курсивом выделены алиасы)

Описание Тип Примечание
uid идентификатор Admitad Affiliate  строка

значение генерируемое, приходит на входе пользователя на сайт в параметре admitad_uid


Если вы разрешаете контекстную рекламу в своей программе, то в случаях, когда пользователи переходят по контекстным объявлениям Google Ads веб-мастеров, в параметр admitad_uid вместо значения uid записывается значение gclid, которое генерирует Google.

Чтобы трекинг действий работал корректно, ваш сервер должен принимать и передавать значение параметра gclid целиком. Подробнее о длине параметра gclid

campaign_code код программы строка, 10 символов константа, значение определено в postback-запросе, отправленном вам в начале интеграции

order_idoid

ваш внутренний id заявки строка, 1-100 символов

ваш внутренний id заявки

Важно! Убедитесь, что сможете найти в своей CRM заявку по этому id, так как по нему в дальнейшем будет проводиться сверка.

action_codeac, product, product_code

код целевого действия целое число переменная, значение сообщает специалист отдела трекинга в начале интеграции
tariff_codetc код тарифа целое число переменная, значение сообщает специалист отдела трекинга в начале интеграции
payment_type тип целевого действия строка, 4 символа константа, значение sale/lead
postbackpb ключ для авторизации postback-запроса строка, 1 символ константа, значение 1
postback_keypostback_hash, pk ключ идентификации postback-запроса строка, 32 символа константа, значение определено в postback-запросе, отправленном вам в начале интеграции
Обязательные параметры при работе с процентным вознаграждением:
pricecart, p, amount оплаченная сумма за весь заказ целое или дробное число  
currency_codecurrency, c код валюты строка, 3 символа alfa-3 определяется в ISO 4217 alfa-3; принимаются только буквенные значения

 

Пример 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.

Имя параметра Описание Тип
promocode код уникального промокода строка, 255 символов
Пример 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 (Личный кабинет — «Статистика» — «По действиям»).

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

 

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

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

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

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

Была ли эта статья полезной?