Events
Returns event data for a specific date range.
Request format
GET https://api.appmetrica.yandex.ru/logs/v1/export/events.{csv | json}
? application_id=<int>
& date_since=<string>
& date_until=<string>
& fields=<string>
& [date_dimension=<string>]
& [limit=<string>]
& [use_utf8_bom=<bool>]
& [<any field name>=<string>]
application_id * | Filtering by the app's numeric ID in AppMetrica |
date_since * | Start of the date range in the |
date_until * | End of the date range in the |
fields * | A comma-separated list of fields for the sample. A list that contains all available fields (for quick copy):
|
date_dimension | The parameter defines what date and time are used as a condition for getting into the data sample:
|
limit | Limit on the number of items in the list. Takes the maximum value by default. There is no guarantee that results will match from request to request (there may be differences in results sorting). |
use_utf8_bom | Parameter that enables the use of byte order mark. The default value is |
<any field name> | Filtering by the value of one of the available fields. Only the equality check operation is supported. |
application_id * | Filtering by the app's numeric ID in AppMetrica |
date_since * | Start of the date range in the |
date_until * | End of the date range in the |
fields * | A comma-separated list of fields for the sample. A list that contains all available fields (for quick copy):
|
date_dimension | The parameter defines what date and time are used as a condition for getting into the data sample:
|
limit | Limit on the number of items in the list. Takes the maximum value by default. There is no guarantee that results will match from request to request (there may be differences in results sorting). |
use_utf8_bom | Parameter that enables the use of byte order mark. The default value is |
<any field name> | Filtering by the value of one of the available fields. Only the equality check operation is supported. |
* Required
Response format
{ "data": [ { "event_datetime": "string", "event_json": "string", "event_name": "string", "event_receive_datetime": "string", "event_receive_timestamp": "integer", "event_timestamp": "integer", "session_id": "integer", "installation_id": "string", "appmetrica_device_id": "integer", "city": "string", "connection_type": "string", "country_iso_code": "string", "device_ipv6": "string", "device_locale": "string", "device_manufacturer": "string", "device_model": "string", "device_type": "string", "google_aid": "string", "ios_ifa": "string", "ios_ifv": "string", "mcc": "integer", "mnc": "integer", "operator_name": "string", "original_device_model": "string", "os_name": "string", "os_version": "string", "profile_id": "string", "windows_aid": "string", "app_build_number": "integer", "app_package_name": "string", "app_version_name": "string", "application_id": "integer" }, ... ] }
Copied to clipboard
application_id,ios_ifa,os_name,...
1111,024AE7EB-4128-4237-9803-D24950323D4D,ios,...
1111,3A86D5E8-1985-4A23-B147-5A1C0CF8781E,ios,...
1111,,android
...
event_datetime
yyyy-mm-dd hh:mm:ss
format.event_json
event_name
event_receive_datetime
event_datetime
due to network delays or if the user's device was not connected at the time of the event.event_receive_timestamp
event_timestamp
due to network delays or if the user's device was not connected at the time of the event.event_timestamp
session_id
installation_id
appmetrica_device_id
city
connection_type
wifi
| cell
| unknown
.country_iso_code
device_ipv6
device_locale
device_manufacturer
device_model
device_type
phone
| tablet
| unknown
.google_aid
ios_ifa
ios_ifv
mcc
mnc
operator_name
original_device_model
os_name
ios
| android
| windows
.os_version
profile_id
windows_aid
app_build_number
app_package_name
app_version_name
application_id
Example
curl -X GET \ 'https://api.appmetrica.yandex.ru/logs/v1/export/events.json?application_id=1111&date_since=2018-10-10&date_until=2018-10-11&fields=event_datetime,event_json,event_name,event_receive_datetime,event_receive_timestamp,event_timestamp,session_id,installation_id,appmetrica_device_id,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,original_device_model,os_name,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name,application_id' \ -H 'Authorization: OAuth oauth_token'
Copied to clipboard
Response:
{ "data": [ { "event_datetime": "yyyy-mm-dd hh:mm:ss", "event_json": "{\"name\":\"Alice\", \"age\":\"18\", \"favorite_games\":{\"strategies\":\"Age of Empires\"}}", "event_name": "New person", "event_receive_datetime": "yyyy-mm-dd hh:mm:ss", "event_receive_timestamp": "1556258667", "event_timestamp": "1556258660", "session_id": "10000000049", "installation_id": "", "appmetrica_device_id": "123456789012345678", "city": "Moscow", "connection_type": "wifi", "country_iso_code": "RU", "device_ipv6": "::ffff:5.255.232.147", "device_locale": "ru_RU", "device_manufacturer": "Apple", "device_model": "iPhone X", "device_type": "phone", "google_aid": "", "ios_ifa": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ios_ifv": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "mcc": "250", "mnc": "1", "operator_name": "MTS RUS", "original_device_model": "iPhone10,3", "os_name": "ios", "os_version": "12.2", "profile_id": "test", "windows_aid": "", "app_build_number": "1", "app_package_name": "ru.yandex.metro", "app_version_name": "1.0", "application_id": "1111" } ] }
Copied to clipboard