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

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

Свойства событий можно передавать в параметрах запроса или в теле. При передаче данных в теле, к 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>]
 & [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"}}.

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

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