Postback

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

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

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

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

1. Партнерской сетью или прямым рекламодателем.

2. Скриптами трекера (KClient PHP, Скрипт отслеживания), с сайтов на сторонних хостингах, если не работаете с партнерками и трафик идет напрямую на домен вашего сайта.

3. С помощью JS-Adapter c локальных сайтов, добавленных как архивы в трекер, или редирект сайтов. Настройка применима, если это личный сайт, а не сайт партнерской сети.

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

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

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

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

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

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

Параметры Postback

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

WARNING

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

TIP

Если subid уже записан в трекере, а в ссылке postback пришли отличные от предыдущей конверсии параметры, postback перезапишет предыдущую конверсию.

В случае полного совпадения пришедших параметров, последний postback обработается, но S2S postback не отправляется повторно.

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

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

• Lead — лид. Выплата еще не подтверждена. Доход по таким конверсиям отображается в метрике Доход(ожидаемый).
• Sale — продажа. Выплата подтверждена. Доход по таким конверсиям отображается в метрике Доход(подтвержденный).
• Rejected — отмена конверсии. Выплата отменена. Доход по таким конверсиям отображается в метрике Доход(отклоненный).
• Registration — регистрация. Доход по таким конверсиям отображается в метрике Доход(регистрация).
• Deposit — депозит. Доход по таким конверсиям отображается в метрике Доход(депозиты).
• Trash — нерелевантная конверсия. Доход по таким конверсиям отображается в метрике Доход(trash).
• Пользовательские типы конверсий — настройка расширяет возможности отслеживания рекламных кампаний, позволяя учитывать любые типы конверсий для более точного анализа статистики.

1. Обработка postback без указания status=:

Если в postback не передается статус конверсии, трекер автоматически игнорирует конверсию, в лог пишется соответствующая запись.

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

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

Обучение для статусов, не указанных в трекере

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

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

• lead_status
• sale_status
• rejected_status
• registration_status
• deposit_status
• trash_status
• custom*_status - где custom* необходимо заменить на параметр созданного пользовательского параметра.

Пример:

В списке статусов Партнерской сети регистрации указаны как new и registration. Исходя из доступных статусов конверсий Keitaro, для трекера регистрация — это Лид. Необходимо указать соответствующее обучение в ссылке postback, и при получении одного из статусов 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 записывается как Продажа.

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

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

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

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

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

Отправка postback с помощью postback pixel

Postback Pixel — это небольшой фрагмент кода, который вставляется в код страницы и отправляет информацию о конверсии с сайта в трекер. Подходит для написания пользовательского кода, передающего данные о конверсии при выполнении заданного действия.

1. Создайте лендинг или оффер локально либо с помощью предзагрузки. Подробности о требованиях к созданию лендингов и офферов смотрите на странице Лендинг: локальный.

2. Добавьте код Postback Pixel между тэгами <body>...</body> на index странице:

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

Вместо POSTBACK_URL впишите Postback URL, что находится в Обслуживание → Postback URL.

WARNING

Макрос {subid} в ссылке postback работает только на страницах index.html или index.php.

1. Создайте оффер или лендинг с действием редирект, в параметрах URL необходимо передавать subid={subid}:

2. Добавьте код Postback Pixel между тэгами <body>...</body> на странице и обработайте {subid}, переданное в параметре subid= в ссылке на сайт:

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

Cледующий скрипт служит примером обработчика {subid} с пикселем:

<script>
        document.addEventListener('DOMContentLoaded', () => {
            const urlParams = new URLSearchParams(window.location.search);
            const subid = urlParams.get('subid');
            const postbackUrl = `POSTBACK_URL?subid=${subid}&status=lead&payout=10&currency=usd`;
            document.getElementById('postback-pixel').src = postbackUrl;
        });
</script>

<img id="postback-pixel" src="" width="1" height="1" />

Вместо POSTBACK_URL впишите Postback URL, что находится в Обслуживание → Postback URL.

Postback FAQ

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

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

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

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

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

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

Postback Key

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

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

POSTBACK_KEY=CUSTOM_KEY

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

TRACKER_POSTBACK_KEY=CUSTOM_KEY

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

kctl tune