Available endpoints

Tracking clicks and impressions

/logs/v1/export/clicks.{csv | json}

See detailed description of the resource in the reference.

Available fields:

application_id,click_datetime,click_id,click_ipv6,click_timestamp,click_url_parameters,click_user_agent,publisher_id,publisher_name,tracker_name,tracking_id,touch_type,is_bot,city,country_iso_code,device_manufacturer,device_model,device_type,google_aid,oaid,ios_ifa,ios_ifv,os_name,os_version,windows_aid

Tracking information

Field

Description

application_id

Unique numeric identifier for the application in AppMetrica.

click_datetime

Date and time of the click/impression in yyyy-mm-dd hh:mm:ss format.

click_id

ID of the click/impression or '' (an empty string if the ID is not available).

click_ipv6

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

click_timestamp

Time of the click/impression in Unix time format, in seconds.

click_url_parameters

Parameters as they are shown in the URL. Special characters must be escaped (for example, ?param1=1&param2=2... will look like ?param1%3D1%26param2%3D2... in the request).

click_user_agent

User-agent of the click/impression.

publisher_id

ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0.

publisher_name

Name of the AppMetrica partner. If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracker_name

Name of the tracker being added to the AppMetrica interface If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracking_id

ID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0.

touch_type

Type: click or impression. Possible values: click | impression | unknown.

is_bot

Indicates a non-browser click.

Device Information (based on click recognition)

Field

Description

city

The name of the city where the click was made (in English).

country_iso_code

ISO country code.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

oaid

The device's Huawei OAID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

windows_aid

The device's Windows AID in the format received from the device.

App installations

/logs/v1/export/installations.{csv | json}

See detailed description of the resource in the reference.

Available fields:

application_id, installation_id,attributed_touch_type,click_datetime,click_id,click_ipv6,click_timestamp,click_url_parameters,click_user_agent,profile_id,publisher_id,publisher_name,tracker_name,tracking_id,install_datetime,install_ipv6,install_receive_datetime,install_receive_timestamp,install_timestamp,is_reattribution,is_reinstallation,match_type,appmetrica_device_id,city,connection_type,country_iso_code,device_locale,device_manufacturer,device_model,device_type,google_aid,oaid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,windows_aid,app_package_name,app_version_name

Tracking information

Field

Description

application_id

Unique numeric identifier for the application in AppMetrica.

installation_id

Installation ID.

attributed_touch_type

Ad interaction type: click | impression | unknown.

click_datetime

Date and time of the click/impression in yyyy-mm-dd hh:mm:ss format.

click_id

ID of the click/impression or '' (an empty string if the ID is not available).

click_ipv6

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

click_timestamp

Time of the click/impression in Unix time format, in seconds.

click_url_parameters

Parameters as they are shown in the URL. Special characters must be escaped (for example, ?param1=1&param2=2... will look like ?param1%3D1%26param2%3D2... in the request).

click_user_agent

User-agent of the click/impression.

profile_id

User profile ID.

publisher_id

ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0.

publisher_name

Name of the AppMetrica partner. If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracker_name

Name of the tracker being added to the AppMetrica interface If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracking_id

ID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0.

Installation information

Field

Description

install_datetime

Date and time of the installation in yyyy-mm-dd hh:mm:ss.

install_ipv6

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

install_receive_datetime

Date and time when the install event was received on the server side. May differ from install_datetime due to network delays or if the user's device was not connected at the time of the event.

install_receive_timestamp

Time when the install event was received on the server side in Unix time format. May differ from install_timestamp due to network delays or if the user's device was not connected at the time of the event.

install_timestamp

Time of the installation in Unix time format, in seconds.

is_reattribution

Whether the installation is reattributed to the new source. Possible values: true | false.

is_reinstallation

Whether the app has been reinstalled. Possible values: true | false.

match_type

Attribution method: fingerprint | referrer | identifier | '' (empty string).

Device and operating system information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

oaid

The device's Huawei OAID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_package_name

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

app_version_name

The app version in the format specified by the developer.

Postbacks

/logs/v1/export/postbacks.{csv | json}

See detailed description of the resource in the reference.

Available fields:

