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

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

Внимание.

Post API позволяет загрузить события, которые произошли не раньше 7 дней от даты загрузки.

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

  • profile_id
  • appmetrica_device_id
Внимание.

Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK.

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

POST /logs/v1/import/events

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

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>]
 & [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 *Идентификатор профиля пользователя.
Внимание. Не передавайте значение вместе с параметром appmetrica_device_id. Сервер принимает только один из параметров.
appmetrica_device_id *Хеш от уникального идентификатора устройства, который устанавливает AppMetrica.
Внимание. Не передавайте значение вместе с параметром profile_id. Сервер принимает только один из параметров.
event_name *Имя события.
event_timestamp *Время события в формате UNIX-time.
event_jsonАтрибуты события, сериализованные в JSON.
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

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

Коды ответа

КодОписание
200Данные успешно загружены.
403Запрос не содержит заголовка авторизации, либо указан неверный токен.
400Запрос не содержит одного или нескольких обязательных параметров.

Пример запроса

POST /logs/v1/import/events.csv?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012 HTTP/1.1
Host: api.appmetrica.yandex.com
Content-Length: 540i
Connection: close

device_model,device_ipv6,device_type,google_aid,app_package_name,operator_name,mnc,application_id,event_json,profile_id,event_name,event_timestamp
iPhone X,2a02:6b8::40c:6676:baff:fea6:53d8,phone,01234567-890a-bcde-f012-3456789abcde,com.yandex.sample.metrica,MegaFon,2,1111,"{""key"":""value_1""}",1234567890123456789,event_name_1,1234567890
iPhone X,2a02:6b8::40c:6676:baff:fea6:53d9,phone,fedcba98-7654-3210-fedc-ba9876543210,com.yandex.sample.metrica,MegaFon,2,1111,"{""key"":""value_2""}",9876543210987654321,event_name_2,1234567891