---
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/ru/llms.txt
# Типы данных для экспорта
## Установки приложения [installation] {#installations}
Доступные поля:
```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
```
Трекинговая информация
#|
|| **Поле** | **Описание** ||
|| `attributed_touch_type` | Тип рекламного взаимодействия: `click` \| `impression` \| `unknown`.
||
|| `click_datetime` | Дата и время клика/показа в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `click_id` | Идентификатор клика/показа или `''` (пустая строка, если недоступен). ||
|| `click_ipv6` | IP-адрес в момент клика/показа в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, `2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147`.
||
|| `click_timestamp` | Время клика/показа в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time) в секундах.
||
|| `click_url_parameters` | Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, `?param1=1¶m2=2...` будет выглядеть в запросе как `?param1%3D1%26param2%3D2...`).
||
|| `click_user_agent` | User-agent клика/показа. ||
|| `publisher_id` | ID партнера в AppMetrica. ||
|| `publisher_name` | Название партнера AppMetrica. ||
|| `tracker_name` | Название трекера, который добавляется в интерфейсе AppMetrica. ||
|| `tracking_id` | ID трекера в AppMetrica. ||
|#
Информация об установке
#|
|| **Поле** | **Описание** ||
|| `app_installer` | Имя пакета источника установки приложения, определенное с помощью метода [getInstallSourceInfo](https://developer.android.com/reference/android/content/pm/PackageManager#getInstallSourceInfo(java.lang.String)) ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `fraud_status` | Оценка фрода для установок по трекерам, в которых включена опция антифрода. Возможные значения: `ok` \| `low` \| `mid` \| `high` \| `unknown`. Изначально все установки имеют значение `unknown`, но после анализа от FraudScore установки повторно появятся в экспорте с обновленным значением `fraud_status`, см. описание полей `version` и `sign`.
||
|| `fraud_reasons` | Детали оценки фрода. Содержит список признаков, которые повлияли на вердикт FraudScore для данной установки. Имеет формат списка строк JSON, например: `["blacklist", "proxy"]`. ||
|| `install_datetime` | Дата и время установки в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `install_ipv6` | IP-адрес в момент установки в формате [IPv6](https://en.wikipedia.org/wiki/IPv6) (например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147).
||
|| `install_receive_datetime` | Дата и время получения сервером события об установке. Может отличаться от `install_datetime` из-за задержек в сети или отсутствия подключения у пользователя на момент события. ||
|| `install_receive_timestamp` | Время получения сервером события об установке в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `install_timestamp` из-за задержек в сети или отсутствия подключения у пользователя на момент события.
||
|| `install_timestamp` | Время установки в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time) в секундах.
||
|| `installation_id` | Идентификатор установки. ||
|| `is_reattribution` | Признак реатрибутирования установки новому источнику. Возможные значения: `true` \| `false`.
||
|| `is_reinstallation` | Признак переустановки приложения. Возможные значения: `true` \| `false`.
||
|| `match_type` | [Способ атрибуции](https://appmetrica.yandex.com/docs/ru/mobile-tracking/technology.md): `fingerprint` \| `referrer` \| `identifier` \| `''` (пустая строка). ||
|| `sign` | Числовой признак добавления или удаления установки. Возможные значения: `1` и `-1`. Это поле позволяет на потоке считать реальное количество установок при обновляемых `version`, для этого нужно суммировать значения `sign`.
Например, одно обновление установки с изменением `fraud_status` будет представлено тремя записями в экспорте, а сумма `sign` равна 1 (одна реальная установка):
```
installation_id sign version fraud_status
0c08ef45-...-fc43f0c989c3 1 1 unknown
0c08ef45-...-fc43f0c989c3 -1 1 unknown
0c08ef45-...-fc43f0c989c3 1 2 high
```
||
|| `version` | Числовой номер версии установки. В потоке экспорта одна и та же установка может встретиться несколько раз с одним и тем же `installation_id`, но с обновленными значениями других полей. Установка с наибольшим `version` содержит актуальные данные.
||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country` | Название страны на английском языке. ||
|| `country_iso_code` | ISO-код страны. ||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `district` | Название федерального округа на английском языке. ||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи. ||
|| `os_name` | Операционная система на устройстве пользователя: `ios` \| `android` \| `windows`.
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_build_number` | Номер сборки приложения. ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|| `application_id` | Уникальный числовой идентификатор приложения в AppMetrica. ||
|#
## События приложения [event] {#events}
Доступные поля:
```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
```
Информация о событии и сессии
#|
|| **Поле** | **Описание** ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `event_datetime` | Дата и время события в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `event_json` | Атрибуты события, сериализованные в JSON. ||
|| `event_name` | Имя события (как передано в SDK). ||
|| `event_receive_datetime` | Дата и время получения сервером события. Может отличаться от `event_datetime` из-за задержек в сети или отсутствия подключения у пользователя на момент события. ||
|| `event_receive_timestamp` | Время получения сервером события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `event_timestamp` из-за задержек в сети или отсутствия подключения у пользователя на момент события.
||
|| `event_timestamp` | Время события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
Post API позволяет загрузить только те события, у которых разница между датой совершения события (`event_timestamp`) и датой загрузки не больше 14 дней. Ожидается значение в секундах.
||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `session_type` | Тип сессии. Возможные значения: `foreground` \| `background`.
||
|| `installation_id` | Идентификатор установки. ||
|| `testids` | Массив числовых идентификаторов вариантов эксперимента. ||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country` | Название страны на английском языке. ||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `district` | Название федерального округа на английском языке. ||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи. ||
|| `original_device_model` | Заводская модель устройства (например, для Galaxy S8 возможны следующие значения: SM-G9550, SM-G9558 и т. д.).
||
|| `os_name` | Операционная система на устройстве пользователя: `ios` \| `android` \| `windows`.
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_build_number` | Номер сборки приложения. ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|| `application_id` | Уникальный числовой идентификатор приложения в AppMetrica. ||
|#
## Push-токены [push_token] {#push-tokens}
Доступные поля:
```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
```
Информация о push-токене
#|
|| **Поле** | **Описание** ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `installation_id` | Идентификатор установки. ||
|| `token` | Значение push-токена. ||
|| `token_datetime` | Время создания токена в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `token_receive_datetime` | Время получения токена сервером в формате `yyyy-mm-dd hh:mm:ss`. Может отличаться от `token_datetime` из-за задержек в сети или отсутствия подключения у пользователя. ||
|| `token_receive_timestamp` | Время получения токена сервером в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `token_datetime` из-за задержек в сети или отсутствия подключения у пользователя.
||
|| `token_timestamp` | Время создания токена в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `session_type` | Тип сессии. Возможные значения: `foreground` \| `background`.
||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country` | Название страны на английском языке. ||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `district` | Название федерального округа на английском языке. ||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи.||
|| `os_name` | Операционная система на устройстве пользователя: `ios` \| `android` \| `windows`.
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|| `application_id` | Уникальный числовой идентификатор приложения в AppMetrica. ||
|#
## Крэши [crash] {#crashes}
Доступные поля:
```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
```
Информация об аварийной остановке приложения
#|
|| **Поле** | **Описание** ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `crash` | Отслеживание стека. ||
|| `crash_datetime` | Дата и время аварийной остановки приложения в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `crash_group_id` | Идентификатор группы схожих аварийных остановок. ||
|| `crash_id` | Идентификатор аварийной остановки. ||
|| `crash_name` | Имя аварийной остановки. ||
|| `crash_receive_datetime` | Дата и время получения сервером сообщения об аварийной остановке в формате `yyyy-mm-dd hh:mm:ss`. Может отличаться от `crash_datetime` из-за задержек в сети или отсутствия подключения у пользователя.
||
|| `crash_receive_timestamp` | Время получения сервером сообщения об аварийной остановке в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `crash_timestamp` из-за задержек в сети или отсутствия подключения у пользователя.
||
|| `crash_timestamp` | Время аварийной остановки приложения в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
||
|| `installation_id` | Идентификатор установки. ||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `session_type` | Тип сессии. Возможные значения: `foreground` \| `background`.
||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country` | Название страны на английском языке. ||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `district` | Название федерального округа на английском языке. ||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи.||
|| `os_name` | Операционная система на устройстве пользователя: `ios` \| `android` \| `windows`.
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|| `application_id` | Уникальный числовой идентификатор приложения в AppMetrica. ||
|#
## Ошибки [error] {#errors}
Доступные поля:
```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
```
Информация об ошибках приложения
#|
|| **Поле** | **Описание** ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `installation_id` | Идентификатор установки. ||
|| `error` | Текст ошибки. ||
|| `error_datetime` | Дата и время ошибки в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `error_id` | Идентификатор ошибки. ||
|| `error_name` | Имя ошибки. ||
|| `error_receive_datetime` | Время получения сервером сообщения об ошибке в формате `yyyy-mm-dd hh:mm:ss`. Может отличаться от `error_datetime` из-за задержек в сети или отсутствия подключения у пользователя.
||
|| `error_receive_timestamp` | Время получения сервером сообщения об ошибке в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `error_timestamp` из-за задержек в сети или отсутствия подключения у пользователя.
||
|| `error_timestamp` | Время ошибки в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `session_type` | Тип сессии. Возможные значения: `foreground` \| `background`.
||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country` | Название страны на английском языке. ||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `district` | Название федерального округа на английском языке. ||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи.||
|| `os_name` | Операционная система на устройстве пользователя: `ios` \| `android` \| `windows`.
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|| `application_id` | Уникальный числовой идентификатор приложения в AppMetrica. ||
|#
## Начало сессий [session_start] {#sessions_starts}
Доступные поля:
```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
```
Информация о сессиях
#|
|| **Поле** | **Описание** ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `installation_id` | Идентификатор установки. ||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `session_type` | Тип сессии. Возможные значения: `foreground` \| `background`.
||
|| `session_start_datetime` | Дата и время начала сессии в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `session_start_receive_datetime` | Время получения сервером сообщения о начале сессии в формате `yyyy-mm-dd hh:mm:ss`. Может отличаться от `session_datetime` из-за задержек в сети или отсутствия подключения у пользователя. ||
|| `session_start_receive_timestamp` | Время получения сервером сообщения о начале сессии в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `session_timestamp` из-за задержек в сети или отсутствия подключения у пользователя.
||
|| `session_start_timestamp` | Время начала сессии в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `country` | Название страны на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `district` | Название федерального округа на английском языке. ||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи.||
|| `original_device_model` | Заводская модель устройства (например, для Galaxy S8 возможны следующие значения: SM-G9550, SM-G9558 и т. д.).
||
|| `os_name` | Операционная система на устройстве пользователя: `ios` \| `android` \| `windows`.
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_build_number` | Номер сборки приложения. ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|| `application_id` | Уникальный числовой идентификатор приложения в AppMetrica. ||
|#
## Завершение сессий [session_end] {#session_end}
Доступные поля:
```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
```
Информация о сессиях
#|
|| **Поле** | **Описание** ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `installation_id` | Идентификатор установки. ||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `session_type` | Тип сессии. Возможные значения: `foreground` \| `background`.
||
|| `session_end_datetime` | Дата и время завершения сессии в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `session_end_receive_datetime` | Время получения сервером сообщения о завершении сессии в формате `yyyy-mm-dd hh:mm:ss`. Может отличаться от `session_datetime` из-за задержек в сети или отсутствия подключения у пользователя. ||
|| `session_end_receive_timestamp` | Время получения сервером сообщения о завершении сессии в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `session_timestamp` из-за задержек в сети или отсутствия подключения у пользователя.
||
|| `session_end_timestamp` | Время завершения сессии в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `country` | Название страны на английском языке. ||
|| `district` | Название федерального округа на английском языке. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи.||
|| `original_device_model` | Заводская модель устройства (например, для Galaxy S8 возможны следующие значения: SM-G9550, SM-G9558 и т. д.).
||
|| `os_name` | Операционная система на устройстве пользователя: `ios` \| `android` \| `windows`.
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_build_number` | Номер сборки приложения. ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|| `application_id` | Уникальный числовой идентификатор приложения в AppMetrica. ||
|#
## Клики и показы [click] {#click}
Доступные поля:
```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
```
Данные о трекинговых кликах и показах
#|
|| **Поле** | **Описание** ||
|| `application_id` | Уникальный числовой идентификатор приложения в AppMetrica. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке, где был произведен клик. ||
|| `click_datetime` | Дата и время клика/показа в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `click_id` | Идентификатор клика/показа или `''` (пустая строка, если недоступен). ||
|| `click_ipv6` | IP-адрес в момент клика/показа в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, `2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147`.
||
|| `click_timestamp` | Время клика/показа в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time) в секундах.
||
|| `click_url_parameters` | Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, `?param1=1¶m2=2...` будет выглядеть в запросе как `?param1%3D1%26param2%3D2...`).
||
|| `click_user_agent` | User-agent клика/показа. ||
|| `country` | Название страны на английском языке. ||
|| `country_iso_code` | ISO-код страны. ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `district` | Название федерального округа на английском языке. ||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `is_bot` | Признак клика, совершённого не из браузера. ||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `os_name` | Операционная система на устройстве пользователя: `ios` \| `android` \| `windows`.
||
|| `publisher_id` | ID партнера в AppMetrica. ||
|| `publisher_name` | Название партнера AppMetrica. ||
|| `tracker_name` | Название трекера, который добавляется в интерфейсе AppMetrica. ||
|| `tracking_id` | ID трекера в AppMetrica. ||
|| `touch_type` | Тип: клик или показ. Возможные значения: `click` \| `impression` \| `unknown`.
||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
## Revenue [revenue] {#revenue}
Доступные поля:
```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
```
Информация о доходах
#|
|| **Поле** | **Описание** ||
|| `is_revenue_verified` | Признак верификации покупки в магазине. Возможные значения:
- `true` — проверено;
- `false` — проверено и отбраковано;
- `undefined` — неизвестно.
||
|| `is_revenue_autocollected` | Признак [автоматического отслеживания In-App покупок](../../data-collection/about-revenue#in-app-tracking).
Возможные значения:
- `true` — собрано автоматически;
- `false` — отправлено вручную;
- `undefined` — неизвестно.
||
|| `revenue_quantity` | Количество покупок (купленных товаров). ||
|| `revenue_price` | Стоимость. Может быть отрицательной (например, для возврата). ||
|| `revenue_currency` | Код валюты покупки в формате [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). ||
|| `revenue_product_id` | Идентификатор товара. ||
|| `revenue_order_id` | Идентификатор заказа. ||
|| `revenue_order_id_source` | Источник идентификатора заказа. Возможные значения: `autogenerated` \| `user_defined`.
||
|| `revenue_inapp_type` | Признак покупки или взаимодействия с подпиской. Возможные значения:
- `one_time_purchase`
- `subscription`
||
|| `revenue_event_type` | Подтип события. Возможные значения:
- `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`
||
|#
Информация о событии и сессии
#|
|| **Поле** | **Описание** ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `event_datetime` | Дата и время события в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `event_name` | Имя события (как передано в SDK). ||
|| `event_receive_datetime` | Дата и время получения сервером события. Может отличаться от `event_datetime` из-за задержек в сети или отсутствия подключения у пользователя на момент события. ||
|| `event_receive_timestamp` | Время получения сервером события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `event_timestamp` из-за задержек в сети или отсутствия подключения у пользователя на момент события.
||
|| `event_timestamp` | Время события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
Post API позволяет загрузить только те события, у которых разница между датой совершения события (`event_timestamp`) и датой загрузки не больше 14 дней. Ожидается значение в секундах.
||
|| `installation_id` | Идентификатор установки. ||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `android_id` | Идентификатор Android. ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `country` | Название страны на английском языке. ||
|| `district` | Название федерального округа на английском языке. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `event_datetime` | Дата и время события в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи. ||
|| `original_device_model` | Заводская модель устройства (например, для Galaxy S8 возможны следующие значения: SM-G9550, SM-G9558 и т. д.).
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_build_number` | Номер сборки приложения. ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|#
## Покупки [ecommerce] {#ecommerce}
Позволяет выгрузить данные, переданные через вызов `reportECommerce` (см. [Android](../../sdk/android/analytics/android-operations#send-ecommerce) и [iOS](../../sdk/ios/analytics/ios-operations#send-ecommerce)). Один вызов `reportECommerce` может быть представлен несколькими событиями в экспорте (см. поле `ecom_type`).
Доступные поля:
```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
```
Информация о покупках
#|
|| **Поле** | **Описание** ||
|| `ecom_type` | Тип события покупки. Допустимые значения:
- `show_screen`
- `show_product_card`
- `show_product_details`
- `add_cart_item`
- `remove_cart_item`
- `begin_checkout`
- `purchase`
||
|| `ecom_screen_name` | Название экрана. ||
|| `ecom_screen_search_query` | Поисковый запрос. ||
|| `ecom_screen_payload` | Параметры экрана, как передали в SDK. Имеет формат объекта JSON “строковые ключ-значение”, например:
```
{
"configuration": "landscape",
"fullscreen": "true"
}
```
||
|| `ecom_screen_category_path_1` | Категория экрана. Уровень 1. ||
|| `ecom_screen_category_path_2` | Категория экрана. Уровень 2. ||
|| `ecom_screen_category_path_3` | Категория экрана. Уровень 3. ||
|| `ecom_screen_category_path_4` | Категория экрана. Уровень 4. ||
|| `ecom_screen_category_path_5` | Категория экрана. Уровень 5. ||
|| `ecom_screen_category_path_6` | Категория экрана. Уровень 6. ||
|| `ecom_screen_category_path_7` | Категория экрана. Уровень 7. ||
|| `ecom_screen_category_path_8` | Категория экрана. Уровень 8. ||
|| `ecom_screen_category_path_9` | Категория экрана. Уровень 9. ||
|| `ecom_screen_category_path_10` | Категория экрана. Уровень 10. ||
|| `ecom_product_name` | Название товара. ||
|| `ecom_product_sku` | ID товара. ||
|| `ecom_product_promocodes` | Промокоды товара. Имеет формат списка строк JSON, например:
```
["BT79IYX", "UT5412EP"]
```
||
|| `ecom_product_payload` | Параметры товара, как передали в SDK. Имеет формат объекта JSON “строковые ключ-значение”, например:
```
{
"configuration": "landscape",
"fullscreen": "true"
}
```
||
|| `ecom_product_category_path_1` | Категория товара. Уровень 1. ||
|| `ecom_product_category_path_2` | Категория товара. Уровень 2. ||
|| `ecom_product_category_path_3` | Категория товара. Уровень 3. ||
|| `ecom_product_category_path_4` | Категория товара. Уровень 4. ||
|| `ecom_product_category_path_5` | Категория товара. Уровень 5. ||
|| `ecom_product_category_path_6` | Категория товара. Уровень 6. ||
|| `ecom_product_category_path_7` | Категория товара. Уровень 7. ||
|| `ecom_product_category_path_8` | Категория товара. Уровень 8. ||
|| `ecom_product_category_path_9` | Категория товара. Уровень 9. ||
|| `ecom_product_category_path_10` | Категория товара. Уровень 10. ||
|| `ecom_product_actual_price_fiat_unit_type` | Валюта актуальной стоимости товара. ||
|| `ecom_product_actual_price_fiat_value` | Актуальная стоимость товара. ||
|| `ecom_product_actual_price_internal_components` | Составляющие актуальной стоимости товара. Имеет формат списка JSON-объектов-пар “ключ-значение”, например:
```
[
{ "wood": 25.01 },
{ "iron": 10 }
]
```
||
|| `ecom_product_original_price_fiat_unit_type` | Валюта базовой стоимости товара. ||
|| `ecom_product_original_price_fiat_value` | Базовая стоимость товара. ||
|| `ecom_product_original_price_internal_components` | Составляющие базовой стоимости товара. Имеет формат списка JSON-объектов-пар “ключ-значение”, например:
```
[
{ "wood": 25.01 },
{ "iron": 10 }
]
```
||
|| `ecom_cart_item_price_fiat_unit_type` | Валюта стоимости товара в корзине. ||
|| `ecom_cart_item_price_fiat_value` | Стоимость товара в корзине. ||
|| `ecom_cart_item_quantity` | Количество товара в корзине. ||
|| `ecom_cart_item_internal_components` | Составляющие стоимости товара в корзине. Имеет формат списка JSON-объектов-пар “ключ-значение”, например:
```
[
{ "wood": 25.01 },
{ "iron": 10 }
]
```
||
|| `ecom_referrer_type` | Тип источника перехода. ||
|| `ecom_referrer_id` | ID источника перехода. ||
|| `ecom_order_id` | ID покупки. ||
|| `ecom_order_payload` | Параметры покупки, как передали в SDK. Имеет формат объекта JSON “строковые ключ-значение”, например:
```
{
"configuration": "landscape",
"fullscreen": "true"
}
```
||
|#
Информация о событии и сессии
#|
|| **Поле** | **Описание** ||
|| `event_datetime` | Дата и время события в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `event_name` | Имя события (как передано в SDK). ||
|| `event_receive_datetime` | Дата и время получения сервером события. Может отличаться от `event_datetime` из-за задержек в сети или отсутствия подключения у пользователя на момент события. ||
|| `event_receive_timestamp` | Время получения сервером события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `event_timestamp` из-за задержек в сети или отсутствия подключения у пользователя на момент события.
||
|| `event_timestamp` | Время события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
Post API позволяет загрузить только те события, у которых разница между датой совершения события (`event_timestamp`) и датой загрузки не больше 14 дней. Ожидается значение в секундах.
||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `installation_id` | Идентификатор установки. ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `android_id` | Идентификатор Android. ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `country` | Название страны на английском языке. ||
|| `district` | Название федерального округа на английском языке. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `event_datetime` | Дата и время события в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи. ||
|| `original_device_model` | Заводская модель устройства (например, для Galaxy S8 возможны следующие значения: SM-G9550, SM-G9558 и т. д.).
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_build_number` | Номер сборки приложения. ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|#
## Ad Revenue [ad_revenue] {#ad_revenue}
Доступные поля:
```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
#|
|| **Поле** | **Описание** ||
|| `ad_revenue_datetime` | Дата и время события в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `ad_revenue_timestamp` | Время события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
Post API позволяет загрузить только те события, у которых разница между датой совершения события (`event_timestamp`) и датой загрузки не больше 14 дней. Ожидается значение в секундах.
||
|| `ad_revenue_receive_datetime` | Дата и время получения сервером события. Может отличаться от `ad_revenue_datetime` из-за задержек в сети или отсутствия подключения у пользователя на момент события.
||
|| `ad_revenue_receive_timestamp` | Время получения сервером события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `ad_revenue_timestamp` из-за задержек в сети или отсутствия подключения у пользователя на момент события.
||
|| `ad_revenue` | Сумма денег Ad Revenue. ||
|| `ad_revenue_currency` | Валюта Ad Revenue. ||
|| `ad_revenue_type` | Тип Ad Revenue. Возможные значения:
* `native`
* `banner`
* `rewarded`
* `interstitial`
* `mrec`
* `other`
||
|| `ad_revenue_data_source` | Признак [автособранного Ad Revenue](https://appmetrica.yandex.com/docs/ru/sdk/android/off-adrevenue.md). Возможные значения:
* `autocollected`
* `manual`
||
|| `ad_revenue_network` | Рекламная сеть. ||
|| `ad_revenue_placement_id` | ID расположения рекламы. ||
|| `ad_revenue_placement_name` | Название расположения рекламы. ||
|| `ad_revenue_unit_id` | ID рекламной единицы. ||
|| `ad_revenue_unit_name` | Название рекламной единицы. ||
|| `ad_revenue_precision` | Точность суммы Ad Revenue, как передано в SDK. Например, "publisher_defined" или "estimated". ||
|| `ad_revenue_payload` | Дополнительные данные, сериализованные в JSON. ||
|#
Информация о событии и сессии
#|
|| **Поле** | **Описание** ||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `installation_id` | Идентификатор установки. ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `android_id` | Идентификатор Android. ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `country` | Название страны на английском языке. ||
|| `district` | Название федерального округа на английском языке. ||
|| `area` | Название области на английском языке. ||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `event_source` | Источник возникновения события: `sdk` \| `import_api` \| `js` \| `system`.
||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `operator_name` | Имя оператора сотовой связи. ||
|| `original_device_model` | Заводская модель устройства (например, для Galaxy S8 возможны следующие значения: SM-G9550, SM-G9558 и т. д.).
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_build_number` | Номер сборки приложения. ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|#
## Конверсии [attributed_event] {#attributed_event}
Позволяет выгрузить события различных типов, атрибутированные источникам трафика согласно выбранной модели атрибуции `event_attribution` в [настройках Data Stream](https://appmetrica.yandex.com/docs/ru/mobile-api/datastream/ref/settings-post.md).
*Beta*: конверсии как тип данных находятся в стадии разработки и в будущем могут быть расширены новыми возможными значениями полей. На текущий момент правила конверсий автоматически создаются вместе с настройкой отправки постбеков в трекерах.
Доступные поля:
```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
```
Информация о конверсии. Значения зависят от модели атрибуции.
#|
|| **Поле** | **Описание** ||
|| `attributed_event_type` | Тип атрибутированного события. Позволяет различить типы данных экспорта, объединенные в общий тип `attributed_event`. Возможные значения:
- `event` — События приложения;
- `revenue` — Revenue;
- `ecommerce` — Покупки;
- `ad_revenue` — Ad Revenue.
||
|| `event_attribution_model` | Выбранная модель атрибуции в настройках Data Stream. Возможные значения:
- `first_appmetrica` — «first click» в терминах AppMetrica;
- `last_appmetrica` — «last click» в терминах AppMetrica.
Если модель не задана, используется модель по умолчанию: `last_appmetrica`.
||
|| `event_initial_event_type` | Первое взаимодействие пользователя с приложением после просмотра или клика рекламы. Возможные значения:
- `installation` — установка приложения;
- `deeplink` — открытие диплинка.
||
|| `conversion_id` | Список ID конверсий, достигнутых вместе с данным событием. Имеет формат JSON-списка чисел, например: `[1,2,3]`.
||
|| `conversion_name` | Список названий конверсий. Соответствует списку `conversion_id`. Имеет формат JSON-списка строк, например: `["conv 1","conv 2","conv 3"]`.
||
|| `conversion_attribution_window_size` | Список размеров окон атрибуции конверсий. Соответствует списку `conversion_id`. Измеряется в секундах. Имеет формат JSON-списка чисел, например: `[86400,604800,86400]`.
||
|#
Трекинговая информация. Значения зависят от модели атрибуции.
#|
|| **Поле** | **Описание** ||
|| `attributed_touch_type` | Тип рекламного взаимодействия: `click` \| `impression` \| `unknown`.
||
|| `click_datetime` | Дата и время клика/показа в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `click_id` | Идентификатор клика/показа или `''` (пустая строка, если недоступен). ||
|| `click_ipv6` | IP-адрес в момент клика/показа в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, `2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147`.
||
|| `click_timestamp` | Время клика/показа в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time) в секундах.
||
|| `click_url_parameters` | Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, `?param1=1¶m2=2...` будет выглядеть в запросе как `?param1%3D1%26param2%3D2...`).
||
|| `click_user_agent` | User-agent клика/показа. ||
|| `publisher_id` | ID партнера в AppMetrica. ||
|| `publisher_name` | Название партнера AppMetrica. ||
|| `tracking_id` | ID трекера в AppMetrica. ||
|| `tracker_name` | Название трекера, который добавляется в интерфейсе AppMetrica. ||
|#
## Открытия приложения через deeplink [deeplink] {#deeplinks}
Доступные поля:
```
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
```
Трекинговая информация
#|
|| **Поле** | **Описание** ||
|| `deeplink_url_host` | Доменное имя deeplink. Например, для ссылки вида `[scheme]:[//host][/path][?parameters]` возвращает `host`. ||
|| `deeplink_url_parameters` | Параметры, которые передаются в deeplink. Подробнее о передаче параметров в разделе [Параметры tracking URL](https://appmetrica.yandex.com/docs/ru/mobile-tracking/tracking-specification.md#to-deeplink). ||
|| `deeplink_url_path` | URL-путь deeplink. Например, для ссылки вида `[scheme]:[//host][/path][?parameters]` возвращает `path`.
||
|| `deeplink_url_scheme` | URL-схема deeplink. Например, для ссылки вида `[scheme]:[//host][/path][?parameters]` возвращает `scheme`.
||
|| `event_datetime` | Дата и время события в формате `yyyy-mm-dd hh:mm:ss`. ||
|| `event_receive_datetime` | Дата и время получения сервером события. Может отличаться от `event_datetime` из-за задержек в сети или отсутствия подключения у пользователя на момент события. ||
|| `event_receive_timestamp` | Время получения сервером события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Может отличаться от `event_timestamp` из-за задержек в сети или отсутствия подключения у пользователя на момент события.
||
|| `event_timestamp` | Время события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time).
Post API позволяет загрузить только те события, у которых разница между датой совершения события (`event_timestamp`) и датой загрузки не больше 14 дней. Ожидается значение в секундах.
||
|| `is_reengagement` | Признак, который определяет, что трекер создан для ремаркетинг-кампании. ||
|| `profile_id` | Идентификатор пользовательского профиля. ||
|| `publisher_id` | ID партнера в AppMetrica. ||
|| `publisher_name` | Название партнера AppMetrica. ||
|| `session_id` | Идентификатор сессии. Набор из значений `installation_id`, `session_id` и платформенного идентификатора устройства (`google_aid` / `ios_ifa`) позволяет однозначно идентифицировать сессию пользователя. ||
|| `tracker_name` | Название трекера, который добавляется в интерфейсе AppMetrica. ||
|| `tracking_id` | ID трекера в AppMetrica. ||
|#
Информация об устройстве и ОС
#|
|| **Поле** | **Описание** ||
|| `android_id` | Идентификатор Android. ||
|| `appmetrica_device_id` | Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от [AppSetId](https://developer.android.com/identity/app-set-id), в IOS от [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). ||
|| `appmetrica_sdk_version` | Версия AppMetrica SDK. ||
|| `area` | Название области на английском языке. ||
|| `certificate_verification_status` | Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для [верификации событий](https://appmetrica.yandex.com/docs/ru/settings/verification-events.md). Возможные значения:
- `unknown` — статус неизвестен;
- `valid` — подпись успешно прошла проверку;
- `invalid` — сертификаты не совпадают;
- `unsupported_operating_system` — операционная система не Android;
- `empty_event_certificate` — в событии отсутствует сертификат.
||
|| `city` | Название города на английском языке. ||
|| `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`.
||
|| `country` | Название страны на английском языке. ||
|| `country_iso_code` | ISO-код страны. ||
|| `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.
||
|| `device_locale` | Язык интерфейса устройства. ||
|| `device_manufacturer` | Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung). ||
|| `device_model` | Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6). ||
|| `device_type` | Тип устройства, определяется сервисом AppMetrica. Возможные значения: `phone` \| `tablet` \| `unknown`.
||
|| `district` | Название федерального округа на английском языке. ||
|| `google_aid` | Google AID устройства в формате, в котором получен от устройства. ||
|| `huawei_oaid` | Huawei OAID устройства в формате, в котором получен от устройства. ||
|| `installation_id` | Идентификатор установки. ||
|| `ios_ifa` | IFA устройства в формате, в котором получен от устройства. ||
|| `ios_ifv` | IFV для приложения в формате, в котором получен от устройства. ||
|| `mcc` | Мобильный код страны. ||
|| `mnc` | Код мобильной сети. ||
|| `original_device_model` | Заводская модель устройства (например, для Galaxy S8 возможны следующие значения: SM-G9550, SM-G9558 и т. д.).
||
|| `os_version` | Версия операционной системы на устройстве пользователя. ||
|| `windows_aid` | Windows AID устройства в формате, в котором получен от устройства. ||
|#
Информация о приложении
#|
|| **Поле** | **Описание** ||
|| `app_build_number` | Номер сборки приложения. ||
|| `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). ||
|| `app_version_name` | Версия приложения в виде, как указана разработчиком. ||
|#
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.
Написать в службу поддержки
Предложить улучшение для документации