---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://appmetrica.yandex.com.tr/docs/en/mobile-tracking/postback-errors.md
- https://appmetrica.yandex.com.tr/docs/ru/mobile-tracking/postback-errors.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com.tr/docs/ru/llms.txt
# Ошибки отправки постбеков
При возникновении ошибки отправки постбека сначала [проверьте информацию в трекере](#quick) — она поможет быстро сформировать предварительную гипотезу о причине проблемы. Для подтверждения гипотезы и глубокого анализа используйте [выгрузку постбеков](#full).
## Быстрая предварительная диагностика в трекере {#quick}
1. Откройте список трекеров: в меню разделов выберите **Трекинг** → **Список трекеров**.
1. Включите фильтр **Отправка постбеков** → **С ошибками**.
{% cut "Установленный фильтр" %}
{style="border: solid 1px #cccccc; max-width: 800px;"}
{% endcut %}
1. Нажмите на строку — вы перейдете в трекер с пометкой об ошибке.
В трекере посмотрите коды ошибок, возникающие при отправке постбеков, а также пример одного из наиболее часто встречающихся тел ответа (`response_body`) для данного трекера. Это поможет быстро определить наиболее вероятную причину проблемы.
{% cut "Трекер с ошибкой настройки постбека" %}
{style="border: solid 1px #cccccc; max-width: 400px;"}
{% endcut %}
Пример тела ответа:
`{"StoreId":"","AppId":"","Message":"malformed clickId","Status":400,"EvType":0,"IsAttributed":1}`
Например:
- `malformed clickId` — может говорить о том, что параметр `click_id` отсутствует или передается в некорректном формате;
- `timeout` или `5xx` ошибки — могут указывать на временную недоступность сервера партнера;
- `400` ошибки — могут указывать на некорректное заполнение отдельных параметров.
На этом этапе вы можете сформировать предварительную гипотезу о причине ошибки.
Из списка трекеров вы также можете скопировать tracking URL или перейти в отчет [Конверсии](https://appmetrica.yandex.com.tr/docs/ru/mobile-reports/conversions-report.md).
{% cut "Действия в списке трекеров" %}
{style="border: solid 1px #cccccc; max-width: 600px;"}
{% endcut %}
## Проверка полной картины через экспорт постбеков {#full}
Для подтверждения гипотезы и более глубокой диагностики перейдите в раздел **Экспорт** → **Постбеки**.
Экспорт постбеков позволяет:
- проверить, одинаковая ли ошибка возникает во всех постбеках;
- понять, есть ли несколько разных типов ошибок;
- определить, проблема постоянная или возникает только в части запросов.
### Выгрузка постбеков {#export}
Чтобы выгрузить отправленные постбеки:
1. В интерфейсе AppMetrica нажмите **Экспорт данных** → **Сохранить в файл**.
1. Перейдите на вкладку **Постбеки**.
1. В списке полей для выгрузки отметьте:
- `response_code`
- `response_body`
- при необходимости — `postback_url`, `postback_url_parameters`
1. В фильтрах укажите номер или имя трекера.
1. Скачайте файл выгрузки.
{% cut "Выгрузка постбеков" %}
{style="border: solid 1px #cccccc; max-width: 800px;"}
{% endcut %}
Проанализируйте поля `response_code` и `response_body` вместе с параметрами запроса.
Выгрузить логи отправки постбеков можно также [с помощью API](https://appmetrica.yandex.com.tr/docs/ru/mobile-api/logs/request-procedure.md).
### Анализ выгруженных постбеков {#analyze}
При анализе постбеков с ошибками проверьте:
- поле `postback_url`;
- передаваемые параметры;
- наличие обязательных значений.
Например, при ошибке `malformed clickId` можно дополнительно проверить:
- передается ли параметр `click_id`;
- заполнено ли его значение;
- соответствует ли формат требованиям партнера.
## Устранение ошибок {#solve}
### 4xx — ошибка запроса {#4xx}
Ошибка с кодом 4xx означает, что сервер партнера получил запрос, но отклонил его.
Частые причины ошибки:
- отсутствует обязательный параметр;
- передано некорректное значение параметра;
- неверный формат данных;
- используется неподдерживаемый HTTP-метод.
Что можно сделать:
- Если в `response_body` указана конкретная проблема (например, отсутствующий параметр) — исправьте настройки постбека.
- Если причина неочевидна — [обратитесь в поддержку](https://appmetrica.yandex.com.tr/docs/ru/troubleshooting/feedback-new.md) AppMetrica, приложив пример запроса и ответа.
### 5xx — ошибка на стороне партнера {#5xx}
Ошибка с кодом 5xx означает, что запрос был сформирован корректно, но сервер партнера не смог его обработать.
Возможные причины ошибки:
- временные технические проблемы;
- сервер перегружен;
- внутренняя ошибка системы партнера.
Что можно сделать:
- Проверьте, повторяется ли ошибка массово и длительно.
- Обратитесь к партнеру с примерами ошибок, указав `response_code`, `response_body` и время отправки постбека.
### Тайм-ауты и сетевые ошибки {#network}
Сетевые ошибки и тайм-ауты возникают, если сервер партнера не ответил в установленное время или соединение не было установлено.
Возможные причины ошибки:
- технические проблемы у партнера;
- блокировка IP-адреса;
- нестабильная работа сети.
Что можно сделать:
- Проверьте периодичность ошибки.
- Уточните у партнера наличие ограничений или технических проблем.
- При необходимости [обратитесь в поддержку](https://appmetrica.yandex.com.tr/docs/ru/troubleshooting/feedback-new.md) AppMetrica.
### Другие коды ошибок {#other}
Другие коды ошибок (1xxx, 6xxx, 9xx) относятся к специфическим настройкам сервера партнера. Чтобы выяснить причину возникновения таких ответов на постбеки, обратитесь за разъяснением к партнеру или в поддержку AppMetrica.
## Что делать дальше {#final}
После анализа можно предварительно определить возможную причину проблемы, сопоставив код ошибки и тело ответа с документацией партнера.
Если причина выглядит однозначной:
- можно скорректировать параметры трекера;
- обновить postback URL;
- проверить передачу параметров в диплинке.
Если причина остается неясной:
- стоит обратиться в поддержку рекламного партнера;
- или в поддержку AppMetrica, приложив примеры ошибок и `response_body`.
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.
Написать в службу поддержки
Предложить улучшение для документации