# Postback

Postback - это метод обратной связи в мире интернет-маркетинга и арбитража трафика. Термин обозначает HTTP-запрос, который отправляется с сервера рекламодателя (или партнерской сети/вашего сайта) на сервер трекера, чтобы сообщить о факте совершения конверсии. В контексте арбитража трафика и маркетинга, postback используется для передачи информации о действиях пользователей на сайте, таких как покупка товара, регистрация или выполнение другого целевого действия.

Чтобы Keitaro записал конверсию в статистику, необходимо найти клик на который должна записаться конверсию. За ID клика в трекере отвечает параметр subid, обязательный параметр postback'a.

В зависимости от схемы и настройки postback (конверсии) отправляются в трекер:

Партнерской сетью или прямым рекламодателем
Скриптами трекера (KClient PHP, Скрипт отслеживания), с сайтов на сторонних хостингах, если не работаете с партнерками и трафик идет напрямую на домен вашего сайта.
С помощью JS-Adapter c локальных сайтов, добавленных как архивы в трекер, или редирект сайтов. Настройка применима если это личный сайт, а не сайт партнерской сети.

# Обработка входящего Postback

Как Keitaro обрабатывает Postback?

# Получение Postback URL трекера

Postback URL - это ссылка на которую владелец оффера (рекламодатель, партнерская сеть) передает данные о факте совершения конверсии. Она содержит адрес сервера трекера, Postback key (уникальный идентификатор, который используется для безопасности и аутентификации запроса постбека), другие параметры: идентификатор клика (subid), статус конверсии, сумма покупки и другие данные, необходимые для отслеживания и анализа эффективности рекламных кампаний.

Получение Postback URL для партнерской сети описано в разделе Postback партнерской сети.

Для создания индивидуальной ссылки откройте Обслуживание → Postback URL.

Скопируйте Postback URL и добавьте необходимые параметры из раздела Параметры Postback.

# Параметры Postback

subid (обязательный). Subid клика трекера. Используется для понимания трекером на какой клик записать конверсию.
tid. ID транзакции. Идентификатор порядкового номера целевого действия. Например tid=2 означает второй депозит от одного игрока или покупку дополнительных материалов обучающих курсов человеком, уже купившим основной материал. Это признак дополнительной продажи.
payout (или revenue) Сумма выплаты по конверсии. Работает для положительных, и для отрицательных значений.
cost. Стоимость конверсии для CPA и RevShare модели расходов.
status (по умолчанию sale). Смотрите Статусы конверсии Keitaro.
currency. Валюта выплаты (usd, eur, rub, и т.д).
sub_id_1 - sub_id_30. Дополнительные свободные параметры для обновления параметров клика. Записываются любые строчные и цифровые значения.
return. Чтобы вернуть в ответе сообщение отправителю. Например &return=OK вернет OK, если конверсия принята.
sale_status, lead_status, rejected_status. Смотрите Другие статусы.
ignore_status. Список статусов, которые необходимо игнорировать. Пример, status=ping&ignore_status=ping,test.

WARNING

Допускается передача в постбеке параметров: keyword, cost, external_id, creative_id, ad_campaign_id и source, но полученные данные перезапишут значения, полученные от источника трафика с кликом.

# Статусы конверсии Keitaro

Keitaro поддерживает и отображает в отчетах следующие статусы:

lead — Лид. Выплата еще не подтверждена. Доход по таким конверсиям отображается в метрике Доход (ожид.).
sale — Продажа. Выплата подтверждена. Доход по таким конверсиям отображается в метрике Доход (подтв.).
rejected — Отмена конверсии. Выплата отменена. Доход по таким конверсиям отображается в метрике Доход (отказы).
rebill — Допродажа. Совершена новая транзакция на subid, который уже записан как Продажа. Например повторный депозит. При получении в постбеке уникального идентификатора транзакции в метке &tid=, трекер идентифицирует и выводит в отчеты такую конверсию как Допродажа. Доход по таким конверсиям суммируется в метрику Доход (подтв.), при условии что в настройках оффера включена Допродажа.

# Условия записи статуса Допродажа

Keitaro создает допродажи при выполнении следующих условий:

