Документация
Интеграция SDK

Доступные точки запроса

Трекинговые клики

/logs/v1/export/clicks.{csv | json | parts}

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

Таблица 1. Трекинговая информация

ПолеОписание
publisher_id ID партнера в AppMetrica. Может использоваться для определения партнера в отчетах AppMetrica
tracking_id ID трекера в AppMetrica. Может использоваться для определения партнера в отчетах AppMetrica
publisher_name Название партнера AppMetrica
tracker_name Название трекера, который добавляется в интерфейсе AppMetrica
click_datetime Дата и время клика в формате yyyy-mm-dd hh:mm:ss
click_timestamp Время клика в формате UNIX-time в секундах
click_ipv6 IP-адрес в момент клика в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147
click_url_parameters Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, ?param1=1&param2=2... будет выглядеть в запросе как ?param1%3D1%26param2%3D2...)
click_id Идентификатор клика или '' (пустая строка, если не доступен)
click_user_agent User-agent клика

Таблица 2. Информация об устройстве (определенная по клику)

ПолеОписание
ios_ifa IFA устройства в формате, в котором получен в клике
ios_ifv IFV для приложения в формате, в котором получен во время клика
google_aid Google AID устройства в формате, в котором получен во время клика
windows_aid Windows AID устройства в формате, в котором получен от устройства
os_name Имя операционной системы на устройстве пользователя: ios | android | windows
os_version Версия операционной системы на устройстве пользователя
device_manufacturer Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung)
device_model Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).
device_type Тип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | unknown
country_iso_code ISO-код страны, где был произвден клик
city Название города на англйиском языке, где был произведен клик

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

/logs/v1/export/installations.{csv | json | parts}

Доступные атрибуты:

Таблица 3. Трекинговая информация

ПолеОписание
publisher_id ID партнера в AppMetrica. Может использоваться для определения партнера в отчетах AppMetrica
tracking_id ID трекера в AppMetrica. Может использоваться для определения партнера в отчетах AppMetrica
publisher_name Название партнера AppMetrica
tracker_name Название трекера, который добавляется в интерфейсе AppMetrica
click_datetime Дата и время клика в формате yyyy-mm-dd hh:mm:ss
click_timestamp Время клика в формате UNIX-time в секундах
click_ipv6 IP-адрес в момент клика в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147
click_url_parameters Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, ?param1=1&param2=2... будет выглядеть в запросе как ?param1%3D1%26param2%3D2...)
click_id Идентификатор клика или '' (пустая строка, если не доступен)
click_user_agent User-agent клика

Таблица 4. Информация об установке

ПолеОписание
match_type Способ атрибуции: fingerprint | referrer | identifier | '' (пустая строка)
install_datetime Дата и время установки в формате yyyy-mm-dd hh:mm:ss
install_timestamp Время установки в формате UNIX-time в секундах
install_receive_datetime Дата и время получения сервером события об установке. Может отличаться от install_datetime из-за задержек в сети или отсутствия подключения у пользователя на момент события
install_receive_timestamp Время получения сервером события об установке в формате UNIX-time. Может отличаться от install_timestamp из-за задержек в сети или отсутствия подключения у пользователя на момент события
install_ipv6 IP-адрес в момент установки в формате IPv6 (например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147)
is_reinstallation Признак переустановки приложения. Возможные значения: true | false

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

ПолеОписание
ios_ifa IFA устройства в формате, в котором получен в клике
ios_ifv IFV для приложения в формате, в котором получен во время клика
google_aid Google AID устройства в формате, в котором получен во время клика
windows_aid Windows AID устройства в формате, в котором получен от устройства
os_name Имя операционной системы на устройстве пользователя: ios | android | windows
os_version Версия операционной системы на устройстве пользователя
device_manufacturer Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung)
device_model Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).
device_type Тип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | unknown
device_locale Язык интерфейса устройства
connection_type Типа подключения устройства. Возможные значения: wifi | cell| unknown
operator_name Имя оператора сотовой связи
mcc Мобильный код страны
mnc Код мобильной сети
country_iso_code ISO-код страны, где был произвден клик
city Название города на англйиском языке, где был произведен клик
appmetrica_device_id Уникальный идентификатор устройства, который устанавливает AppMetrica

