--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://appmetrica.yandex.by/docs/en/mobile-api/post/post-import-events.md - https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-import-events.md --- > **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt # Загрузка событий Загружает информацию о событиях. Пример использования: можно передавать в AppMetrica оффлайн события, если пользователь не заходит в приложение, чтобы его совершить. Например, событие полного восстановления энергии в игре или просмотр фильма на Smart TV. Свойства событий можно передавать в параметрах запроса или в теле. При передаче данных в теле, к URL запроса необходимо добавить `.csv`. Подробнее в разделе [Пример запроса](#sample). Для привязки события к пользователю, необходимо использовать одно из следующих полей при запросе: - `profile_id` - `appmetrica_device_id` {% note alert %} Post API содержит ограничения на загрузку данных. Подробнее в разделе [Ограничения](https://appmetrica.yandex.by/docs/ru/mobile-api/post/restrictions.md). {% endnote %} ## Формат запроса ``` POST https://api.appmetrica.yandex.ru/logs/v1/import/events ? post_api_key= & application_id= & profile_id= & appmetrica_device_id= & event_name= & event_timestamp= & [event_json=] & [session_type=] & [ios_ifa=] & [ios_ifv=] & [google_aid=] & [windows_aid=] & [os_name=] & [os_version=] & [device_manufacturer=] & [device_model=] & [device_type=] & [device_locale=] & [app_version_name=] & [app_package_name=] & [connection_type=] & [operator_name=] & [mcc=] & [mnc=] & [device_ipv6=] ``` #| || `post_api_key`* | Токен для загрузки данных. Его можно получить в разделе **Настройки** вашего приложения. || || `application_id`* | Уникальный числовой идентификатор приложения в AppMetrica. || || `profile_id`* | Идентификатор профиля пользователя. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK. {% note alert %} Не передавайте значение вместе с параметром `appmetrica_device_id`. Сервер принимает только один из параметров. {% endnote %} || || `appmetrica_device_id`* | Хеш от уникального идентификатора устройства, который устанавливает AppMetrica. Post API позволяет загружать данные только для идентификаторов, которые предварительно были отправлены через SDK. {% note alert %} Не передавайте значение вместе с параметром `profile_id`. Сервер принимает только один из параметров. {% endnote %} || || `event_name`* | Имя события (как передано в SDK). || || `event_timestamp`* | Время события в формате [UNIX-time](https://en.wikipedia.org/wiki/Unix_time). Post API позволяет загрузить только те события, у которых разница между датой совершения события (`event_timestamp`) и датой загрузки не больше 14 дней. Ожидается значение в секундах. || || `event_json` | Атрибуты события, сериализованные в JSON. Параметры событий могут быть вложенными, например `{"param1":"param2","param1":{"param2":"param3"}}`. || || `session_type` | Тип сессии. Возможные значения: - `foreground` — в отчете [События](https://appmetrica.yandex.by/docs/ru/mobile-reports/events-report.md) будет увеличиваться метрика **Пользователи**. - `background` — в отчете [События](https://appmetrica.yandex.by/docs/ru/mobile-reports/events-report.md) будет увеличиваться метрика **Устройства**. Такие события не будут попадать в отчет с группировкой по пользователям и в карточку профиля. Значение по умолчанию: `background`. || || `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` | Язык интерфейса устройства. || || `app_version_name` | Версия приложения в виде, как указана разработчиком. || || `app_package_name` | Имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro). || || `connection_type` | Тип подключения устройства. Возможные значения: `wifi` \| `cell` \| `unknown`. || || `operator_name` | Имя оператора сотовой связи. || || `mcc` | Мобильный код страны. || || `mnc` | Код мобильной сети. || || `device_ipv6` | IP-адрес в момент совершения события в формате [IPv6](https://en.wikipedia.org/wiki/IPv6). Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || |# ## Коды ответа | Код | Описание | | ----- | ----- | | 200 | Данные успешно загружены. | | 403 | Запрос не содержит заголовка авторизации, либо указан неверный токен. | | 400 | Запрос не содержит одного или нескольких обязательных параметров. | ## Пример запроса {#sample} {% list tabs %} - Передача данных в теле запроса ```http translate=no POST /logs/v1/import/events.csv?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012 HTTP/1.1 Host: api.appmetrica.yandex.ru 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 ``` - Передача данных в параметрах запроса ```http translate=no POST /logs/v1/import/events?post_api_key=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ012&device_model=iPhone%20X&device_ipv6=2a02%3A6b8%3A%3A40c%3A6676%3Abaff%3Afea6%3A53d8&device_type=phone&google_aid=01234567-890a-bcde-f012-3456789abcde&app_package_name=com.yandex.sample.metrica&operator_name=MegaFon&mnc=2&application_id=1111&event_json=%7B%22key%22%3A%22value%22%7D&profile_id=1234567890123456789&event_name=event_name&event_timestamp=1234567890 HTTP/1.1 Host: api.appmetrica.yandex.ru Content-Length: 0 Connection: close ``` {% endlist %} ## Другие методы Post API {#other-methods} - [Загрузка событий In-app Revenue](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-revenue.md) - [Загрузка событий Ad Revenue](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-adrevenue.md) - [Загрузка событий Ecommerce](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-ecommerce.md) - [Атрибуты профиля](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-profile-attributes.md) Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот. Написать в службу поддержки Предложить улучшение для документации