Parameters of the tracking URL

This section describes the structure and parameters of the AppMetrica tracking URL.

  1. Structure
  2. Parameters
  3. Sending parameters to the postback URL, deeplink, and destination URL

Structure[tracking ID — The ID of the tracker]

Example: — The main domain currently in use. Possible variations:


The tracking URL can contain predefined parameters that are required for tracking to work. The advertising system (the AppMetrica partner) must transmit specific values via these parameters. To simplify this process, AppMetrica provides macros of various media sources for substituting in parameters. For example:

AppMetrica stores macros-params corresponding to Partner A:

  • click_id — {transaction_id}
  • google_aid — {GAID}

The resulting tracking URL for Partner A:{transaction_id}&google_aid={GAID}

The user must provide this tracking URL to Partner A. Tracking will begin automatically.


Parameters are divided into categories: required, recommended, and optional. Note that there are additional parameters for S2S calls.


click_id={YOURMACRO}& — Macro for transmitting a unique click ID. Used for deduplication.


Parameters for more exact counts of installations.

google_aid={YOURMACRO}& — Google AID, in the format that it was received from the device in.

google_aid_sha1={YOURMACRO}& — SHA1 hash of Google AID.

google_aid_md5={YOURMACRO}& — MD5 hash of Google AID.

ios_ifa={YOURMACRO}& — IFA, in the format that it was received from the device in.

ios_ifa_sha1={YOURMACRO}& — SHA1 hash of IFA.

ios_ifa_md5={YOURMACRO}& — MD5 hash of IFA.

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

windows_aid_sha1={YOURMACRO}& — SHA1 hash of Windows AID.

windows_aid_md5={YOURMACRO}& — MD5 hash of Windows AID.

Parameters for S2S calls

device_ip={YOURMACRO}& — The device's URL-encoded IP address. IPv4 and IPv6 are supported.

device_ua={YOURMACRO}& — The device's URL-encoded User-Agent.

click_timestamp={YOURMACRO}& — UTC timestamp of the click in seconds.

noredirect={YOURMACRO}& — Notifies AppMetrica that the click should be counted without redirection to the app store. The default value is 1.

For more information about s2s integration, see S2S integration.


Parameters for campaign optimization. The transmitted parameters are displayed in the Traffic sources report in a tree view.

afpub_id={YOURMACRO}& — ID of an affiliated publisher (sub-partner).

site_id={YOURMACRO}& — ID of a specific advertising place.

creative_id={YOURMACRO}& — ID of a specific banner.

appmetrica_js_redirect=0& — Disables JavaScript redirects.

Custom parameters

For better campaign optimization, the advertiser and advertising network can transmit additional parameters in the tracking URL.

To send custom parameters, add them to the tracking URL. There are multiple ways to transmit values using these parameters:

  • Manually — Enter the parameter value:

  • Automatically — Use macros for automatic substitution on the advertising network's side:


All parameters listed in the tracking URL will be shown in the Traffic sources report in a tree view.


You can use these examples for testing — replace the macros with your own. Delete any unnecessary, unsupported, or optional parameters as needed.

Copied to clipboard
Copied to clipboard

Sending parameters to the postback URL, deeplink, and destination URL

To pass a parameter value from the tracking URL to the postback URL, deeplink, or destination URL, add the parameter name to their URLs in curly brackets: {custom_parameter}. Any parameters can be transmitted this way — custom or pre-defined.

Note. If you use the Universal link as a tracking URL, the parameters are automatically passed to deeplink.

Examples of transmitting parameters:

To the destination URL

To add a macro to transmit, edit the destination URL in the tracker settings: