Настройка автосверки через postback

  • Обновлено

Принцип работы автосверки через postback схож с автосверкой через XML, но в данном случае сервер рекламодателя сам отправляет запрос с данными об обработанных действиях серверу Admitad Affiliate. Такой способ считается более защищенным и потому популярен среди финансовых программ.

О том, что такое «сверка» и «автосверка», читайте в этой статье.

При автосверке через postback данные в статистике Admitad Affiliate обновляются оперативнее, поскольку запрос отправляется в момент изменения статуса действия или каждые 2-3 часа (в зависимости от настроек автосверки), а не раз в день как при сверке через XML.
Сверять можно только заказы, находящиеся в ожидании на момент сверки.

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

Сверять заказы можно 2 способами:

Сверка через подпись запроса

Этот способ удобен тем, что не требуется указывать IP-адрес. Он подойдет вам, если у вас динамический диапазон IP-адресов.

Для подписи запроса на сверку используется HMAC-SHA1 алгоритм для campaign_code и order_id (ваш номер программы и номер заказа одной строкой без пробелов и спец.символов). Все строки должны быть в utf-8. Пример на Python 3.7.2/2.7 (IPython)

In [16]: import hmac 

In [17]: import hashlib 

In [18]: campaign_code = u'campaign_code'.encode('utf-8') 

In [19]: order_id = u'my_order_id_here'.encode('utf-8') 

In [20]: revision_secret_key = u'0123456789acbdef'.encode('utf-8')
 
In [22]: revision_sign = hmac.new(revision_secret_key, campaign_code + order_id, hashlib.sha1).hexdigest() 

In [23]: print(revision_sign) '01ae14a1c4ef90e6ce48c65525833e3f8a1f0228' 

In [24]:

 

Необходимые параметры

Значения параметров campaign_code и revision_secret_key вы получите от сотрудников отдела трекинга в процессе настройки автосверки.

  • campaign_code — код программы (строка, 10 символов);
  • revision_secret_key — секретный ключ для сверки через запросы (строка, 40 символов);
  • revision_sign — выходная подпись (см. пример выше);
  • order_id — номер заказа (строка, 1-100 символов)
  • status — статус заказа, может принимать значения:
    • pending — ожидает
    • approved — одобрен
    • declined — отклонен
  • amount — сумма заказа (дробное число, разделитель точка);
  • reward — вознаграждение веб-мастера (в виде дробного числа, в качестве разделителя точка);
  • comment — комментарий к заказу, в нем обязательно указывать причину отклонения (строка, 0-30 символов).
     

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

https://ad.admitad.com/rp?campaign_code=8f803552ea&
revision_sign=01ae14a1c4ef90e6ce48c65525833e3f8a1f0228&order_id=&status=&comment=

 

Сверка через ключ и IP-адрес

Необходимые параметры

Значения параметров campaign_code и revision_key вы получите от сотрудников отдела трекинга в процессе настройки автосверки. Сообщите IP-адрес или список адресов, с которых будут приходить запросы.

  • campaign_code — код программы (строка, 10 символов);
  • revision_key — ключ авторизации для сверки через запросы (строка, 32 символа);
  • order_id — номер заказа (строка, 1-100 символов)
  • status — статус заказа, может принимать значения:
    • pending — ожидает
    • approved — одобрен
    • declined — отклонён
  • amount — сумма заказа (дробное число, разделитель точка);
  • reward — вознаграждение веб-мастера (в виде дробного числа, в качестве разделителя точка);
  • comment — комментарий к заказу, в нем обязательно указывать причину отклонения (строка, 0-30 символов).
     

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

https://ad.admitad.com/rp?campaign_code=8f803552ea&
revision_key=3b9e06d28835AA872AE9cb6fc1186d1E&order_id=&status=&comment=

 

Тестирование

По окончании настройки обязательно проводится тестирование. Сотрудники Admitad Affiliate  делают два тестовых заказа, вы должны подтвердить один из них, изменив сумму заказа, а второй отклонить с комментарием. Если данные загрузились корректно: к соответствующим заказам, статусы верные, сумма заказа скорректирована, присутствует комментарий — тестирование считается успешным, и сотрудники отдела трекинга запускают автосверку.

 

Уведомления об ошибках

При отправке запроса в качестве ответа приходит JSON с результатами валидации запроса:

  • в случае успеха {"success":true}, "message": "request is processing". Статус говорит о том, что запрос прошел предварительную валидацию, но может быть отклонен на внутренней проверке.
  • в случае отклонения запроса {"errors":["length revision_key must be no more than 32"],"success":false}, в errors будут указаны причины отклонения.

По возможности настройте на своей стороне уведомление на ответ, содержащий {“errors”} с логированием этих ответов. Если ошибки начнут появляться, сообщите вашему менеджеру в Admitad Affiliate.

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