Таблица 6. Информация о приложении

ПолеОписание
app_version_name Версия приложения в виде, как указана разработчиком
app_package_name Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro)

Постбеки

/logs/v1/export/postbacks.{csv | json | parts}

Таблица 7. Трекинговая информация

ПолеОписание
publisher_id ID партнера в AppMetrica. Может использоваться для определения партнера в отчетах AppMetrica
tracking_id ID трекера в AppMetrica. Может использоваться для определения партнера в отчетах AppMetrica
publisher_name Название партнера AppMetrica
tracker_name Название трекера, который добавляется в интерфейсе AppMetrica
click_datetime Дата и время клика в формате yyyy-mm-dd hh:mm:ss
click_timestamp Время клика в формате UNIX-time в секундах
click_ipv6 IP-адрес в момент клика в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147
click_url_parameters Параметры, как они представлены в ссылке. При этом специальные символы необходимо экранировать (например, ?param1=1&param2=2... будет выглядеть в запросе как ?param1%3D1%26param2%3D2...)
click_id Идентификатор клика или '' (пустая строка, если не доступен)
click_user_agent User-agent клика

Таблица 8. Информация об установке

ПолеОписание
match_type Способ атрибуции: fingerprint | referrer | identifier | '' (пустая строка)
install_datetime Дата и время установки в формате yyyy-mm-dd hh:mm:ss
install_timestamp Время установки в формате UNIX-time в секундах
install_ipv6 IP-адрес в момент установки в формате IPv6 (например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147)

Таблица 9. Информация об устройстве (определенная по клику)

ПолеОписание
ios_ifa IFA устройства в формате, в котором получен в клике
ios_ifv IFV для приложения в формате, в котором получен во время клика
google_aid Google AID устройства в формате, в котором получен во время клика
windows_aid Windows AID устройства в формате, в котором получен от устройства
os_name Имя операционной системы на устройстве пользователя: ios | android | windows
os_version Версия операционной системы на устройстве пользователя
device_manufacturer Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung)
device_model Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).
device_type Тип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | unknown
device_locale Язык интерфейса устройства
appmetrica_device_id Уникальный идентификатор устройства, который устанавливает AppMetrica

Таблица 10. Информация о приложении

ПолеОписание
app_version_name Версия приложения в виде, как указана разработчиком
app_package_name Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro)

Таблица 11. Информация о событии

ПолеОписание
event_name Имя события CPA postback
conversion_datetime Дата и время события (для CPA postback) или устаноки (для CPI postback) в формате yyyy-mm-dd hh:mm:ss
conversion_timestamp Время события (для CPA postback) или установки (для CPI postback) в формате UNIX-time

Таблица 12. Информация о postback

ПолеОписание
cost_model (postback_type) cpi | cpa
postback_url Полный Postback URL
postback_url_parameters Параметры Postback URL, как они представлены в URL (например, ?param1=1&param2=2...)
attempt_timestamp Время отправки в формате UNIX-time
attempt_datetime Дата и время отправки в формате yyyy-mm-dd hh:mm:ss
notifying_status Статус отправки postback (failed | sent). Один и тот же postback может присутствовать в ответе несколько раз, если его отправка не была успешной
response_code HTTP-код отправки postback
response_body Данные, полученные от сервера

События приложения

/logs/v1/export/events.{csv | json | parts}

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

ПолеОписание
ios_ifa IFA устройства в формате, в котором получен в клике
ios_ifv IFV для приложения в формате, в котором получен во время клика
google_aid Google AID устройства в формате, в котором получен во время клика
windows_aid Windows AID устройства в формате, в котором получен от устройства
os_name Имя операционной системы на устройстве пользователя: ios | android | windows
os_version Версия операционной системы на устройстве пользователя
device_manufacturer Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung)
device_model Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).
device_type Тип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | unknown
device_locale Язык интерфейса устройства
connection_type Типа подключения устройства. Возможные значения: wifi | cell| unknown
operator_name Имя оператора сотовой связи
mcc Мобильный код страны
mnc Код мобильной сети
country_iso_code ISO-код страны, где был произвден клик
city Название города на англйиском языке, где был произведен клик
appmetrica_device_id Уникальный идентификатор устройства, который устанавливает AppMetrica
device_ipv6 IP-адрес в момент совершения события в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147

