Ошибки отправки постбеков

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

Быстрая предварительная диагностика в трекере

1. Откройте список трекеров: в меню разделов выберите Трекинг → Список трекеров.

2. Включите фильтр Отправка постбеков → С ошибками.

   Установленный фильтр

   

3. Нажмите на строку — вы перейдете в трекер с пометкой об ошибке.

В трекере посмотрите коды ошибок, возникающие при отправке постбеков, а также пример одного из наиболее часто встречающихся тел ответа (response_body) для данного трекера. Это поможет быстро определить наиболее вероятную причину проблемы.

Трекер с ошибкой настройки постбека

Пример тела ответа:

{"StoreId":"","AppId":"","Message":"malformed clickId","Status":400,"EvType":0,"IsAttributed":1}

Например:

• malformed clickId — может говорить о том, что параметр click_id отсутствует или передается в некорректном формате;
• timeout или 5xx ошибки — могут указывать на временную недоступность сервера партнера;
• 400 ошибки — могут указывать на некорректное заполнение отдельных параметров.

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

Из списка трекеров вы также можете скопировать tracking URL или перейти в отчет Конверсии.

Действия в списке трекеров

Проверка полной картины через экспорт постбеков

Для подтверждения гипотезы и более глубокой диагностики перейдите в раздел Экспорт → Постбеки.

Экспорт постбеков позволяет:

• проверить, одинаковая ли ошибка возникает во всех постбеках;
• понять, есть ли несколько разных типов ошибок;
• определить, проблема постоянная или возникает только в части запросов.

Выгрузка постбеков

Чтобы выгрузить отправленные постбеки:

1. В интерфейсе AppMetrica нажмите Экспорт данных → Сохранить в файл.
2. Перейдите на вкладку Постбеки.
3. В списке полей для выгрузки отметьте:
   • response_code
   • response_body
   • при необходимости — postback_url, postback_url_parameters
4. В фильтрах укажите номер или имя трекера.
5. Скачайте файл выгрузки.

Выгрузка постбеков

Проанализируйте поля response_code и response_body вместе с параметрами запроса.

Выгрузить логи отправки постбеков можно также с помощью API.

Анализ выгруженных постбеков

При анализе постбеков с ошибками проверьте:

• поле postback_url;
• передаваемые параметры;
• наличие обязательных значений.

Например, при ошибке malformed clickId можно дополнительно проверить:

• передается ли параметр click_id;
• заполнено ли его значение;
• соответствует ли формат требованиям партнера.

Устранение ошибок

4xx — ошибка запроса

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

Частые причины ошибки:

• отсутствует обязательный параметр;
• передано некорректное значение параметра;
• неверный формат данных;
• используется неподдерживаемый HTTP-метод.

Что можно сделать:

• Если в response_body указана конкретная проблема (например, отсутствующий параметр) — исправьте настройки постбека.
• Если причина неочевидна — обратитесь в поддержку AppMetrica, приложив пример запроса и ответа.

5xx — ошибка на стороне партнера

Ошибка с кодом 5xx означает, что запрос был сформирован корректно, но сервер партнера не смог его обработать.

Возможные причины ошибки:

• временные технические проблемы;
• сервер перегружен;
• внутренняя ошибка системы партнера.

Что можно сделать:

• Проверьте, повторяется ли ошибка массово и длительно.
• Обратитесь к партнеру с примерами ошибок, указав response_code, response_body и время отправки постбека.

Тайм-ауты и сетевые ошибки

Сетевые ошибки и тайм-ауты возникают, если сервер партнера не ответил в установленное время или соединение не было установлено.

Возможные причины ошибки:

• технические проблемы у партнера;
• блокировка IP-адреса;
• нестабильная работа сети.

Что можно сделать:

• Проверьте периодичность ошибки.
• Уточните у партнера наличие ограничений или технических проблем.
• При необходимости обратитесь в поддержку AppMetrica.

Другие коды ошибок

Другие коды ошибок (1xxx, 6xxx, 9xx) относятся к специфическим настройкам сервера партнера. Чтобы выяснить причину возникновения таких ответов на постбеки, обратитесь за разъяснением к партнеру или в поддержку AppMetrica.

Что делать дальше

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

Если причина выглядит однозначной:

• можно скорректировать параметры трекера;
• обновить postback URL;
• проверить передачу параметров в диплинке.

Если причина остается неясной:

• стоит обратиться в поддержку рекламного партнера;
• или в поддержку AppMetrica, приложив примеры ошибок и response_body.

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

Написать в службу поддержки Предложить улучшение для документации