Типы данных для экспорта

Установки приложения [installation]

Доступные поля:

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. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

click_timestamp

Время клика/показа в формате UNIX-time в секундах.

click_url_parameters

Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, ?param1=1&param2=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

certificate_verification_status

Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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 (например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147).

install_receive_datetime

Дата и время получения сервером события об установке. Может отличаться от install_datetime из-за задержек в сети или отсутствия подключения у пользователя на момент события.

install_receive_timestamp

Время получения сервером события об установке в формате UNIX-time. Может отличаться от install_timestamp из-за задержек в сети или отсутствия подключения у пользователя на момент события.

install_timestamp

Время установки в формате UNIX-time в секундах.

installation_id

Идентификатор установки.

is_reattribution

Признак реатрибутирования установки новому источнику. Возможные значения: true | false.

is_reinstallation

Признак переустановки приложения. Возможные значения: true | false.

match_type

Способ атрибуции: 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, в IOS от IFV.

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]

Доступные поля:

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 управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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. Может отличаться от event_timestamp из-за задержек в сети или отсутствия подключения у пользователя на момент события.

event_timestamp

Время события в формате 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, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

area

Название области на английском языке.

city

Название города на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country

Название страны на английском языке.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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]

Доступные поля:

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 управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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. Может отличаться от token_datetime из-за задержек в сети или отсутствия подключения у пользователя.

token_timestamp

Время создания токена в формате UNIX-time.

session_id

Идентификатор сессии. Набор из значений installation_id, session_id и платформенного идентификатора устройства (google_aid / ios_ifa) позволяет однозначно идентифицировать сессию пользователя.

session_type

Тип сессии. Возможные значения: foreground | background.

Информация об устройстве и ОС

Поле

Описание

appmetrica_device_id

Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от AppSetId, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

area

Название области на английском языке.

city

Название города на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country

Название страны на английском языке.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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]

Доступные поля:

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 управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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. Может отличаться от crash_timestamp из-за задержек в сети или отсутствия подключения у пользователя.

crash_timestamp

Время аварийной остановки приложения в формате UNIX-time.

installation_id

Идентификатор установки.

session_id

Идентификатор сессии. Набор из значений installation_id, session_id и платформенного идентификатора устройства (google_aid / ios_ifa) позволяет однозначно идентифицировать сессию пользователя.

session_type

Тип сессии. Возможные значения: foreground | background.

Информация об устройстве и ОС

Поле

Описание

appmetrica_device_id

Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от AppSetId, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

area

Название области на английском языке.

city

Название города на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country

Название страны на английском языке.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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]

Доступные поля:

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 управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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. Может отличаться от error_timestamp из-за задержек в сети или отсутствия подключения у пользователя.

error_timestamp

Время ошибки в формате UNIX-time.

session_id

Идентификатор сессии. Набор из значений installation_id, session_id и платформенного идентификатора устройства (google_aid / ios_ifa) позволяет однозначно идентифицировать сессию пользователя.

session_type

Тип сессии. Возможные значения: foreground | background.

Информация об устройстве и ОС

Поле

Описание

appmetrica_device_id

Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от AppSetId, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

area

Название области на английском языке.

city

Название города на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country

Название страны на английском языке.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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]

Доступные поля:

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 управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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. Может отличаться от session_timestamp из-за задержек в сети или отсутствия подключения у пользователя.

session_start_timestamp

Время начала сессии в формате UNIX-time.

Информация об устройстве и ОС

Поле

Описание

appmetrica_device_id

Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от AppSetId, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

area

Название области на английском языке.

city

Название города на английском языке.

country

Название страны на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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_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 управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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. Может отличаться от session_timestamp из-за задержек в сети или отсутствия подключения у пользователя.

session_end_timestamp

Время завершения сессии в формате UNIX-time.

Информация об устройстве и ОС

Поле

Описание

appmetrica_device_id

Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от AppSetId, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

country

Название страны на английском языке.

district

Название федерального округа на английском языке.

area

Название области на английском языке.

city

Название города на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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]

Доступные поля:

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. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

click_timestamp

Время клика/показа в формате UNIX-time в секундах.

click_url_parameters

Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, ?param1=1&param2=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_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 покупок.
Возможные значения:

  • true — собрано автоматически;
  • false — отправлено вручную;
  • undefined — неизвестно.

revenue_quantity

Количество покупок (купленных товаров).

revenue_price

Стоимость. Может быть отрицательной (например, для возврата).

revenue_currency

Код валюты покупки в формате 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 управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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. Может отличаться от event_timestamp из-за задержек в сети или отсутствия подключения у пользователя на момент события.

event_timestamp

Время события в формате 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, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

country

Название страны на английском языке.

district

Название федерального округа на английском языке.

area

Название области на английском языке.

city

Название города на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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]