application_id,attributed_touch_type,click_datetime,click_id,click_ipv6,click_timestamp,click_url_parameters,click_user_agent,profile_id,publisher_id,publisher_name,tracker_name,tracking_id,install_datetime,install_ipv6,install_timestamp,match_type,identifier,appmetrica_device_id,city,country_iso_code,device_locale,device_manufacturer,device_model,device_type,google_aid,oaid,ios_ifa,os_name,os_version,windows_aid,app_package_name,app_version_name,conversion_datetime,conversion_timestamp,event_name,attempt_datetime,attempt_timestamp,cost_model (postback_type),notifying_status,postback_url,postback_url_parameters,response_body,response_code

Tracking information

Field

Description

application_id

Unique numeric identifier for the application in AppMetrica.

attributed_touch_type

Ad interaction type: click | impression | unknown.

click_datetime

Date and time of the click/impression in yyyy-mm-dd hh:mm:ss format.

click_id

ID of the click/impression or '' (an empty string if the ID is not available).

click_ipv6

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

click_timestamp

Time of the click/impression in Unix time format, in seconds.

click_url_parameters

Parameters as they are shown in the URL. Special characters must be escaped (for example, ?param1=1&param2=2... will look like ?param1%3D1%26param2%3D2... in the request).

click_user_agent

User-agent of the click/impression.

profile_id

User profile ID.

publisher_id

ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0.

publisher_name

Name of the AppMetrica partner. If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracker_name

Name of the tracker being added to the AppMetrica interface If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracking_id

ID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0.

Installation and re-engagement information

Field

Description

install_datetime

Date and time of the installation in yyyy-mm-dd hh:mm:ss.

install_ipv6

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

install_timestamp

Time of the installation in Unix time format, in seconds.

match_type

Attribution method: fingerprint | referrer | identifier | '' (empty string).

identifier

'' (empty string).

Device Information (based on click recognition)

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

city

The name of the city where the click was made (in English).

country_iso_code

ISO country code.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

oaid

The device's Huawei OAID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_package_name

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

app_version_name

The app version in the format specified by the developer.

Event information

Field

Description

conversion_datetime

Date and time of the event (for CPA postback), installation (for CPI postback), or re-engagement (for CPR postback) in yyyy-mm-dd hh:mm:ss format.

conversion_timestamp

Time of the event (for CPA postback), installation (for CPI postback), or re-engagement (for CPR postback) in Unix time format.

event_name

Name of the event (as passed to the SDK).

Information about the postback

Field

Description

attempt_datetime

