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,fraud_status,version,sign,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
`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.
`publisher_id`	ID of the AppMetrica publisher.
`publisher_name`	Name of the AppMetrica partner.
`tracker_name`	Name of the tracker being added to the AppMetrica interface.
`tracking_id`	ID of the AppMetrica tracker.

Installation information

Field	Description
`app_installer`	The name of the app install source package determined by the getInstallSourceInfo method.
`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. Acceptable 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.
`fraud_status`	The fraud assessment for installations by trackers with the anti-fraud option enabled. Possible values: `ok` \| `low` \| `mid` \| `high` \| `unknown`. Initially, all installations have the `unknown` value, but after analysis by FraudScore, the installations will reappear in the export with the updated `fraud_status` value. See the descriptions of the `version` and `sign` fields.
`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.
`installation_id`	Installation ID.
`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).
`sign`	Numeric indicator of adding or removing an installation. Possible values: `1` and `-1`. This field allows you to count the actual number of installations on the stream when `version` is updated, for this you need to sum the `sign` values. For example, one installation update with a `fraud_status` change will be represented by three entries in the export, and the sum of `sign` equals 1 (one real installation): `installation_id sign version fraud_status 0c08ef45-...-fc43f0c989c3 1 1 unknown 0c08ef45-...-fc43f0c989c3 -1 1 unknown 0c08ef45-...-fc43f0c989c3 1 2 high`
`version`	The numeric version number of the installation. In the export stream, the same installation can occur several times with the same `installation_id`, but with updated values of other fields. The installation with the highest `version` contains the actual data.

Device and OS information

Field	Description
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`area`	The region name in English.
`city`	The name of the city in English.
`connection_type`	Type of connection. Possible values: `wifi` \| `cell` \| `unknown`.
`country`	The country name in English.
`country_iso_code`	ISO country code.
`device_locale`	The language on the device.
`device_manufacturer`	The device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
`device_model`	The device model detected by the AppMetrica service (for example, Galaxy S6).
`device_type`	The device type detected by the AppMetrica service. Possible values: `phone` \| `tablet` \| `unknown`.
`district`	The federal district name in English.
`google_aid`	The device's Google AID in the format received from the device.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`os_name`	Operating system on the user's device: `ios` \| `android` \| `windows`.
`os_version`	The version of the operating system on the user's device.
`profile_id`	User profile ID.
`windows_aid`	The device's Windows AID in the format received from the device.

App information

Field	Description
`app_build_number`	App build number.
`app_package_name`	The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
`app_version_name`	The app version in the format specified by the developer.
`application_id`	Unique numeric identifier for the application in AppMetrica.

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
`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. Acceptable 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.
`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.

Device and OS information

Field	Description
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`area`	The region name in English.
`city`	The name of the city in English.
`connection_type`	Type of connection. Possible values: `wifi` \| `cell` \| `unknown`.
`country`	The country name in English.
`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`.
`district`	The federal district name in English.
`event_source`	Event source: `sdk` \| `import_api` \| `js` \| `system`.
`google_aid`	The device's Google AID in the format received from the device.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`original_device_model`	Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).
`os_name`	Operating system on the user's device: `ios` \| `android` \| `windows`.
`os_version`	The version of the operating system on the user's device.
`profile_id`	User profile ID.
`windows_aid`	The device's Windows AID in the format received from the device.

App information

Field	Description
`app_build_number`	App build number.
`app_package_name`	The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
`app_version_name`	The app version in the format specified by the developer.
`application_id`	Unique numeric identifier for the application in AppMetrica.

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
`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. Acceptable 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_id`	Installation ID.
`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`.

Device and OS information

Field	Description
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`area`	The region name in English.
`city`	The name of the city in English.
`connection_type`	Type of connection. Possible values: `wifi` \| `cell` \| `unknown`.
`country`	The country name in English.
`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`.
`district`	The federal district name in English.
`event_source`	Event source: `sdk` \| `import_api` \| `js` \| `system`.
`google_aid`	The device's Google AID in the format received from the device.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`os_name`	Operating system on the user's device: `ios` \| `android` \| `windows`.
`os_version`	The version of the operating system on the user's device.
`profile_id`	User profile ID.
`windows_aid`	The device's Windows AID in the format received from the device.