Позволяет выгрузить данные, переданные через вызов reportECommerce (см. Android и iOS). Один вызов reportECommerce может быть представлен несколькими событиями в экспорте (см. поле ecom_type).

Доступные поля:

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. Может отличаться от event_timestamp из-за задержек в сети или отсутствия подключения у пользователя на момент события.

event_timestamp

Время события в формате UNIX-time.

Post API позволяет загрузить только те события, у которых разница между датой совершения события (event_timestamp) и датой загрузки не больше 14 дней. Ожидается значение в секундах.

session_id

Идентификатор сессии. Набор из значений installation_id, session_id и платформенного идентификатора устройства (google_aid / ios_ifa) позволяет однозначно идентифицировать сессию пользователя.

installation_id

Идентификатор установки.

certificate_verification_status

Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • unknown — статус неизвестен;
  • valid — подпись успешно прошла проверку;
  • invalid — сертификаты не совпадают;
  • unsupported_operating_system — операционная система не Android;
  • empty_event_certificate — в событии отсутствует сертификат.

Информация об устройстве и ОС

Поле

Описание

android_id

Идентификатор Android.

appmetrica_device_id

Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от AppSetId, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

country

Название страны на английском языке.

district

Название федерального округа на английском языке.

area

Название области на английском языке.

city

Название города на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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_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.

Post API позволяет загрузить только те события, у которых разница между датой совершения события (event_timestamp) и датой загрузки не больше 14 дней. Ожидается значение в секундах.

ad_revenue_receive_datetime

Дата и время получения сервером события. Может отличаться от ad_revenue_datetime из-за задержек в сети или отсутствия подключения у пользователя на момент события.

ad_revenue_receive_timestamp

Время получения сервером события в формате 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. Возможные значения:

  • 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 управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • unknown — статус неизвестен;
  • valid — подпись успешно прошла проверку;
  • invalid — сертификаты не совпадают;
  • unsupported_operating_system — операционная система не Android;
  • empty_event_certificate — в событии отсутствует сертификат.

Информация об устройстве и ОС

Поле

Описание

android_id

Идентификатор Android.

appmetrica_device_id

Уникальный идентификатор устройства, который устанавливает AppMetrica. В Android от AppSetId, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

country

Название страны на английском языке.

district

Название федерального округа на английском языке.

area

Название области на английском языке.

city

Название города на английском языке.

connection_type

Тип подключения устройства. Возможные значения: wifi | cell | unknown.

country_iso_code

ISO-код страны.

device_ipv6

IP-адрес в момент совершения события в формате 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]

Позволяет выгрузить события различных типов, атрибутированные источникам трафика согласно выбранной модели атрибуции event_attribution в настройках Data Stream.

Beta: конверсии как тип данных находятся в стадии разработки и в будущем могут быть расширены новыми возможными значениями полей. На текущий момент правила конверсий автоматически создаются вместе с настройкой отправки постбеков в трекерах.

Доступные поля:

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. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

click_timestamp

Время клика/показа в формате UNIX-time в секундах.

click_url_parameters

Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, ?param1=1&param2=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_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.

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. Может отличаться от event_timestamp из-за задержек в сети или отсутствия подключения у пользователя на момент события.

event_timestamp

Время события в формате 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, в IOS от IFV.

appmetrica_sdk_version

Версия AppMetrica SDK.

area

Название области на английском языке.

certificate_verification_status

Результат сравнения отпечатка сертификата приложения (отпечаток, который был загружен через API управления и отпечаток, который пришел вместе с событием). Используется для верификации событий. Возможные значения:

  • 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. Например, 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

Версия приложения в виде, как указана разработчиком.

Анализ офферных событий [product_flow]

Доступные поля:

product_flow_type, product_flow_offer_id, product_flow_product_id, product_flow_offer_type, product_flow_benefit_type, product_flow_referrer_type, product_flow_referrer_id, product_flow_referrer_screen, product_flow_step_type, product_flow_step_option, product_flow_result_status, product_flow_price_unit_type, product_flow_price_value, product_flow_payload

Информация об офферном событии

Поле

Описание

product_flow_type

Тип офферного события. Возможные значения: offer_shown, flow_start, flow_step, flow_result.

product_flow_offer_id

ID оффера.

product_flow_product_id

ID продукта.

product_flow_offer_type

Тип оффера.

product_flow_benefit_type

Тип выгоды.

product_flow_referrer_type

Тип источника перехода.

product_flow_referrer_id

ID источника перехода.

product_flow_referrer_screen

Название экрана.

product_flow_step_type

Тип шага оформления.

product_flow_step_option

Значение шага оформления.

product_flow_result_status

Статус результата. Возможные значения: success, declined, pending, cancelled, expired, fail.

product_flow_price_unit_type

Валюта.

product_flow_price_value

Цена оффера в валюте оффера.

product_flow_payload

Параметры оффера в формате {"ключ":"значение"}.

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки Предложить улучшение для документации