Postback — механизм отправки данных о событиях (создание, подтверждение, аннулирование конверсий) в системе посредством GET или POST запросов.
Postback позволяет синхронизировать данные о транзакции из партнерской сети со сторонней системой анализа трафика web-мастера.
Чаще всего применяются, если площадка web-мастера представляет собой cashback-сервис, с которым как раз и нужно синхронизировать статус транзакции, для дальнейшей выплаты кэшбека пользователю.
После совершения целевого действия пользователем на сайте (регистрации, покупки и т.д.) или изменения статуса конверсии, в зависимости от настройки Postback-a, партнерская программа должна вызвать указанную при настройках ссылку с необходимыми параметрами или данными, в зависимости от настройки.
Постбеки отправляются с прокси 5.182.6.7, если у вас есть whitelist, то в него необходимо добавить адрес этого сервера.
Для настройки Postback-ов необходимо заполнить следующий поля:
Тип целевого действия: Выбирите нужный тип целевого действия или оставьте Неизвестно
Поле | Значение |
|---|---|
Площадки | Выбор площадок, для событий которых будут отправлены запросы. |
Офферы | Выбор оффера, для отправки запроса. |
Тип целевого действия |
Выберите, для каких целевых действий будет отправляться постбек: Оставить пустым — постбек отправляется по всем конверсиям. Конкретные действия — постбек отправляется только по выбранным типам действий. Вы можете выбрать одно или несколько целевых действий из списка. Если вы не уверены, оставьте выбор 'пустым'. |
События | Тип событий в системе для которых могут быть отправлены запросы. |
Конверсия создана | Конверсия была создана и ей существование в базе клиента было подтверждено. Комиссия web-мастера по правилам системы рассчитана. |
Конверсия подтверждена и закончился HOLD | Конверсия подтверждена клиентом, комиссия будет выплачена web-мастеру. Это конечный статус, который не может быть изменен в автоматическом режиме. |
Конверсия подтверждена и находится в HOLD | Конверсия подтверждена клиентом, комиссия будет выплачена web-мастеру после завершения HOLD. |
Конверсия аннулирована | Заказ был аннулирован клиентом, комиссия НЕ будет выплачена web-мастеру. Это конечный статус, который не может быть изменен в автоматическом режиме. |
Метод HTTP запроса | |
GET | Применяется для передачи данных заданному ресурсу с использованием дополнительных параметров url адреса. |
POST | Применяется для передачи данных заданному ресурсу в теле запроса. |
Postback URL | Url-адрес ресурса куда должны быть переданы данные. |
Content-Type | Пример: |
plain | cid=$CLICK_ID$ &id=$CONVERSION_ID$ |
json | {
"clickId": "$CLICK_ID$",
"conversionId": "$CONVERSION_ID$",
"conversionSum": "$CONVERSION_SUM$"
} |
xml | <xml version="1.0" encoding="UTF-8"> <clickId>$CLICK_ID$ </clickId> <conversionSum>$CONVERSION_SUM$ </conversionSum> <conversionId>$CONVERSION_ID$ </conversionId> |
Тело запроса | Тело запроса с использованием макросов |
Макросы
Для настройки Postback используются макросы — специальные переменные, которые подставляются в URL или Тело запроса, и при отправке будут заменены на соответствующие значения:
Про параметры Sub и ClickID
GET параметр sub предназначен для разделения трафика внутри площадки. Например, для обозначения, разделения разных типов баннеров на сайте или деления по менеджерам. Имеет ограничение в 100 символов для одного sub.
GET параметр clickid предназначен для фиксации информации о клике от внешних сервисов. В основном используется внешними сервисами для начисления комиссии внутри системы. Например, к партнерской программе подключается кэшбек сервис, к каждому переходу в url добавляет уникальное значение clickid. После совершения конверсии пользователем, кэшбек сервис получит Postback с информацией по сумме заказа и значению clickid при переходе. По значению clickid кэшбэк сервис внутри своей системы определят информацию о пользователе, который совершил переход, дате и времени перехода. По значению суммы заказа рассчитывается сумма вознаграждения пользователя.
Логирование Postback
Для того чтобы скачать лог Postback-а, необходимо зайти в раздел Инструменты - Постбэки.
Далее необходимо скопировать id Postback-а, нажать кнопку "скачать лог". В открывшемся окне вставляем id, выбираем требуемый период, формат файла и нажимаем кнопку "скачать".