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

Was the article helpful?

Quick start

Limits