Таблица 14. Информация о приложении

ПолеОписание
app_version_name Версия приложения в виде, как указана разработчиком
app_package_name Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro)

Таблица 15. Информация о событии

ПолеОписание
event_name Имя события (как передано в SDK)
event_json Атрибуты события, сериализованные в JSON
event_datetime Дата и время события в формате yyyy-mm-dd hh:mm:ss
event_timestamp Время события в формате UNIX-time
event_receive_datetime Дата и время получения сервером события. Может отличаться от event_datetime из-за задержек в сети или отсутствия подключения у пользователя на момент события
event_receive_timestamp Время получения сервером события в формате UNIX-time. Может отличаться от event_timestamp из-за задержек в сети или отсутствия подключения у пользователя на момент события

Push-токены

/logs/v1/export/push_tokens.{csv | json | parts}

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

ПолеОписание
ios_ifa IFA устройства в формате, в котором получен в клике
ios_ifv IFV для приложения в формате, в котором получен во время клика
google_aid Google AID устройства в формате, в котором получен во время клика
windows_aid Windows AID устройства в формате, в котором получен от устройства
os_name Имя операционной системы на устройстве пользователя: ios | android | windows
os_version Версия операционной системы на устройстве пользователя
device_manufacturer Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung)
device_model Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).
device_type Тип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | unknown
device_locale Язык интерфейса устройства
connection_type Типа подключения устройства. Возможные значения: wifi | cell| unknown
operator_name Имя оператора сотовой связи
mcc Мобильный код страны
mnc Код мобильной сети
country_iso_code ISO-код страны, где был произвден клик
city Название города на англйиском языке, где был произведен клик
appmetrica_device_id Уникальный идентификатор устройства, который устанавливает AppMetrica
device_ipv6 IP-адрес в момент совершения события в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147

Таблица 17. Информация о приложении

ПолеОписание
app_version_name Версия приложения в виде, как указана разработчиком
app_package_name Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro)

Таблица 18. Информация о push-токене

ПолеОписание
token Значение push-токена
token_datetime Время создания токена в формате yyyy-mm-dd hh:mm:ss
token_timestamp Время создания токена в формате UNIX-time
token_receive_datetime Время получения токена на сервере в формате yyyy-mm-dd hh:mm:ss. Может отличаться от token_datetime из-за задержек в сети или отсутствия подключения у пользователя
token_receive_timestamp Время получения токена сервером в формате UNIX-time. Может отличаться от token_datetime из-за задержек в сети или отсутствия подключения у пользователя

Аварийные остановки приложения

/logs/v1/export/crashes.{csv | json | parts}

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

ПолеОписание
ios_ifa IFA устройства в формате, в котором получен в клике
ios_ifv IFV для приложения в формате, в котором получен во время клика
google_aid Google AID устройства в формате, в котором получен во время клика
windows_aid Windows AID устройства в формате, в котором получен от устройства
os_name Имя операционной системы на устройстве пользователя: ios | android | windows
os_version Версия операционной системы на устройстве пользователя
device_manufacturer Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung)
device_model Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).
device_type Тип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | unknown
device_locale Язык интерфейса устройства
connection_type Типа подключения устройства. Возможные значения: wifi | cell| unknown
operator_name Имя оператора сотовой связи
mcc Мобильный код страны
mnc Код мобильной сети
country_iso_code ISO-код страны, где был произвден клик
city Название города на англйиском языке, где был произведен клик
appmetrica_device_id Уникальный идентификатор устройства, который устанавливает AppMetrica
device_ipv6 IP-адрес в момент совершения события в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147

Таблица 20. Информация о приложении

ПолеОписание
app_version_name Версия приложения в виде, как указана разработчиком
app_package_name Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro)

Таблица 21. Информация об аварийной оставновке приложения

