Логи постбэков: как искать ошибки

Конверсия есть в трекере рекламодателя, но не появилась в кабинете сети. Или наоборот: сеть конверсию приняла, а вебмастер её не видит. Обе ситуации разбираются одним способом — по логу постбэков. Это журнал, в котором платформа фиксирует каждый S2S-запрос о конверсии: когда отправлен, с какими параметрами и что ответила принимающая сторона. Вместо переписки наугад — конкретная запись, которая показывает, где передача оборвалась.

Что в логе

В записи лога четыре опорных поля: время и идентификатор конверсии, полный URL с параметрами, код ответа HTTP и сообщение об ошибке, если принимающая сторона отказалась записывать конверсию.

Читать запись разумно в таком порядке: код ответа, затем URL, затем сообщение. Код сразу делит причины на три группы — запрос не дошёл, дошёл, но отклонён, дошёл, но упал на принимающем сервере. URL показывает, подставился ли идентификатор клика и на месте ли параметры: одна из частых причин потери — пустой click_id в ссылке, а не сама сеть.

В Recca логи постбэков входят в кабинет CPA-сети, а формат постбека совместим с конвенцией Affise — шаблон ссылки с макросами выглядит привычно у тех, кто работал с зарубежной платформой. Подробно про настройку передачи — в разделе про S2S-постбэки.

Коды ответа

Код в логе — это ответ принимающего сервера. Значения стандартизированы и описаны в RFC 9110, поэтому трактуются одинаково у любой платформы.

200 OK — запрос принят, конверсия записана. Эту запись можно закрывать.

301, 302 и 307 — редирект: принимающая сторона уводит запрос на другой адрес. Редирект сам по себе не ошибка, но если принимающий скрипт ждёт параметры, а в новом адресе их нет, конверсия дойдёт без привязки к клику. Много 302 в логе при пустых конверсиях — повод сверить адрес постбека с документацией оффера.

400 Bad Request — запрос не разобран: потерян обязательный параметр или неверный формат. 403 Forbidden — сервер понял запрос, но отказал: обычно не сошлась подпись или запрос пришёл с незнакомого адреса. 404 Not Found — по адресу ничего нет: опечатка в URL постбека или отключённый оффер.

500, 502 и 503 — сбой на принимающем сервере. Отправитель здесь ни при чём, такие записи — кандидаты на повторную отправку. Если сводить к группам: 4xx — причина в самом запросе, 5xx — на приёмке.

Не дошло до сети

Симптом: конверсия есть в трекере рекламодателя, но её нет в кабинете сети. Сначала посмотрите, есть ли запись в логе постбэков сети.

Записи нет — запрос не приходил: рекламодатель не отправил постбэк, отправил на другой адрес или вызов не добрался до сервера. Со стороны сети это не лечится: сверяйте шаблон постбека рекламодателя с документацией оффера.

Запись есть — читайте код и URL. Пустой click_id в адресе: постбэк ушёл, но связать его с кликом сеть не сможет. 400 — потерян параметр или сломана подпись. 403 — сеть не узнала отправителя. 404 — оффер по этому адресу отключён или адрес неточный.

Ещё один маркер — время. Если постбэк пришёл значительно позже клика, привязка может не найтись: срок жизни клика в трекере ограничен, и конверсия запоздалого запроса повисает без владельца.

Не дошло до вебмастера

Второй участок — от сети к вебмастеру. Сеть конверсию приняла, а в кабинете или трекере вебмастера её нет. Здесь нужен лог исходящих постбэков сети.

Причины повторяются: неверный URL постбека в настройках вебмастера, его трекер отвечает ошибкой 5xx, в ссылке не подставился его идентификатор. Разница с первым участком в том, кто чинит: настройки постбека вебмастера правит сам вебмастер. Сеть может показать запись из лога — время, адрес и код ответа — и на этом её часть разбора заканчивается.

Не каждая конверсия, которой нет у вебмастера, потеряна. Постбэки уходят по статусам: конверсия на холде ещё не подтверждена, поэтому запись появится позже — после подтверждения или отклонения. Как это устроено в Recca — в разделе про холды и подтверждение конверсий.

Повтор

Повторная отправка уместна, когда отказ был на приёмке: ответы 5xx и таймауты. Записи с 400, 403 и 404 повторять бессмысленно: причина в самом запросе, и пока не исправлены адрес, параметры или ключи, ответ не изменится.

Повтор безопасен, если принимающая сторона различает дубли по идентификатору транзакции: повторный постбэк с тем же идентификатором не создаст вторую конверсию. Уверенности нет — переотправляйте небольшими партиями и сверяйте статистику после каждой.

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

Логи постбэков — рабочая часть тарифа «CPA-сеть» в Recca: журнал каждого запроса и коды ответов видны прямо в кабинете сети. Если выбираете платформу для своей CPA-сети, оставьте заявку на подключение — заявка на подключение CPA-сети.