При интеграции через 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, согласно которой действие должно засчитываться последнему платному источнику трафика.
Общая схема работы
Краткие шаги интеграции
- Реализация алгоритма создания cookie и записи значения admitad_uid в нее.
- Реализация алгоритма чтения admitad_uid из cookie и записи в базу данных при авторизации пользователя.
- Реализация механизма отправки postback-запроса с вашего сервера (например, cURL, Wget, file_get_contents).
- Написание функций для подстановки динамических значений в 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
|
campaign_code | код программы | строка, 10 символов | константа, значение определено в postback-запросе, отправленном вам в начале интеграции |
order_id, oid |
ваш внутренний id заявки | строка, 1-100 символов |
ваш внутренний id заявки Важно! Убедитесь, что сможете найти в своей CRM заявку по этому id, так как по нему в дальнейшем будет проводиться сверка. |
action_code, ac, product, product_code |
код целевого действия | целое число | переменная, значение сообщает специалист отдела трекинга в начале интеграции |
tariff_code, tc | код тарифа | целое число | переменная, значение сообщает специалист отдела трекинга в начале интеграции |
payment_type | тип целевого действия | строка, 4 символа | константа, значение sale/lead |
postback, pb | ключ для авторизации postback-запроса | строка, 1 символ | константа, значение 1 |
postback_key, postback_hash, pk | ключ идентификации postback-запроса | строка, 32 символа | константа, значение определено в postback-запросе, отправленном вам в начале интеграции |
Обязательные параметры при работе с процентным вознаграждением: | |||
price, cart, p, amount | оплаченная сумма за весь заказ | целое или дробное число | |
currency_code, currency, 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¤cy_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¤cy_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, которые были вам отправлены в начале интеграции.
Чтобы выявить ошибку, перейдите в журнал запросов («Инструменты» — «Запросы на платеж»). Текст ошибки указан в поле «Результат». Исправьте ошибку и проведите повторный тест. Инструкцию по разделу «Запросы на платеж» можно найти здесь.