ПолеОписание
crash Отслеживание стека
crash_id Идентификатор аварийной остановки
crash_group_id Идентификатор группы схожих аварийных остановок
crash_datetime Дата и время аварийной остановки приложения в формате yyyy-mm-dd hh:mm:ss
crash_timestamp Время аварийной остановки приложения в формате UNIX-time
crash_receive_datetime Дата и время получения сервером сообщения об аварийной остановке в формате yyyy-mm-dd hh:mm:ss. Может отличаться от crash_datetime из-за задержек в сети или отсутствия подключения у пользователя
crash_receive_timestamp Время получения сервером сообщения об аварийной остановке в формате UNIX-time. Может отличаться от crash_timestamp из-за задержек в сети или отсутствия подключения у пользователя

Ошибки

/logs/v1/export/errors.{csv | json | parts}

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

ПолеОписание
ios_ifa IFA устройства в формате, в котором получен в клике
ios_ifv IFV для приложения в формате, в котором получен во время клика
google_aid Google AID устройства в формате, в котором получен во время клика
windows_aid Windows AID устройства в формате, в котором получен от устройства
os_name Имя операционной системы на устройстве пользователя: ios | android | windows
os_version Версия операционной системы на устройстве пользователя
device_manufacturer Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung)
device_model Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).
device_type Тип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | unknown
device_locale Язык интерфейса устройства
connection_type Типа подключения устройства. Возможные значения: wifi | cell| unknown
operator_name Имя оператора сотовой связи
mcc Мобильный код страны
mnc Код мобильной сети
country_iso_code ISO-код страны, где был произвден клик
city Название города на англйиском языке, где был произведен клик
appmetrica_device_id Уникальный идентификатор устройства, который устанавливает AppMetrica
device_ipv6 IP-адрес в момент совершения события в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147

Таблица 23. Информация о приложении

ПолеОписание
app_version_name Версия приложения в виде, как указана разработчиком
app_package_name Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro)

Таблица 24. Информация об ошибках приложения

ПолеОписание
error Текст ошибки
error_id Идентификатор ошибки
error_datetime Дата и время ошибки в формате yyyy-mm-dd hh:mm:ss
error_timestamp Время ошибки в формате UNIX-time
error_receive_datetime Время получения сервером сообщения об ошибке в формате yyyy-mm-dd hh:mm:ss. Может отличаться от error_datetime из-за задержек в сети или отсутствия подключения у пользователя
error_receive_timestamp Время получения сервером сообщения об ошибке в формате UNIX-time. Может отличаться от error_timestamp из-за задержек в сети или отсутствия подключения у пользователя

Начало сессий

/logs/v1/export/sessions_starts.{csv | json | parts}

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

ПолеОписание
ios_ifa IFA устройства в формате, в котором получен в клике
ios_ifv IFV для приложения в формате, в котором получен во время клика
google_aid Google AID устройства в формате, в котором получен во время клика
windows_aid Windows AID устройства в формате, в котором получен от устройства
os_name Имя операционной системы на устройстве пользователя: ios | android | windows
os_version Версия операционной системы на устройстве пользователя
device_manufacturer Производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung)
device_model Модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).
device_type Тип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | unknown
device_locale Язык интерфейса устройства
connection_type Типа подключения устройства. Возможные значения: wifi | cell| unknown
operator_name Имя оператора сотовой связи
mcc Мобильный код страны
mnc Код мобильной сети
country_iso_code ISO-код страны, где был произвден клик
city Название города на англйиском языке, где был произведен клик
appmetrica_device_id Уникальный идентификатор устройства, который устанавливает AppMetrica
device_ipv6 IP-адрес в момент совершения события в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147

Таблица 26. Информация о приложении

ПолеОписание
app_version_name Версия приложения в виде, как указана разработчиком
app_package_name Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro)

Таблица 27. Информация об ошибках приложения

ПолеОписание
session_start_datetime Дата и время начала сессии в формате yyyy-mm-dd hh:mm:ss
session_start_timestamp Время начала сессии в формате UNIX-time
session_start_receive_datetime Время получения сервером сообщения о начале сессии в формате yyyy-mm-dd hh:mm:ss. Может отличаться от session_datetime из-за задержек в сети или отсутствия подключения у пользователя
session_start_receive_timestamp Время получения сервером сообщения о начале сессии в формате UNIX-time. Может отличаться от session_timestamp из-за задержек в сети или отсутствия подключения у пользователя