---
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/en/llms.txt
# Postback Sending Errors
When a postback sending error occurs, first [check the information in the tracker](#quick) — it will help you quickly form a preliminary hypothesis about the cause of the problem. To confirm the hypothesis and perform a deep analysis, use the [postback export](#full).
## Quick Preliminary Diagnostics in the Tracker {#quick}
1. Open the list of trackers: in the section menu, select **Tracking** → **Tracker List**.
1. Enable the filter **Postback Sending** → **With Errors**.
{% cut "Set filter" %}
{style="border: solid 1px #cccccc; max-width: 800px;"}
{% endcut %}
1. Click on the row — you will go to the tracker with an error mark.
In the tracker, look at the error codes that occur when sending postbacks, as well as an example of one of the most frequently encountered response bodies (`response_body`) for this tracker. This will help you quickly determine the most likely cause of the problem.
{% cut "Tracker with postback configuration error" %}
{style="border: solid 1px #cccccc; max-width: 400px;"}
{% endcut %}
Example of response body:
`{"StoreId":"","AppId":"","Message":"malformed clickId","Status":400,"EvType":0,"IsAttributed":1}`
For example:
- `malformed clickId` — may indicate that the `click_id` parameter is missing or is passed in an incorrect format;
- `timeout` or `5xx` errors — may indicate temporary unavailability of the partner's server;
- `400` errors — may indicate incorrect filling of individual parameters.
At this stage, you can form a preliminary hypothesis about the cause of the error.
From the tracker list, you can also copy the tracking URL or go to the [Conversions](https://appmetrica.yandex.com.tr/docs/en/mobile-reports/conversions-report.md) report.
{% cut "Actions in tracker list" %}
{style="border: solid 1px #cccccc; max-width: 600px;"}
{% endcut %}
## Checking the Full Picture via Postback Export {#full}
To confirm the hypothesis and perform a deeper diagnosis, go to the **Export** → **Postbacks** section.
Postback export allows you to:
- check if the same error occurs in all postbacks;
- understand if there are several different types of errors;
- determine if the problem is constant or occurs only in part of the requests.
### Exporting Postbacks {#export}
To export sent postbacks:
1. In the AppMetrica interface, click **Data export** → **Save to file**.
1. Go to the **Postbacks** tab.
1. In the list of fields for export, check:
- `response_code`
- `response_body`
- if necessary — `postback_url`, `postback_url_parameters`
1. In the filters, specify the tracker number or name.
1. Download the export file.
{% cut "Exporting postbacks" %}
{style="border: solid 1px #cccccc; max-width: 800px;"}
{% endcut %}
Analyze the `response_code` and `response_body` fields together with the request parameters.
You can also export postback sending logs [using the API](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/request-procedure.md).
### Analyzing Exported Postbacks {#analyze}
When analyzing postbacks with errors, check:
- the `postback_url` field;
- the passed parameters;
- the presence of required values.
For example, with a `malformed clickId` error, you can additionally check:
- whether the `click_id` parameter is passed;
- whether its value is filled;
- whether the format meets the partner's requirements.
## Resolving Errors {#solve}
### 4xx — Request Error {#4xx}
An error with code 4xx means that the partner's server received the request but rejected it.
Common causes of the error:
- missing required parameter;
- incorrect parameter value passed;
- incorrect data format;
- unsupported HTTP method used.
What you can do:
- If `response_body` indicates a specific problem (e.g., missing parameter) — fix the postback settings.
- If the cause is not obvious — [contact support](https://appmetrica.yandex.com.tr/docs/en/troubleshooting/feedback-new.md) AppMetrica, attaching an example of the request and response.
### 5xx — Partner-Side Error {#5xx}
An error with code 5xx means that the request was formed correctly, but the partner's server could not process it.
Possible causes of the error:
- temporary technical problems;
- server overload;
- internal error in the partner's system.
What you can do:
- Check if the error occurs massively and for a long time.
- Contact the partner with examples of errors, specifying `response_code`, `response_body` and the time of postback sending.
### Timeouts and Network Errors {#network}
Network errors and timeouts occur if the partner's server did not respond within the established time or the connection was not established.
Possible causes of the error:
- technical problems with the partner;
- IP address blocking;
- unstable network operation.
What you can do:
- Check the frequency of the error.
- Clarify with the partner the presence of restrictions or technical problems.
- If necessary, [contact support](https://appmetrica.yandex.com.tr/docs/en/troubleshooting/feedback-new.md) AppMetrica.
### Other Error Codes {#other}
Other error codes (1xxx, 6xxx, 9xx) relate to specific settings of the partner's server. To find out the cause of such responses to postbacks, contact the partner or AppMetrica support for clarification.
## What to Do Next {#final}
After analysis, you can preliminarily determine the possible cause of the problem by comparing the error code and response body with the partner's documentation.
If the cause looks clear:
- you can adjust the tracker parameters;
- update the postback URL;
- check parameter passing in the deeplink.
If the cause remains unclear:
- it is worth contacting the advertising partner's support;
- or AppMetrica support, attaching error examples and `response_body`.
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.
Contact support
Suggest an improvement for documentation