# Postback

Keitaro принимает через postback события о совершенных конверсиях.

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

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

Для получения Postback для партнерской сети, читайте страницу Postback партнерской сети.

  1. Откройте Обслуживание → Postback URL.

  2. Скопируйте Postback URL.

# Параметры Postback

  • subid (обязательный). Subid клика.
  • tid. Transaction ID.
  • 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 поддерживает следующие статусы:

  • lead — Лид. Выплата еще не подтверждена.
  • sale — Продажа. Выплата подтверждена.
  • rejected — Отмена конверсии. Выплата отменена.
  • rebill — дополнительная продажа. Смотрите Допродажи.

# Переходы между статусами

  • Из lead в sale.
  • Из lead в rejected.
  • Из sale в rejected.
  • Из rebill в rejected.

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

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

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

Передавайте эти параметры, чтобы объяснить Keitaro, как трансформировать полученный status.

  • sale_status.
  • lead_status.
  • rejected_status.

Пример:

&lead_status=reg,topup&sale_status=billed&rejected=canceled,fake
1
  • Трансформирует reg и topup в lead.
  • Трансформирует billed в sale.
  • Трансформирует canceled и fake в reajected.

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

# Допродажи

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

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

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

Передавайте валюту в параметре currency. Пример:

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

# Postback FAQ

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

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

Как сделать postback pixel

Пример:

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

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

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

Обычно партнерские сети не отправляют настоящий subid в тестовых postback. По этой причине Keitaro не может их принять.

Что такое Postback Key?

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

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

postback_key = "CUSTOM_KEY"
1