Postback Not Firing? Чеклист из 12 пунктов для диагностики постбэков в Keitaro, Binom и Voluum

Postback not firing - самый тихий способ потерять деньги в арбитраже: сеть конверсию засчитала, оффер выплату провел, а в трекере оптимизировать нечего. Причина почти всегда механическая: где-то в круговом маршруте click ID не ушел, приехал битым или был отброшен на входе. Чеклист ниже проходит цепочку от самых дешевых проверок к логам и называет точные настройки и тексты ошибок для Keitaro, Binom и Voluum.

Postback not firing? Сначала карта цепочки

Прежде чем трогать настройки, посмотрите, как выглядит здоровый маршрут. Названия в трекерах отличаются, цепочка одна:

1. Источник трафика добавляет свой click ID в URL кампании, трекер его сохраняет (в Keitaro это {external_id}, в Voluum - {externalid}).
2. Трекер генерирует собственный click ID и подставляет его в URL оффера, чтобы сеть вернула его вместе с конверсией.
3. Конверсия случается, сеть вызывает postback URL трекера и передает этот click ID обратно.
4. Трекер записывает конверсию и, если настроено, отправляет дальше свой S2S postback в источник.

Обрыв возможен на любом стыке: ссылка не установлена, click ID не доехал до оффера, сеть вернула мусор, принимающая сторона отклонила запрос. Пункты 1-9 ниже закрывают входящую ветку, пункты 10-12 - исходящую. За слоем MMP и CAPI вокруг трекера следите по материалам tracking stack: MMP + трекер + CAPI и server-side delivery конверсий. Если цепочку еще только предстоит собрать, начните с настройки Keitaro postback для Facebook и TikTok.

Чеклист из 12 пунктов для диагностики постбэка

Считайте каждый случай postback not firing оборванным маршрутом и доказывайте стык за стыком, прежде чем двигаться дальше. Порядок намеренный: первые проверки убирают самые частые и самые глупые причины.

1. Postback URL сохранен там, где должен быть

Причина: ссылка не доехала до кабинета сети или до вкладки S2S. Это самая частая причина из всех.

Проверка: в Keitaro откройте Maintenance, затем Logs, затем Postbacks. Пустой лог при живом трафике обычно означает, что URL так и не установили на стороне сети.

Фикс: скопируйте URL из Settings, затем Postback URL, в поле постбэка сети. Для исходящей ветки кампании Keitaro нужен источник со S2S-ссылкой или запись на вкладке S2S Postbacks; в Binom S2S настраивается у источника трафика или в Advanced Settings кампании (настроены оба - уйдут оба).

2. URL, домен и ключ целы

Причина: сменился домен трекинга или протух ключ постбэка.

Проверка: Keitaro пишет Incorrect postback code, когда ключ в URL не совпадает с ключом из Settings, затем Postback URL. У Voluum воронка ломается на domain mismatch, если домен сменили, а click URL лендинга продолжает указывать на старый.

Фикс: заново скопируйте точный URL и держите один домен через всю воронку, включая click URL лендинга.

3. Click ID доехал до оффера

Причина: click ID трекера не попал в URL оффера, сети нечего возвращать.

Проверка: строка Requested в Traffic log показывает URL запуска кампании и то, какие параметры пришли пустыми. Ссылка оффера обязана нести токен трекера: sub1={clickid} для Binom, ?s2={clickid} для Voluum.

Фикс: добавьте токен в ссылку оффера и кликните воронку один раз, чтобы убедиться, что токен разворачивается в реальное значение.

offer link (Binom):  network.example/offer?sub1={clickid}
offer URL (Voluum):  network.example/offer?s2={clickid}

4. Click ID вернулся в постбэке

Причина: маппинг на стороне сети возвращает литерал или устаревшее значение вместо реального click ID.

Проверка: Keitaro пишет Click for subid ... not found, когда параметр subid приходит со значением, у которого нет ни одного клика. В Binom значение возвращается через cnv_id={sub1}, в Voluum - через cid=#s2#.

Фикс: поправьте маппинг в настройках постбэка сети так, чтобы токен сети, хранящий ваш click ID, подставлялся в параметр subid трекера. Случай postback not firing при корректном маппинге - проблема на стороне сети, об этом ниже.

5. Макросы и токены совпадают с сетью

Причина: плейсхолдер из шаблона остался как есть или использовано чужое имя токена.

Проверка: у каждой сети свои токены, а в шаблонах Voluum есть фрагменты REPLACE и OPTIONAL, которые нужно заменить на токены конкретной сети. Регистр важен: {clickid} и {clickId} - разные токены.

Фикс: замените каждый плейсхолдер на токены вашей сети, символ в символ.

6. URL-кодирование не ломает значения

Причина: пробелы и спецсимволы рвут цепочку параметров.

Проверка: пробел внутри значения превращается в %20 и разрывает параметры. Keitaro по умолчанию URL-кодирует значения плейсхолдеров; чтобы передать значение как есть, добавьте подчеркивание перед именем, например {_text}.

Фикс: убирайте пробелы на стороне источника или осознанно переходите на сырые плейсхолдеры.

7. Статус на месте и замаплен

Причина: запрос пришел без статуса или со статусом, которого трекер никогда не видел.

