Sessions starts
Returns session data for a specific date range.
Request format
GET https://api.appmetrica.yandex.ru/logs/v1/export/sessions_starts.{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": [
{
"session_id": "integer",
"session_start_datetime": "string",
"session_start_receive_datetime": "string",
"session_start_receive_timestamp": "integer",
"session_start_timestamp": "integer",
"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"
},
...
]
}
application_id,ios_ifa,os_name,...
1111,024AE7EB-4128-4237-9803-D24950323D4D,ios,...
1111,3A86D5E8-1985-4A23-B147-5A1C0CF8781E,ios,...
1111,,android
...
session_id
session_start_datetime
yyyy-mm-dd hh:mm:ss
format.session_start_receive_datetime
yyyy-mm-dd hh:mm:ss
format. It may differ from session_datetime
due to network delays or problems with the user's internet connection.session_start_receive_timestamp
session_timestamp
due to network delays or problems with the user's internet connection.session_start_timestamp
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/sessions_starts.json?application_id=1111&date_since=2018-10-10&date_until=2018-10-11&fields=session_id,session_start_datetime,session_start_receive_datetime,session_start_receive_timestamp,session_start_timestamp,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": [
{
"session_id": "10000000049",
"session_start_datetime": "yyyy-mm-dd hh:mm:ss",
"session_start_receive_datetime": "yyyy-mm-dd hh:mm:ss",
"session_start_receive_timestamp": "1556258667",
"session_start_timestamp": "1556258660",
"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"
}
]
}