Data types for export

App installations [installation]

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,installation_id,certificate_verification_status,install_datetime,install_ipv6,install_receive_datetime,install_receive_timestamp,install_timestamp,is_reattribution,is_reinstallation,match_type,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,windows_aid,huawei_oaid,app_build_number,app_package_name,app_version_name

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

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

app_installer

The name of the app install source package determined by the getInstallSourceInfo method.

Device and OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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

huawei_oaid

The device's Huawei OAID 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.

App events [event]

Available fields:

android_id,app_build_number,app_package_name,app_version_name,application_id,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,event_datetime,event_json,event_name,event_receive_datetime,event_receive_timestamp,event_timestamp,google_aid,installation_id,testids,certificate_verification_status,ios_ifa,ios_ifv,mcc,mnc,operator_name,original_device_model,os_name,os_version,profile_id,session_id,session_type,windows_aid,huawei_oaid

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.

session_type

Session type. Possible values: foreground | background.

installation_id

Installation ID.

testids

Array of numeric IDs of experiment variants.

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 OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

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.

huawei_oaid

The device's Huawei OAID 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.

Push tokens [push_token]

Available fields:

token,token_datetime,token_receive_datetime,token_receive_timestamp,token_timestamp,session_id,session_type,installation_id,certificate_verification_status,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,profile_id,windows_aid,huawei_oaid,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.

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_type

Session type. Possible values: foreground | background.

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 OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

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.

huawei_oaid

The device's Huawei OAID 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 [crash]

Available fields:

crash,crash_datetime,crash_group_id,crash_id,crash_name,crash_receive_datetime,crash_receive_timestamp,crash_timestamp,session_id,session_type,installation_id,certificate_verification_status,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,profile_id,windows_aid,huawei_oaid,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.

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_type

Session type. Possible values: foreground | background.

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 OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

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.

huawei_oaid

The device's Huawei OAID 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 [error]

Available fields:

error,error_datetime,error_id,error_name,error_receive_datetime,error_receive_timestamp,error_timestamp,session_id,session_type,installation_id,certificate_verification_status,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,profile_id,windows_aid,huawei_oaid,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.

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_type

Session type. Possible values: foreground | background.

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 OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

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.

huawei_oaid

The device's Huawei OAID 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 start [session_start]

Available fields:

session_id,session_type,session_start_datetime,session_start_receive_datetime,session_start_receive_timestamp,session_start_timestamp,installation_id,certificate_verification_status,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,original_device_model,os_name,os_version,profile_id,windows_aid,huawei_oaid,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_type

Session type. Possible values: foreground | background.

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.

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 OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

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.

huawei_oaid

The device's Huawei OAID 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.

Session end [session_end]

Available fields:

session_id,session_type,session_end_datetime,session_end_receive_datetime,session_end_receive_timestamp,session_end_timestamp,installation_id,certificate_verification_status,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,original_device_model,os_name,os_version,profile_id,windows_aid,huawei_oaid,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_type

Session type. Possible values: foreground | background.

session_end_datetime

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

session_end_receive_datetime

Time when the server receives the session end message, 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_end_receive_timestamp

Time when the server receives the session end message, in Unix time format. It may differ from session_timestamp due to network delays or problems with the user's internet connection.

session_end_timestamp

Time of the session end in Unix time format.

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 OS information

Field

Description

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

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.

huawei_oaid

The device's Huawei OAID 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.

Clicks and impressions [click]

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,country,district,area,city,country_iso_code,device_type,device_model,device_manufacturer,os_version,os_name,windows_aid,huawei_oaid,google_aid,ios_ifv,ios_ifa

Data about tracking clicks and impressions

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.

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

country_iso_code

ISO country code.

device_type

The device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.

device_model

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

device_manufacturer

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

os_version

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

os_name

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

windows_aid

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

huawei_oaid

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

google_aid

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

ios_ifv

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

ios_ifa

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

Revenue [revenue]

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,certificate_verification_status,android_id,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,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.

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 OS information

Field

Description

android_id

Android device ID.

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

Purchases [ecommerce]

You can export data that was sent with the reportECommerce method call (see details for Android and iOS). A single reportECommerce call can be represented as multiple events in export (see the ecom_type field).

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_name,event_receive_datetime,event_receive_timestamp,event_timestamp,session_id,installation_id,certificate_verification_status,android_id,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,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

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 OS information

Field

Description

android_id

Android device ID.

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

Ad Revenue [ad_revenue]

Available fields:

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,certificate_verification_status,android_id,appmetrica_device_id,appmetrica_sdk_version,country,district,area,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,event_source,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 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.

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

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 OS information

Field

Description

android_id

Android device ID.

appmetrica_device_id

A unique device identifier detected by the AppMetrica service.

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.

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
Previous
Next