Documentation

Parameters of the postback URL

The details of postback support in AppMetrica are described below.

General information

AppMetrica allows defining postbacks for the tracker and specifying when to send the postback. AppMetrica supports a postback about app installation ("install postback") and a postback about a specified app event that occurred after installation ("event postback").

The following rules apply:

  • The postback is sent when the specified event or installation attribution appears. There is about a 5-minute delay when sending.
  • When the HTTP status 200 OK is received, it is considered successfully sent.
  • If a different HTTP status is received, AppMetrica resends the postback over the next 24 hours. Resending is repeated every 5-10 minutes.
  • An event postback is sent for events that occur within 6 months after installation.

Transmitting tracking URL parameters

AppMetrica allows passing any tracking URL parameters to the postback URL. In the postback URL, specify the parameter name from the tracking URL in curly brackets: {parameter_name}.

For example, the following parameters are transmitted in the tracking URL:

https://redirect.appmetrica.yandex.com/serve/123456?custom_parameter=value1&another_param=value2

To pass the value1 and value2 parameters to the postback URL, write:

https://endpoint.myadnetwork.com?some_parameter={custom_parameter}&another_param={another_param}

List of postback URL macros

AppMetrica supports a list of system macros that can be used in the postback URL. This list contains macros for information about the device, click, and app. If AppMetrica can't determine the parameter value for a macro, the parameter will be empty.

Information about click attributes

{click_id} — The unique click ID.

{match_type} — How the click was associated with the installation. Possible values: [referrer, fingerprint, identifier].

{transaction_id} — ID of this occurrence of the event or installation. For example, if the same device generates the same event, transaction_id changes.

{click_user_agent} — User-agent of the click.

{click_datetime}UTC date and time of the click in RFC3339 format.

{click_timestamp} — Time of the click in UNIX timestamp format, in seconds.

{click_timezone} — Time zone of the click as the difference from UTC in seconds.

{click_ipv6} — IP address at the time of the click, in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

{conversion_datetime} — UTC date and time of conversion (event on the device) in RFC3339 format.

{conversion_timestamp} — Time of conversion (event on the device) in UNIX timestamp format, in seconds.

{conversion_timezone} — The time zone (user's location) for conversion. Formatted as the difference from UTC time in seconds.

{conversion_event_name} — Name of the event for registering the conversion.

{conversion_event_json} — Nested event attributes in JSON format.

{install_datetime} — UTC date and time of installation in RFC3339 format.

{install_timestamp} — Time of installation in UNIX timestamp format, in seconds.

{install_timezone} — Time zone (user's location) for the installation. Formatted as the difference from UTC time in seconds.

{install_ipv6} — The IP address at the time of installation, in IPv6 format (for example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147).

Device information

{limit_ad_tracking} — Ad tracking is restricted on the device. It can take the values: 1 if the user disabled ad identification; 0 if the user didn't disable it.

{google_aid} — The device's Google AID in the format it was received from the device in.

{ios_ifa} — The device's IFA in the format it was received from the device in.

{ios_ifv} — IFV for the device in the format it was received from the device in.

{windows_aid} — Windows AID in the format it was received from the device in.

{device_manufacturer} — The device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).

{device_model} — The device model detected by the AppMetrica service (for example, Galaxy S6).

{device_type} — The device type detected by the AppMetrica service. Possible values: [PHONE, TABLET, PHABLET, TV].

{device_locale} — The language on the device.

{os_name} — ios | android | windows.

{os_version} — The version of the operating system on the user's device.

Information about the app and the OS

{app_version_name} — The app version in the format specified by the developer.

{app_package_name} — The package name for Android or the Bundle ID for iOS (for example, ru.yandex.metro).