# Postback

Чтобы Keitaro записал конверсию в статистику, трекер должен принять входящий Postback с собственным subid клика. Postback, в зависимости от типа настройки и схемы, отправляется:

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

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

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

# Получение Postback URL

Postback URL - это ссылка на которую владелец оффера (рекламодатель, партнерская сеть) передает данные о факте совершения конверсии и дополнительную информацию в виде параметров (сумма выплаты, статус и другие)

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

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

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

# Параметры Postback

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

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

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

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

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

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

# Трансформация статусов

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

  • sale_status.
  • lead_status.
  • rejected_status.

Пример:

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

status=new&lead_status=new,reg&sale_status=billed&rejected=canceled,fake
1

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

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

status=billed&lead_status=reg,new&sale_status=billed&rejected=canceled,fake
1

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

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

# Допродажи

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

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

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

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

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

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

# Postback FAQ

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

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

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

Пример:

<img src="%%POSTBACK_URL%%?status=lead&payout=10&currency=usd" width="1" height="1" />
1
Как Keitaro конвертирует валюту?

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

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

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

Postback Key

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

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

postback_key = "CUSTOM_KEY"
1