# Postback
Keitaro принимает через postback события о совершенных конверсиях.
Как Keitaro обрабатывает Postback?
# Получение Postback URL
Для получения Postback для партнерской сети, читайте страницу Postback партнерской сети.
Откройте Обслуживание → Postback URL.
Скопируйте 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
- Трансформирует
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¤cy=EUR
# Postback FAQ
Почему я не вижу конверсий?
Смотрите Устрание проблем с postback
Как сделать postback pixel
Пример:
<img src="%%POSTBACK_URL%%?status=lead&payout=10¤cy=usd" width="1" height="1" />
Как Keitaro конвертирует валюту?
Keitaro ежедневно запрашивает котировки с внешнего сервиса.
Почему не работает тестирование постбека на стороне партнерской сети?
Обычно партнерские сети не отправляют настоящий subid в тестовых postback. По этой причине Keitaro не может их принять.
Что такое Postback Key?
Это уникальная строка, которая защищает трекер от подделанных Postback запросов.
Чтобы задать другой postback ключ, пропишите его в конфиге /var/www/keitaro/application/config/config.ini.php
:
postback_key = "CUSTOM_KEY"