---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://appmetrica.yandex.com/docs/en/mobile-api/datastream/data-type-fields.md
- https://appmetrica.yandex.com/docs/ru/mobile-api/datastream/data-type-fields.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com/docs/en/llms.txt
# Data types for export
## App installations [installation] {#installations}
Available fields:
```no-highlight translate=no
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,fraud_reasons,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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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¶m2=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](https://developer.android.com/reference/android/content/pm/PackageManager#getInstallSourceInfo(java.lang.String)) 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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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.
||
|| `fraud_reasons` | Fraud assessment details. Contains a list of indicators that influenced the FraudScore verdict for this installation. Has a JSON string list format, for example: `["blacklist", "proxy"]`. ||
|| `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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://appmetrica.yandex.com/docs/en/mobile-tracking/technology.md): `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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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] {#events}
Available fields:
```no-highlight translate=no
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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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 14 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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#push-tokens}
Available fields:
```no-highlight translate=no
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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#crashes}
Available fields:
```no-highlight translate=no
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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#errors}
Available fields:
```no-highlight translate=no
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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#sessions_starts}
Available fields:
```no-highlight translate=no
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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#session_end}
Available fields:
```no-highlight translate=no
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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#click}
Available fields:
```no-highlight translate=no
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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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¶m2=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] {#revenue}
Available fields:
```no-highlight translate=no
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](../../data-collection/about-revenue#in-app-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](https://en.wikipedia.org/wiki/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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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 14 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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#ecommerce}
You can export data that was sent with the `reportECommerce` method call (see details for [Android](../../sdk/android/analytics/android-operations#send-ecommerce) and [iOS](../../sdk/ios/analytics/ios-operations#send-ecommerce)). A single `reportECommerce` call can be represented as multiple events in export (see the `ecom_type` field).
Available fields:
```no-hihglight translate=no
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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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 14 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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#ad_revenue}
Available fields:
```no-highlight translate=no
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](https://en.wikipedia.org/wiki/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 14 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](https://en.wikipedia.org/wiki/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](https://appmetrica.yandex.com/docs/en/sdk/android/off-adrevenue.md). 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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://en.wikipedia.org/wiki/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] {#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](https://appmetrica.yandex.com/docs/en/mobile-api/datastream/ref/settings-post.md).
*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:
```no-highlight translate=no
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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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¶m2=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] {#deeplinks}
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](https://appmetrica.yandex.com/docs/en/mobile-tracking/tracking-specification.md#to-deeplink). ||
|| `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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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 14 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](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `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](https://appmetrica.yandex.com/docs/en/settings/verification-events.md). 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](https://en.wikipedia.org/wiki/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
Suggest an improvement for documentation