Загрузка событий

Загружает информацию о событиях.

Свойства событий можно передавать в параметрах запроса или в теле. При передаче данных в теле, к URL запроса необходимо добавить .csv. Подробнее в разделе Пример запроса.

Для привязки события к пользователю, необходимо использовать одно из следующих полей при запросе:

  • profile_id
  • appmetrica_device_id
Внимание. Post API содержит ограничения на загрузку данных. Подробнее в разделе Ограничения.

Формат запроса

POST https://api.appmetrica.yandex.ru/logs/v1/import/events
 ? post_api_key=<string>
 & application_id=<int>
 & profile_id=<string>
 & appmetrica_device_id=<int>
 & event_name=<string>
 & event_timestamp=<int>
 & [event_json=<json>]
 & [session_type=<string>]
 & [ios_ifa=<string>]
 & [ios_ifv=<string>]
 & [google_aid=<string>]
 & [windows_aid=<string>]
 & [os_name=<string>]
 & [os_version=<string>]
 & [device_manufacturer=<string>]
 & [device_model=<string>]
 & [device_type=<string>]
 & [device_locale=<string>]
 & [app_version_name=<string>]
 & [app_package_name=<string>]
 & [connection_type=<string>]
 & [operator_name=<string>]
 & [mcc=<int>]
 & [mnc=<int>]
 & [device_ipv6=<string>]
Query-параметры
post_api_key *Токен для загрузки данных. Его можно получить в разделе Настройки вашего приложения.
application_id *Числовой идентификатор приложения.
profile_id *Идентификатор профиля пользователя.. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK.
Внимание. Не передавайте значение вместе с параметром appmetrica_device_id. Сервер принимает только один из параметров.
appmetrica_device_id *Хеш от уникального идентификатора устройства, который устанавливает AppMetrica. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK.
Внимание. Не передавайте значение вместе с параметром profile_id. Сервер принимает только один из параметров.
event_name *Имя события.
event_timestamp *Время события в формате UNIX-time.

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

event_jsonАтрибуты события, сериализованные в JSON. Параметры событий могут быть вложенными, например {"param1":"param2","param1":{"param2":"param3"}}.

Подробнее о событиях в разделе События.

session_typeТип сессии. Возможные значения: background | foreground. Значение по умолчанию: background.
ios_ifaIFA устройства.
ios_ifvIFV устройства.
google_aidGoogle AID устройства.
windows_aidWindows AID устройства.
os_nameИмя операционной системы на устройстве пользователя. Возможные значения: ios | android | windows.
os_versionВерсия операционной системы на устройстве пользователя.
device_manufacturerПроизводитель устройства. Например, Apple, Samsung.
device_modelМодель устройства. Например, Galaxy S6, iPhone X.
device_typeТип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | phablet | tv | desktop | unknown.
device_localeЯзык интерфейса устройства. Например, en_US
app_version_nameВерсия приложения в виде, как указана разработчиком.
app_package_nameИмя пакета для Android или Bundle ID для iOS. Например, ru.yandex.sample.metrica.
connection_typeТип подключения устройства. Возможные значения: wifi | cell | unknown.
operator_nameИмя оператора сотовой связи. Например, MegaFon.
mccМобильный код страны. Например, 250
mncКод мобильной сети. Например, 2
device_ipv6IP-адрес в момент совершения события в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147
Query-параметры
post_api_key *Токен для загрузки данных. Его можно получить в разделе Настройки вашего приложения.
application_id *Числовой идентификатор приложения.
profile_id *Идентификатор профиля пользователя.. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK.
Внимание. Не передавайте значение вместе с параметром appmetrica_device_id. Сервер принимает только один из параметров.
appmetrica_device_id *Хеш от уникального идентификатора устройства, который устанавливает AppMetrica. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK.
Внимание. Не передавайте значение вместе с параметром profile_id. Сервер принимает только один из параметров.
event_name *Имя события.
event_timestamp *Время события в формате UNIX-time.

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

event_jsonАтрибуты события, сериализованные в JSON. Параметры событий могут быть вложенными, например {"param1":"param2","param1":{"param2":"param3"}}.

Подробнее о событиях в разделе События.

session_typeТип сессии. Возможные значения: background | foreground. Значение по умолчанию: background.
ios_ifaIFA устройства.
ios_ifvIFV устройства.
google_aidGoogle AID устройства.
windows_aidWindows AID устройства.
os_nameИмя операционной системы на устройстве пользователя. Возможные значения: ios | android | windows.
os_versionВерсия операционной системы на устройстве пользователя.
device_manufacturerПроизводитель устройства. Например, Apple, Samsung.
device_modelМодель устройства. Например, Galaxy S6, iPhone X.
device_typeТип устройства, определяется сервисом AppMetrica. Возможные значения: phone | tablet | phablet | tv | desktop | unknown.
device_localeЯзык интерфейса устройства. Например, en_US
app_version_nameВерсия приложения в виде, как указана разработчиком.
app_package_nameИмя пакета для Android или Bundle ID для iOS. Например, ru.yandex.sample.metrica.
connection_typeТип подключения устройства. Возможные значения: wifi | cell | unknown.
operator_nameИмя оператора сотовой связи. Например, MegaFon.
mccМобильный код страны. Например, 250
mncКод мобильной сети. Например, 2
device_ipv6IP-адрес в момент совершения события в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147

*  Обязательный параметр