Date and time of sending in yyyy-mm-dd hh:mm:ss` format.

attempt_timestamp

Time of sending in Unix time format.

cost_model (postback_type)

Postback type. Possible values: cpi (installation) | cpa (event) | cpr (re-engagement).

notifying_status

The status of the postback sending (failed | sent). The same postback may appear multiple times in the response if sending failed.

postback_url

Full Postback URL.

postback_url_parameters

Postback URL parameters as shown in the URL. For example, param1=1&param2=2....

response_body

Data received from the server.

response_code

HTTP code for sending the postback.

Events

/logs/v1/export/events.{csv | json}

See detailed description of the resource in the reference.

Available fields:

event_datetime,event_json,event_name,event_receive_datetime,event_receive_timestamp,event_timestamp,session_id,installation_id,appmetrica_device_id,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,original_device_model,os_name,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name,application_id

Event and session information

Field

Description

event_datetime

Date and time of the event in yyyy-mm-dd hh:mm:ss format.

event_json

Event attributes serialized into JSON.

event_name

Name of the event (as passed to the SDK).

event_receive_datetime

Date and time the event was received on the server side. May differ from event_datetime due to network delays or if the user's device was not connected at the time of the event.

event_receive_timestamp

Time when the event was received on the server side in Unix time format. May differ from event_timestamp due to network delays or if the user's device was not connected at the time of the event.

event_timestamp

Time of the event in Unix time format.

With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than seven days. The API expects a value in seconds.

session_id

Session ID. The set of values installation_id, session_id and the platform device ID (google_aid / ios_ifa) allows you to uniquely identify a user's session.

installation_id

Installation ID.

Device and OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

original_device_model

Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

profile_id

User profile ID.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_build_number

App build number.

app_package_name

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

app_version_name

The app version in the format specified by the developer.

application_id

Unique numeric identifier for the application in AppMetrica.

E-commerce

/logs/v1/export/ecommerce_events.{csv | json}

See detailed description of the resource in the reference.

Available fields:

ecom_type,ecom_screen_name,ecom_screen_search_query,ecom_screen_payload,ecom_screen_category_path_1,ecom_screen_category_path_2,ecom_screen_category_path_3,ecom_screen_category_path_4,ecom_screen_category_path_5,ecom_screen_category_path_6,ecom_screen_category_path_7,ecom_screen_category_path_8,ecom_screen_category_path_9,ecom_screen_category_path_10,ecom_product_name,ecom_product_sku,ecom_product_promocodes,ecom_product_payload,ecom_product_category_path_1,ecom_product_category_path_2,ecom_product_category_path_3,ecom_product_category_path_4,ecom_product_category_path_5,ecom_product_category_path_6,ecom_product_category_path_7,ecom_product_category_path_8,ecom_product_category_path_9,ecom_product_category_path_10,ecom_product_actual_price_fiat_unit_type,ecom_product_actual_price_fiat_value,ecom_product_actual_price_internal_components,ecom_product_original_price_fiat_unit_type,ecom_product_original_price_fiat_value,ecom_product_original_price_internal_components,ecom_cart_item_price_fiat_unit_type,ecom_cart_item_price_fiat_value,ecom_cart_item_quantity,ecom_cart_item_internal_components,ecom_referrer_type,ecom_referrer_id,ecom_order_id,ecom_order_payload,event_datetime,event_json,event_name,event_receive_datetime,event_receive_timestamp,event_timestamp,session_id,installation_id,appmetrica_device_id,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,original_device_model,os_name,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name,application_id

Purchase details

Field

Description

ecom_type

Purchase event type. Possible values:

  • show_screen
  • show_product_card
  • show_product_details
  • add_cart_item
  • remove_cart_item
  • begin_checkout
  • purchase

ecom_screen_name

Screen name.

ecom_screen_search_query

Search query.

ecom_screen_payload

Screen parameters as passed to the SDK. The format is a JSON object with string key-value pairs, for example:

{
  "configuration": "landscape",
  "fullscreen": "true"
}

ecom_screen_category_path_1

Screen category. Level 1.

ecom_screen_category_path_2

Screen category. Level 2.

ecom_screen_category_path_3

Screen category. Level 3.

ecom_screen_category_path_4

Screen category. Level 4.

ecom_screen_category_path_5

Screen category. Level 5.

ecom_screen_category_path_6

Screen category. Level 6.

ecom_screen_category_path_7

Screen category. Level 7.

ecom_screen_category_path_8

Screen category. Level 8.

ecom_screen_category_path_9

Screen category. Level 9.

ecom_screen_category_path_10

Screen category. Level 10.

ecom_product_name

Product name.

ecom_product_sku

Product ID.

ecom_product_promocodes

Product promo codes. The format is a JSON array of strings, for example:

["BT79IYX", "UT5412EP"]

ecom_product_payload

Product parameters as passed to the SDK. The format is a JSON object with string key-value pairs, for example:

{
  "configuration": "landscape",
  "fullscreen": "true"
}

ecom_product_category_path_1

Product category. Level 1.

ecom_product_category_path_2

Product category. Level 2.

ecom_product_category_path_3

Product category. Level 3.

ecom_product_category_path_4

Product category. Level 4.

ecom_product_category_path_5

Product category. Level 5.

ecom_product_category_path_6

Product category. Level 6.

ecom_product_category_path_7

Product category. Level 7.

ecom_product_category_path_8

Product category. Level 8.

ecom_product_category_path_9

Product category. Level 9.

ecom_product_category_path_10

Product category. Level 10.

ecom_product_actual_price_fiat_unit_type

Currency of the actual product price.

ecom_product_actual_price_fiat_value

Actual product price.

ecom_product_actual_price_internal_components

Components of the actual product price. The format is an array of JSON objects with one key-value pair each, for example:

[
  { "wood": 25.01 },
  { "iron": 10 }
]

ecom_product_original_price_fiat_unit_type

Currency of the base product price.

ecom_product_original_price_fiat_value

Base product price.

ecom_product_original_price_internal_components

Components of the base product price. The format is an array of JSON objects with one key-value pair each, for example:

[
  { "wood": 25.01 },
  { "iron": 10 }
]

ecom_cart_item_price_fiat_unit_type

Price currency for the item in the cart.

ecom_cart_item_price_fiat_value

Price of the item in the cart.

ecom_cart_item_quantity

Number of items in the cart.

ecom_cart_item_internal_components

Price components for the item in the cart. The format is an array of JSON objects with one key-value pair each, for example:

[
  { "wood": 25.01 },
  { "iron": 10 }
]

ecom_referrer_type

Traffic source type.

ecom_referrer_id

Traffic source ID.

ecom_order_id

Purchase ID.

ecom_order_payload

Purchase parameters as passed to the SDK. The format is a JSON object with string key-value pairs, for example:

{
  "configuration": "landscape",
  "fullscreen": "true"
}

Event and session information

Field

Description

event_datetime

Date and time of the event in yyyy-mm-dd hh:mm:ss format.

event_name

Name of the event (as passed to the SDK).

event_receive_datetime

Date and time the event was received on the server side. May differ from event_datetime due to network delays or if the user's device was not connected at the time of the event.

event_receive_timestamp

Time when the event was received on the server side in Unix time format. May differ from event_timestamp due to network delays or if the user's device was not connected at the time of the event.

event_timestamp

Time of the event in Unix time format.

With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than seven days. The API expects a value in seconds.

session_id

Session ID. The set of values installation_id, session_id and the platform device ID (google_aid / ios_ifa) allows you to uniquely identify a user's session.

installation_id

Installation ID.

certificate_verification_status

Whether the certificate fingerprint of the app matches (the result of comparing the fingerprint uploaded via the Management API against the fingerprint associated with the event). It's used for event verification. Possible values:

  • unknown: Status is unknown.
  • valid: The signature has successfully passed the check.
  • invalid: The certificates do not match.
  • unsupported_operating_system: The operating system is other than Android.
  • empty_event_certificate: No certificate in the event.

Device and operating system information

Field

Description

android_id

Android device ID.

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

appmetrica_sdk_version

Version of the AppMetrica SDK.

country

The country name in English.

district

The federal district name in English.

area

The region name in English.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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 | unknown.

event_source

Event source: sdk | import_api | js | system.

event_datetime

Date and time of the event in yyyy-mm-dd hh:mm:ss format.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

original_device_model

Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).

os_version

The version of the operating system on the user's device.

profile_id

User profile ID.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_build_number

App build number.

app_package_name

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

app_version_name

The app version in the format specified by the developer.

Profiles

/logs/v1/export/profiles_v2.{csv | json}

See detailed description of the resource in the reference.

Available fields:

profile_id,appmetrica_gender,appmetrica_birth_date,appmetrica_notifications_enabled,appmetrica_name,<any attribute name>,appmetrica_crashes,appmetrica_errors,appmetrica_first_session_date,appmetrica_last_start_date,appmetrica_push_opens,appmetrica_push_send_count,appmetrica_sdk_version,appmetrica_sessions,android_id,appmetrica_device_id,city,connection_type,country_iso_code,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,windows_aid,app_build_number,app_framework,app_package_name,app_version_name

Information about user attributes

Field

Description

profile_id

User profile ID.

appmetrica_gender

Gender.

appmetrica_birth_date

Age.

appmetrica_notifications_enabled

Notifications are enabled.

appmetrica_name

Name.

<any attribute name>

Name of a custom attribute.

Information about system attributes

Field

Description

appmetrica_crashes

Number of crashes.

appmetrica_errors

Number of errors.

appmetrica_first_session_date

Date of the first session.

appmetrica_last_start_date

Date when the app was last launched.

appmetrica_push_opens

Number of opened push notifications.

appmetrica_push_send_count

Number of sent push notifications.

appmetrica_sdk_version

Version of the AppMetrica SDK.

appmetrica_sessions

Number of sessions.

Device and OS information

Field

Description

android_id

Android device ID.

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_build_number

App build number.

app_framework

Framework type.

Returns one of the following values:

  • "0": Native.
  • "1": Unity.
  • "2": Xamarin.
  • "3": React.
  • "4": Cordova.

app_package_name

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

app_version_name

The app version in the format specified by the developer.

Revenue

/logs/v1/export/revenue_events.{csv | json}

See detailed description of the resource in the reference.

Available fields:

revenue_quantity,revenue_price,revenue_currency,revenue_product_id,revenue_order_id,revenue_order_id_source,is_revenue_verified,is_revenue_autocollected,revenue_inapp_type,revenue_event_type,event_datetime,event_name,event_receive_datetime,event_receive_timestamp,event_timestamp,session_id,installation_id,android_id,appmetrica_device_id,appmetrica_sdk_version,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,event_datetime,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,original_device_model,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name

Revenue information

Field

Description

revenue_quantity

Quantity of products purchased.

revenue_price

Price. It can be negative, e.g. for refunds.

revenue_currency

Currency code of the purchase in ISO 4217 format.

revenue_product_id

Item ID.

revenue_order_id

Order ID.

revenue_order_id_source

Source of the order ID. Possible values: autogenerated | user_defined.

is_revenue_verified

The flag that indicates the purchase verification in the store. Possible values:

  • true: Verified.
  • false: Verified and rejected.
  • undefined: Unknown.

is_revenue_autocollected

The flag of In-App purchase automatic tracking. Possible values:

  • true: Collected automatically.
  • false: Sent manually.
  • undefined: Unknown.

revenue_inapp_type

Purchase or subscription interaction flag. Possible values:

  • one_time_purchase
  • subscription

revenue_event_type

Event subtype. Possible values:

  • one_time_purchase
  • trial_subscription_started
  • intro_subscription_started
  • promo_subscription_started
  • subscription_converted
  • subscription_started
  • subscription_renewed
  • subscription_cancelled
  • subscription_uncancelled
  • subscription_expired
  • subscription_billing_issues
  • refund
  • unknown

Event and session information

Field

Description

event_datetime

Date and time of the event in yyyy-mm-dd hh:mm:ss format.

event_name

Name of the event (as passed to the SDK).

event_receive_datetime

Date and time the event was received on the server side. May differ from event_datetime due to network delays or if the user's device was not connected at the time of the event.

event_receive_timestamp

Time when the event was received on the server side in Unix time format. May differ from event_timestamp due to network delays or if the user's device was not connected at the time of the event.

event_timestamp

Time of the event in Unix time format.

With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than seven days. The API expects a value in seconds.

session_id

Session ID. The set of values installation_id, session_id and the platform device ID (google_aid / ios_ifa) allows you to uniquely identify a user's session.

installation_id

Installation ID.

Device and OS information

Field

Description

android_id

Android device ID.

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

appmetrica_sdk_version

Version of the AppMetrica SDK.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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).

event_datetime

Date and time of the event in yyyy-mm-dd hh:mm:ss format.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

original_device_model

Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).

os_version

The version of the operating system on the user's device.

profile_id

User profile ID.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_build_number

App build number.

app_package_name

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

app_version_name

The app version in the format specified by the developer.

/logs/v1/export/deeplinks.{csv | json}

See detailed description of the resource in the reference.

Available fields:

deeplink_url_host,deeplink_url_parameters,deeplink_url_path,deeplink_url_scheme,event_datetime,event_receive_datetime,event_receive_timestamp,event_timestamp,is_reengagement,profile_id,publisher_id,publisher_name,session_id,tracker_name,tracking_id,android_id,appmetrica_device_id,appmetrica_sdk_version,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,event_datetime,google_aid,ios_ifa,ios_ifv,mcc,mnc,original_device_model,os_version,windows_aid,app_build_number,app_package_name,app_version_name

Tracking information

Field

Description

deeplink_url_host

Deeplink domain name. For example, for a link formatted as [scheme]:[//host][/path][?parameters], it returns host.

deeplink_url_parameters

Parameters that are passed to the deeplink. For more information about passing parameters, see Parameters of the tracking URL.

deeplink_url_path

URL path of the deeplink. For example, for a link formatted as [scheme]:[//host][/path][?parameters], it returns path.

deeplink_url_scheme

URL scheme of the deeplink. For example, for a link formatted as [scheme]:[//host][/path][?parameters], it returns scheme.

event_datetime

Date and time of the event in yyyy-mm-dd hh:mm:ss format.

event_receive_datetime

Date and time the event was received on the server side. May differ from event_datetime due to network delays or if the user's device was not connected at the time of the event.

event_receive_timestamp

Time when the event was received on the server side in Unix time format. May differ from event_timestamp due to network delays or if the user's device was not connected at the time of the event.

event_timestamp

Time of the event in Unix time format.

With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than seven days. The API expects a value in seconds.

is_reengagement

Indicates that the tracker was created for a remarketing campaign.

profile_id

User profile ID.

publisher_id

ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0.

publisher_name

Name of the AppMetrica partner. If unattributed postbacks are enabled for the tracker, the field value will be empty.

session_id

Session ID. The set of values installation_id, session_id and the platform device ID (google_aid / ios_ifa) allows you to uniquely identify a user's session.

tracker_name

Name of the tracker being added to the AppMetrica interface If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracking_id

ID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0.

Device and OS information

Field

Description

android_id

Android device ID.

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

appmetrica_sdk_version

Version of the AppMetrica SDK.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

original_device_model

Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).

os_version

The version of the operating system on the user's device.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_build_number

App build number.

app_package_name

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

app_version_name

The app version in the format specified by the developer.

Push tokens

/logs/v1/export/push_tokens.{csv | json}

See detailed description of the resource in the reference.

Available fields:

token,token_datetime,token_receive_datetime,token_receive_timestamp,token_timestamp,appmetrica_device_id,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,profile_id,windows_aid,app_package_name,app_version_name,application_id

Information about push tokens

Field

Description

token

Push token value.

token_datetime

Time of token creation in yyyy-mm-dd hh:mm:ss format.

token_receive_datetime

Time when the token was received on the server side in yyyy-mm-dd hh:mm:ss format. It may differ from token_datetime due to network delays or problems with the user's internet connection.

token_receive_timestamp

Time when the token was received on the server side in Unix time format. It may differ from token_datetime due to network delays or problems with the user's internet connection.

token_timestamp

Time of token creation in Unix time format.

Device and OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

profile_id

User profile ID.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_package_name

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

app_version_name

The app version in the format specified by the developer.

application_id

Unique numeric identifier for the application in AppMetrica.

Crashes

/logs/v1/export/crashes.{csv | json}

See detailed description of the resource in the reference.

Available fields:

crash,crash_datetime,crash_group_id,crash_id,crash_name,crash_receive_datetime,crash_receive_timestamp,crash_timestamp,appmetrica_device_id,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,profile_id,windows_aid,app_package_name,app_version_name,application_id

Information about an app crash

Field

Description

crash

Stack trace.

crash_datetime

Date and time of the app crash in yyyy-mm-dd hh:mm:ss format.

crash_group_id

ID of a group of similar crashes.

crash_id

Crash ID.

crash_name

Crash name.

crash_receive_datetime

Date and time the crash message was received on the server side in yyyy-mm-dd hh:mm:ss format. It may differ from crash_datetime due to network delays or problems with the user's internet connection

crash_receive_timestamp

Time when the crash message was received on the server side in Unix time format. It may differ from crash_timestamp due to network delays or problems with the user's internet connection.

crash_timestamp

Time of the app crash in Unix time format.

Device and OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

profile_id

User profile ID.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_package_name

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

app_version_name

The app version in the format specified by the developer.

application_id

Unique numeric identifier for the application in AppMetrica.

Errors

/logs/v1/export/errors.{csv | json}

See detailed description of the resource in the reference.

Available fields:

error,error_datetime,error_id,error_name,error_receive_datetime,error_receive_timestamp,error_timestamp,appmetrica_device_id,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,profile_id,windows_aid,app_package_name,app_version_name,application_id

Information about app errors

Field

Description

error

Error text.

error_datetime

Date and time of the error in yyyy-mm-dd hh:mm:ss format.

error_id

Error ID.

error_name

Error name.

error_receive_datetime

Time when the error message was received on the server side in yyyy-mm-dd hh:mm:ss format. It may differ from error_datetime due to network delays or problems with the user's internet connection.

error_receive_timestamp

Time when the error message was received on the server side in Unix time format. It may differ from error_timestamp due to network delays or problems with the user's internet connection.

error_timestamp

Time of the error in Unix time format.

Device and OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

profile_id

User profile ID.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_package_name

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

app_version_name

The app version in the format specified by the developer.

application_id

Unique numeric identifier for the application in AppMetrica.

Session starts

/logs/v1/export/sessions_starts.{csv | json}

See detailed description of the resource in the reference.

Available fields:

session_id,session_start_datetime,session_start_receive_datetime,session_start_receive_timestamp,session_start_timestamp,appmetrica_device_id,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name,application_id

Session information

Field

Description

session_id

Session ID. The set of values installation_id, session_id and the platform device ID (google_aid / ios_ifa) allows you to uniquely identify a user's session.

session_start_datetime

Date and time of the session start in yyyy-mm-dd hh:mm:ss format.

session_start_receive_datetime

Time when the session start message was received on the server side in yyyy-mm-dd hh:mm:ss format. It may differ from session_datetime due to network delays or problems with the user's internet connection.

session_start_receive_timestamp

Time when the session start message was received on the server side in Unix time format. It may differ from session_timestamp due to network delays or problems with the user's internet connection.

session_start_timestamp

Time of the session start in Unix time format.

Device and OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

original_device_model

Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

profile_id

User profile ID.

windows_aid

The device's Windows AID in the format received from the device.

Field

Description

app_build_number

App build number.

app_package_name

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

app_version_name

The app version in the format specified by the developer.

application_id

Unique numeric identifier for the application in AppMetrica.

Ad Revenue

/logs/v1/export/ad_revenue_events.{csv | json}
ad_revenue_datetime,ad_revenue_timestamp,ad_revenue_receive_datetime,ad_revenue_receive_timestamp,ad_revenue,ad_revenue_currency,ad_revenue_type,ad_revenue_data_source,ad_revenue_network,ad_revenue_placement_id,ad_revenue_placement_name,ad_revenue_unit_id,ad_revenue_unit_name,ad_revenue_precision,ad_revenue_payload,session_id,installation_id,android_id,appmetrica_device_id,appmetrica_sdk_version,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,original_device_model,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name

Ad Revenue information

Field

Description

ad_revenue_datetime

Date and time of the event in yyyy-mm-dd hh:mm:ss format.

ad_revenue_timestamp

Time of the event in UNIX timestamp format.

ad_revenue_receive_datetime

Date and time the event was received on the server side. May differ from ad_revenue_datetime due to network delays or if the user's device was not connected at the time of the event.

ad_revenue_receive_timestamp

Time when the event was received on the server side, in UNIX timestamp format. May differ from ad_revenue_timestamp due to network delays or if the user's device was not connected at the time of the event.

ad_revenue

Ad Revenue amount.

ad_revenue_currency

Ad Revenue currency.

ad_revenue_type

Ad Revenue type. Possible values:

  • native
  • banner
  • rewarded
  • interstitial
  • mrec
  • other

ad_revenue_data_source

Flag indicating that Ad Revenue was automatically collected. Possible values:

  • autocollected
  • manual

ad_revenue_network

Advertising Network.

ad_revenue_placement_id

Ad placement ID.

ad_revenue_placement_name

Ad placement name.

ad_revenue_unit_id

Ad unit ID.

ad_revenue_unit_name

Ad unit name.

ad_revenue_precision

Accuracy of the Ad Revenue amount (as passed to the SDK). For example, "publisher_defined" or "estimated".

ad_revenue_payload

Additional data serialized into JSON.

Event and session information

Field

Description

session_id

Session ID. The set of values installation_id, session_id and the platform device ID (google_aid / ios_ifa) allows you to uniquely identify a user's session.

installation_id

Installation ID.

Device and operating system information

Field

Description

android_id

Android device ID.

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

appmetrica_sdk_version

Version of the AppMetrica SDK.

city

The name of the city where the click was made (in English).

connection_type

Type of connection. Possible values: wifi | cell | unknown.

country_iso_code

ISO country code.

device_ipv6

The IP address at the time of the event in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

device_locale

The language on the device.

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 | unknown.

google_aid

The device's Google AID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

mcc

Mobile country code.

mnc

Mobile network code.

operator_name

Name of the mobile operator.

original_device_model

Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).

os_version

The version of the operating system on the user's device.

profile_id

User profile ID.

windows_aid

The device's Windows AID in the format received from the device.

App information

Field

Description

app_build_number

App build number.

app_package_name

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

app_version_name

The app version in the format specified by the developer.

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