App information

Field	Description
`app_package_name`	The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
`app_version_name`	The app version in the format specified by the developer.
`application_id`	Unique numeric identifier for the application in AppMetrica.

Crashes [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
`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. Acceptable 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.
`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.
`installation_id`	Installation ID.
`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`.

Device and OS information

Field	Description
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`area`	The region name in English.
`city`	The name of the city in English.
`connection_type`	Type of connection. Possible values: `wifi` \| `cell` \| `unknown`.
`country`	The country name in English.
`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`.
`district`	The federal district name in English.
`event_source`	Event source: `sdk` \| `import_api` \| `js` \| `system`.
`google_aid`	The device's Google AID in the format received from the device.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`os_name`	Operating system on the user's device: `ios` \| `android` \| `windows`.
`os_version`	The version of the operating system on the user's device.
`profile_id`	User profile ID.
`windows_aid`	The device's Windows AID in the format received from the device.

App information

Field	Description
`app_package_name`	The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
`app_version_name`	The app version in the format specified by the developer.
`application_id`	Unique numeric identifier for the application in AppMetrica.

Errors [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
`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. Acceptable 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_id`	Installation ID.
`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`.

Device and OS information

Field	Description
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`area`	The region name in English.
`city`	The name of the city in English.
`connection_type`	Type of connection. Possible values: `wifi` \| `cell` \| `unknown`.
`country`	The country name in English.
`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`.
`district`	The federal district name in English.
`event_source`	Event source: `sdk` \| `import_api` \| `js` \| `system`.
`google_aid`	The device's Google AID in the format received from the device.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`os_name`	Operating system on the user's device: `ios` \| `android` \| `windows`.
`os_version`	The version of the operating system on the user's device.
`profile_id`	User profile ID.
`windows_aid`	The device's Windows AID in the format received from the device.

App information

Field	Description
`app_package_name`	The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
`app_version_name`	The app version in the format specified by the developer.
`application_id`	Unique numeric identifier for the application in AppMetrica.

Session 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
`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. Acceptable 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_id`	Installation ID.
`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.

Device and OS information

Field	Description
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`area`	The region name in English.
`city`	The name of the city in English.
`country`	The country name 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`.
`district`	The federal district name in English.
`event_source`	Event source: `sdk` \| `import_api` \| `js` \| `system`.
`google_aid`	The device's Google AID in the format received from the device.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`original_device_model`	Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).
`os_name`	Operating system on the user's device: `ios` \| `android` \| `windows`.
`os_version`	The version of the operating system on the user's device.
`profile_id`	User profile ID.
`windows_aid`	The device's Windows AID in the format received from the device.

App information

Field	Description
`app_build_number`	App build number.
`app_package_name`	The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
`app_version_name`	The app version in the format specified by the developer.
`application_id`	Unique numeric identifier for the application in AppMetrica.

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
`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. Acceptable 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_id`	Installation ID.
`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.

Device and OS information

Field	Description
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`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 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.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`original_device_model`	Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).
`os_name`	Operating system on the user's device: `ios` \| `android` \| `windows`.
`os_version`	The version of the operating system on the user's device.
`profile_id`	User profile ID.
`windows_aid`	The device's Windows AID in the format received from the device.

App information

Field	Description
`app_build_number`	App build number.
`app_package_name`	The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
`app_version_name`	The app version in the format specified by the developer.
`application_id`	Unique numeric identifier for the application in AppMetrica.

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.
`area`	The region name in English.
`city`	The name of the city where the click was made (in English).
`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.
`country`	The country name 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).
`district`	The federal district name in English.
`google_aid`	The device's Google AID in the format received from the device.
`huawei_oaid`	The device's Huawei OAID 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.
`is_bot`	Indicates a non-browser click.
`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`.
`publisher_id`	ID of the AppMetrica publisher.
`publisher_name`	Name of the AppMetrica partner.
`tracker_name`	Name of the tracker being added to the AppMetrica interface.
`tracking_id`	ID of the AppMetrica tracker.
`touch_type`	Type: click or impression. Possible values: `click` \| `impression` \| `unknown`.
`windows_aid`	The device's Windows AID 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
`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_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`.
`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
`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. Acceptable 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.
`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.
`installation_id`	Installation ID.
`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.

Device and OS information

Field	Description
`android_id`	Android device ID.
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`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 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.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`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. Acceptable 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. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`country`	The country name in English.
`district`	The federal district name in English.
`area`	The region name in English.
`city`	The name of the city 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.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`operator_name`	Name of the mobile operator.
`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. Acceptable 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. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`country`	The country name in English.
`district`	The federal district name in English.
`area`	The region name in English.
`city`	The name of the city 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.

Conversion [attributed_event]

Allows you to upload events of various types attributed to traffic sources according to the selected event_attribution attribution model in Data Stream settings.

Beta: conversions as a data type are under development and may be expanded with new possible field values in the future. Currently, conversion rules are automatically created along with the postback sending setting in trackers.

Available fields:

ad_revenue,ad_revenue_currency,ad_revenue_data_source,ad_revenue_datetime,ad_revenue_network,ad_revenue_payload,ad_revenue_placement_id,ad_revenue_placement_name,ad_revenue_precision,ad_revenue_receive_datetime,ad_revenue_receive_timestamp,ad_revenue_timestamp,ad_revenue_type,ad_revenue_unit_id,ad_revenue_unit_name,android_id,app_build_number,app_framework,app_package_name,app_version_name,application_id,appmetrica_device_id,appmetrica_sdk_version,area,attributed_event_type,attributed_touch_type,certificate_verification_status,city,click_date,click_datetime,click_id,click_ipv6,click_timestamp,click_url_parameters,click_user_agent,connection_type,conversion_attribution_window_size,conversion_id,conversion_name,country,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,district,ecom_cart_item_internal_components,ecom_cart_item_price_fiat_unit_type,ecom_cart_item_price_fiat_value,ecom_cart_item_quantity,ecom_order_id,ecom_order_payload,ecom_product_actual_price_fiat_unit_type,ecom_product_actual_price_fiat_value,ecom_product_actual_price_internal_components,ecom_product_category_path_1,ecom_product_category_path_10,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_name,ecom_product_original_price_fiat_unit_type,ecom_product_original_price_fiat_value,ecom_product_original_price_internal_components,ecom_product_payload,ecom_product_promocodes,ecom_product_sku,ecom_referrer_id,ecom_referrer_type,ecom_screen_category_path_1,ecom_screen_category_path_10,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_name,ecom_screen_payload,ecom_screen_search_query,ecom_type,event_attribution_model,event_date,event_datetime,event_initial_event_type,event_json,event_name,event_receive_datetime,event_receive_timestamp,event_source,event_timestamp,google_aid,huawei_oaid,installation_id,ios_ifa,ios_ifv,is_reattribution,is_reinstallation,is_revenue_autocollected,is_revenue_verified,match_type,mcc,mnc,operator_name,original_device_model,os_name,os_version,profile_id,publisher_id,publisher_name,revenue_currency,revenue_event_type,revenue_inapp_type,revenue_order_id,revenue_order_id_source,revenue_price,revenue_product_id,revenue_quantity,session_id,session_type,sign,testids,touch_type,tracker_name,tracking_id,version,windows_aid

Conversion information. The values depend on the attribution model.

Field	Description
`attributed_event_type`	The type of the attributed event. Allows you to distinguish between export data types combined into a common type `attributed_event`. Acceptable values: `event` — Application events; `revenue` — Revenue; `ecommerce` — In-App purchases; `ad_revenue` — Ad Revenue.
`event_attribution_model`	The selected attribution model in the Data Stream settings. Acceptable values: `first_appmetrica` — "first click" in terms of AppMetrica; `last_appmetrica` — "last click" in terms of AppMetrica. If not specified, the default value `last_appmetrica` is used.
`event_initial_event_type`	The user's first interaction with the app after viewing or clicking an ad. Acceptable values: `installation` — application installation; `deeplink` — opening a deep link.
`conversion_id`	A list of conversion IDs achieved with this event. It has the format of a JSON list of numbers, for example: `[1,2,3]`.
`conversion_name`	A list of conversion names. Matches the list of `conversion_id`. It has the format of a JSON list of strings, for example: `["conv 1","conv 2","conv 3"]`.
`conversion_attribution_window_size`	List of conversion attribution window sizes. Matches the list of `conversion_id`. Measured in seconds. It has the format of a JSON list of numbers, for example: `[86400,604800,86400]`.

Tracking information. The values depend on the attribution model.

Field	Description
`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.
`publisher_id`	ID of the AppMetrica publisher.
`publisher_name`	Name of the AppMetrica partner.
`tracking_id`	ID of the AppMetrica tracker.
`tracker_name`	Name of the tracker being added to the AppMetrica interface.

Opening the application via deeplinks [deeplink]

Available fields:

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

Tracking information

Field	Description
`deeplink_url_host`	Deeplink domain name. For example, for a link formatted as `[scheme]:[//host][/path][?parameters]`, it returns `host`.
`deeplink_url_parameters`	Parameters that are passed to the deeplink. For more information about passing parameters, see Parameters of the tracking URL.
`deeplink_url_path`	URL path of the deeplink. For example, for a link formatted as `[scheme]:[//host][/path][?parameters]`, it returns `path`.
`deeplink_url_scheme`	URL scheme of the deeplink. For example, for a link formatted as `[scheme]:[//host][/path][?parameters]`, it returns `scheme`.
`event_datetime`	Date and time of the event in `yyyy-mm-dd hh:mm:ss` format.
`event_receive_datetime`	Date and time the event was received on the server side. May differ from `event_datetime` due to network delays or if the user's device was not connected at the time of the event.
`event_receive_timestamp`	Time when the event was received on the server side in Unix time format. May differ from `event_timestamp` due to network delays or if the user's device was not connected at the time of the event.
`event_timestamp`	Time of the event in Unix time format. With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than seven days. The API expects a value in seconds.
`is_reengagement`	Indicates that the tracker was created for a remarketing campaign.
`profile_id`	User profile ID.
`publisher_id`	ID of the AppMetrica publisher.
`publisher_name`	Name of the AppMetrica partner.
`session_id`	Session ID. The set of values `installation_id`, `session_id` and the platform device ID (`google_aid` / `ios_ifa`) allows you to uniquely identify a user's session.
`tracker_name`	Name of the tracker being added to the AppMetrica interface.
`tracking_id`	ID of the AppMetrica tracker.

Device and OS information

Field	Description
`android_id`	Android device ID.
`appmetrica_device_id`	A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.
`appmetrica_sdk_version`	Version of the AppMetrica SDK.
`area`	The region name in English.
`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. Acceptable 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.
`city`	The name of the city in English.
`connection_type`	Type of connection. Possible values: `wifi` \| `cell` \| `unknown`.
`country_iso_code`	ISO country code.
`country`	The country name in English.
`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`.
`district`	The federal district name in English.
`google_aid`	The device's Google AID in the format received from the device.
`huawei_oaid`	The device's Huawei OAID in the format received from the device.
`installation_id`	Installation ID.
`ios_ifa`	The device's IFA in the format received from the device.
`ios_ifv`	IFV for the app in the format received from the device.
`mcc`	Mobile country code.
`mnc`	Mobile network code.
`original_device_model`	Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on).
`os_version`	The version of the operating system on the user's device.
`windows_aid`	The device's Windows AID in the format received from the device.

App information

Field	Description
`app_build_number`	App build number.
`app_package_name`	The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
`app_version_name`	The app version in the format specified by the developer.

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