Проверка: Keitaro требует subid и status в каждом постбэке. Строка лога Error in stage: FindConversionType with message: Postback status is not set означает, что параметра нет; Conversion type not found - статус неизвестен. Если сеть шлет другие имена параметров (clickid, type, profit), обучите Keitaro алиасам в Settings, затем Postback URL, затем Parameters.

Фикс: создайте недостающий статус в Settings, затем Conversion types, либо обучите нестандартный статус в ссылке постбэка. Для исходящей ветки отметьте статусы отправки (Only with statuses) и перемапьте имена через {status:lead=0 sale=1 rejected=2}.

8. Значения выплаты корректны

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

Проверка: в постбэке Voluum payout=#price# берет динамическое значение, payout=0.6 - фиксированное. В Binom несколько постбэков на один clickid по умолчанию перезаписывают выплату последним значением; чекбокс Upsell у оффера включает суммирование.

Фикс: выберите одну конвенцию на оффер и включайте Upsell только там, где несколько постбэков на клик легитимны.

9. Дубли и перезаписи ведут себя предсказуемо

Причина: повторные постбэки выглядят потерянными, потому что система склеила их вместо того, чтобы добавить новые.

Проверка: в Keitaro повторный постбэк с тем же subid, но другими параметрами перезаписывает прошлую конверсию; при полном совпадении параметров конверсия обработается, но S2S наружу второй раз не уйдет. Повторы без перезаписи требуют tid - та же идея, что стоит за event_id для дедупликации событий рекламных платформ. В Binom disable_postback=1 в постбэк-URL молча отключает исходящий постбэк. Voluum отправляет один postback в источник на конверсию.

Фикс: определите правила дедупликации заранее и передавайте tid там, где повторы - реальные транзакции.

10. Принимающая сторона отвечает 2XX

Причина: постбэк ушел, но чужой сервер его отклонил.

Проверка: лог S2S postbacks в Keitaro показывает точный ответ источника по каждому subid, и ошибка в ответе - прямая улика. Если в стеке есть MMP, поле Postback HTTP Response Code в отчете делает ту же работу, а поле Original URL показывает, какие данные вообще были в click URL.

Фикс: ответ не 2XX - проблема на принимающем сервере; отдайте строку лога тому, кто отвечает за этот эндпоинт.

11. Ничто не блокирует запрос

Причина: запрос фильтрует white-list, тоггл или область отправки.

Проверка: Voluum отвечает Postback IP is not whitelisted, когда в элементе affiliate network включен прием только с белых IP, и пишет Postback sending error, когда не может доставить постбэк в источник. На слое MMP выключенный тоггл Activate partner останавливает атрибуцию и постбэки, а область This partner only плюс условия на событиях решают, кто вообще что получит.

Фикс: добавьте IP в white-list или отключите опцию, включите тоггл и сведите область событий с кампанией.

12. Запустите тестовую конверсию сами

Причина: все настроено, а работает ли канал, непонятно.

Проверка: в Voluum возьмите реальный click ID из Live events, затем Live visits, вставьте его в шаблон постбэк-URL вместо REPLACE и активируйте - появится тестовая конверсия; тестовый режим кампании прогоняет воронку без загрязнения отчетов. В Keitaro соберите постбэк-URL с реальным subid из Traffic log и известным статусом, откройте его и сверьте запись в Maintenance, затем Logs, затем Postbacks. В Binom кликните воронку и проверьте отчеты Leads и Conversions и вкладку Clicklog.

Фикс: случай postback not firing, при котором ручной тест проходит, а живой трафик - нет, сидит в разнице между этими двумя запросами.

Где живут логи в Keitaro, Binom и Voluum

Диагностика - это в основном чтение правильного лога. Прием из документации error log у Voluum: добавьте &param=NETWORKNAME к постбэк-URL сети, и лог ошибок назовет сеть, которая шлет битые запросы.

Когда постбэк не отправляется по дизайну

Если между сетью и трекером стоит MMP вроде AppsFlyer, несколько видов тишины задокументированы как нормальное поведение. Постбэки прекращаются после закрытия атрибуционного Postback Window; само событие при этом остается записанным. С Advanced Privacy на iOS 14.5 и старше пользователи без согласия не порождают user-level постбэки. Партнер без поддержки Advanced Privacy не получит и агрегированных. Выключенный тоггл Activate partner останавливает атрибуцию и постбэки; Audit log в Security center покажет, когда его переключили. Важна и область: This partner only против All media sources, including organic решает, кто вообще что получит, имена событий чувствительны к регистру, а условие на событии может отсечь отправку. Детали - в гайде AppsFlyer по диагностике постбэков для рекламодателей.

Когда случай postback not firing уходит в сеть

Половина каждого случая postback not firing сидит на стороне сети: их сервер собирает и отправляет запрос. Эскалируйте, когда маппинг в их кабинете совпадает с вашим трекером, а лог все еще показывает Click for subid ... not found с мусорными значениями: это документированное основание подключать сеть. То же самое работает, когда S2S-лог показывает ошибочный ответ источника. Приложите subid, точный постбэк-URL, время и ответ - тикет закроется за один круг вместо пяти.

Postback not firing: FAQ

Sources