Postback sending errors
If an error occurs when sending a postback, first check the media source's response code and body — they contain the reason for the error.
Make an export of postbacks that were sent to the media source and analyze the fields:
-
response_code— contains the HTTP response code (400, 404, 500, etc.). -
response_body— contains the media source's error response text, which usually includes the error description.
To fix the error:
- Study the media source's service documentation — it should describe possible error codes and messages.
- Check and correct the postback settings (URL, method, parameters, signature).
- If the cause of the error remains unclear, contact support AppMetrica.
Exporting postbacks
To export sent postbacks:
-
In the AppMetrica interface, click Data export → Save to file.
-
Go to the Postbacks tab.
-
In the list of fields for export, select:
response_coderesponse_body- if necessary —
postback_url,postback_url_parameters
-
In the filters, specify:
response_code— error codes you want to analyze (for example, 400, 401, 404, 422, 500).
-
Download the export file.
-
Analyze the
response_bodyfield together with the request parameters.
You can also export postback sending logs using the API.
Troubleshooting errors
4xx — Request error
An error with code 4xx means that the media source's server received the request but rejected it.
Common causes of the error:
- missing required parameter;
- incorrect parameter value passed;
- invalid data format;
- unsupported HTTP method used.
What you can do:
-
If
response_bodyspecifies a specific problem (for example, missing parameter) — correct the postback settings. -
If the reason is not obvious — contact support AppMetrica, attaching an example request and response.
5xx — Partner-side error
An error with code 5xx means that the request was formed correctly, but the media source's server could not process it.
Possible causes of the error:
- temporary technical issues;
- server overload;
- internal media source system error.
What you can do:
-
Check if the error repeats massively and for a long time.
-
Contact the media source with error examples, specifying
response_code,response_bodyand the postback sending time.
If you need help analyzing logs — contact support AppMetrica.
Timeouts and network errors
Network errors and timeouts occur if the media source's server did not respond within the set time or the connection was not established.
Possible causes of the error:
- technical issues with the media source;
- IP address blocking;
- unstable network operation.
What you can do:
-
Check the frequency of the error.
-
Check with the media source about any restrictions or technical issues.
If necessary, contact support AppMetrica.
Other error codes
Other error codes (1xxx, 6xxx, 9xx) relate to specific media source server settings. To find out the reason for such responses to postbacks, contact the media source for clarification.
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.