На subid клика в трекере уже записана конверсия со статусом Продажа.
В настройках оффера включены допродажи.
Получено уникальное значение в параметре tid.
Параметр status со значением sale или rebill.

Дополнительная информация по статусам

Обработка постбека без указания status=:

Если в постбеке не передается статус конверсии, трекер автоматически записывает конверсию как продажу.

Обработка новых статусов:

В случае, если в постбеке приходит новый статус, который не является известным для трекера, и трансформация статусов не указана в ссылке, трекер автоматически записывает конверсию как лид.

# Статусы reg и dep

TIP

Новые статусы конверсий доступны на версии трекера 10.3 и выше. Для активации функционала необходимо обновить версию трекера.

Для работы с iGaming клиентами доступны статусы Регистрация и Депозит, что позволяет параллельно вести учет регистраций и продаж (депозитов) не перезаписывая статус конверсии.

Для записи конверсий достаточно принять postback с соответствующими параметрами:

status=reg — регистрации. Доход по таким конверсиям отображается в метрике Доход (регистрация).
status=dep — депозит. Доход по таким конверсиям отображается в метрике Доход (депозит).

Для записи повторных депозитов обязательным условием является получение в параметре &tid= уникального значения ID транзакции в постбэке.

# Другие статусы

Другие статусы должны трансформироваться в статусы конверсий Keitaro.

Keitaro способен принять любой статус в параметре status= и записать как один из статусов конверсий Keitaro. Для реализации необходимо приравнять оригинальный статус конверсии к одному из базовых статусов трекера.

lead_status.
sale_status.
rejected_status.

Пример:

В списке статусов Партнерской сети регистрации указаны как new и registration. Исходя из доступных статусов конверсий Keitaro, для трекера регистрация — это Лид. Необходимо указать соответствующее обучение в ссылке постбека, и при получении одного из статусов new или registration, трекер запишет Лид.

status=new&lead_status=new,registration&sale_status=billed&rejected_status=canceled,fake

При получении конверсии с status=new или status=registration, она запишется трекером в отчеты как Лид, потому что это указано в ссылке status=new&lead_status=new,registration

Аналогично и для других статусов, например Продажа

status=billed&lead_status=registration,new&sale_status=billed&rejected_status=canceled,fake

Получив status=billed&sale_status=billed трекер понимает, что billed записывается как Продажа.

Оригинальный статус, который присылает партнерская сеть, хранится в колонке original_status у конверсии.

# Конвертация валюты

Трекер хранит статистику в одной валюте, указанной в Обслуживание - Настройки - Валюта. Передавайте валюту в Postback URL в параметре currency=, и трекер сконвертирует сумму выплаты постбека в валюту, указанную в настройках. Пример:

https://example.com/key/postback?status=lead&payout=10&currency=EUR

На данный момент Keitaro не хранит выплаты в разных валютах для каждой кампании отдельно. Валюта ведения статистики устанавливается на уровне трекера и трекер конвертирует сумму выплаты из валюты указанной в Postback URL.

# Postback FAQ

Почему я не вижу конверсий?

Смотрите Устрание проблем с postback

Как указать postback pixel

Пример:

<img src="POSTBACK_URL?subid={subid}&status=lead&payout=10&currency=usd" width="1" height="1" />

Как Keitaro конвертирует валюту?

Keitaro ежедневно дважды в сутки запрашивает котировки с внешнего сервиса.

Почему не работает тестирование постбека на стороне партнерской сети?

Партнерские сети не отправляют настоящий subid в тестовых postback. Что бы проверить настройку постбека необходимо самостоятельно совершить конверсию по ссылке кампании трекера.

Postback Key

Это уникальная строка, которая защищает трекер от подделанных Postback запросов.

Чтобы задать другой postback ключ, пропишите необходимый в конфиге /etc/keitaro/config/tracker.env:

POSTBACK_KEY=CUSTOM_KEY

Для трекера версии 10.2 и выше - в конфиге /etc/keitaro/env/inventory.env:

TRACKER_POSTBACK_KEY=CUSTOM_KEY

После запустите переконфигурацию системы

kctl tune

← Конверсии Как интегрировать партнерские сети в Keitaro →