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

При корректной настройке postback трекер запишет конверсию, которая появится в кампании трекера в Отчеты — Конверсии.

Если целевое действие на оффере совершено, но конверсии в трекере нет, необходимо выяснить в какой момент настройки возникла проблема и исправить ее.

Рассмотрим отдельно пути получения postback в трекер. Postback присылает либо рекламодатель / партнерская сеть, либо добавленный в код оффера скрипт, например JS адаптер.

# Postback присылает партнерская сеть

Рассмотрим схему работы отправки конверсий из партнерской сети в трекер:

  1. Клик приходит в трекер по ссылке кампании

  2. Трекер формирует идентификатор клика subid

  3. Клик совершает конверсию на оффере

  4. С помощью API партнерская сеть получает данные о факте конверсии и значение параметра клика трекера — subid

  5. Партнерская сеть отправляет postback в трекер по ссылке postback, которая добавлена в кабинете партнерской сети. В postback в трекер передается значение subid обратно, чтобы трекер определил по какому клику записать конверсию.

Если запись конверсии не произошла, следовательно на каком—то шаге возникла проблема.

Проверим, верно ли настроена передача subid клика на оффер партнерской сети:

# Если оффер установлен в трекере локально, загружен архивом

На локальный оффер трекер передает subid автоматически по ссылке кампании. Если перед оффером установлен лендинг в потоке кампании, убедитесь, что переход с лендинга на оффер настроен корректно.

Чтобы партнерская сеть получила значение subid, необходимо добавить в код формы заявки оффера следующую строку:

<input type="hidden" name="sub1" value="{subid}" />
1

Где sub1 необходимо заменить на параметр, в который партнерская сеть сможет принять значение клика трекера. Параметр индивидуален для каждой партнерской сети, поэтому стоит уточнить, какой параметр используется в системе.

Подробнее о передаче конверсий по API в партнерские сети.

# Если оффер установлен в трекере по редиректу, установлена ссылка на оффер

Передача параметра subid должна производиться в ссылку оффера. Настройку возможно произвести двумя путями:

При добавлении созданного шаблона к офферу происходит автоматическая передача параметров из поля шаблона Параметры оффера в ссылку оффера и добавлять параметры к ссылке вручную не требуется.

  • Если работа выстроена без шаблона, то необходимо вписать в URL оффера параметры вручную.

Если настройка корректна, перейдите к проверке лога postback в Обслуживание → Логи → Postbacks.

# Исправление ошибок в логе

# Ошибка Incorrect subid "". Postback ignored. или SubID not found

Данные ошибки говорят, что партнерская сеть в postback не передала реальное значение subid клика Keitaro. Поэтому трекер не записал конверсию в статистику.

Проверьте, что в ссылке postback на стороне партнерской сети верно указана передача параметра клика из системы партнера в трекер: subid={sub1}, где sub1 — параметр, в который партнерская сеть приняла значение клика трекера из subid.

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

# Ошибка Incorrect postback code

Ошибки такого вида говорят о том, что в ссылке postback не указан верный postback key трекера.

Для решения проблемы необходимо проверить ключ трекера в Обслуживание → Postback URL и заменить значение ключа в ссылке postback на стороне партнерской сети.

# В Обслуживание → Логи → Postbacks записей нет

Убедитесь, что в поле Postback в личном кабинете партнерской сети установлена ссылка postback трекера. Для проверки действующего ключа перейдите в раздел трекера Обслуживание → Postback URL.

# Если отправка postback настроена с помощью скриптов из кода оффера

Скрипт отправит postback с конверсией в трекер по факту перехода клика по ссылке кампании на страницу с установленным скриптом.

Если конверсия не записывается, проверьте настройку по следующим пунктам:

  1. Проверьте, что на страницу, с которой настроена отправка postback, передается значение subid. Используйте инструкцию для проверки передачи в код локальной страницы или на ссылку страницы.

  2. Убедитесь, что заменили ссылку postback в скрипте на ссылку трекера из раздела Обслуживание — Postback URL

Пример скрипта из документации:

<?php
file_get_contents('POSTBACK_URL/postback?subid=' . $_COOKIE['subid'] . '&status=lead');
?>
1
2
3

Готовый вариант для вставки в код страницы:

<?php
file_get_contents('https://demo-en.keitaro.io/f1ec56f/postback?subid=' . $_COOKIE['subid'] . '&status=lead');
?>
1
2
3
  1. Проверьте раздел Обслуживание → Логи → Postbacks.

Ошибка Click for subid not found возникает по причинам:

  • на страницу со скриптом не передано значение subid;
  • другие скрипты в коде страницы затирают значение.

Необходимо проверить настройку и исключить факторы, влияющие на передачу subid в скрипт отправки postback.

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