App installations
Returns installations data for a specific date range.
Request format
GET https://api.appmetrica.yandex.ru/logs/v1/export/installations.{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": [ { "application_id": "integer", "attribution_touch_type": "string", "click_datetime": "string", "click_id": "string", "click_ipv6": "string", "click_timestamp": "integer", "click_url_parameters": "string", "click_user_agent": "string", "profile_id": "string", "publisher_id": "integer", "publisher_name": "string", "tracker_name": "string", "tracking_id": "integer", "install_datetime": "string", "install_ipv6": "string", "install_receive_datetime": "string", "install_receive_timestamp": "integer", "install_timestamp": "integer", "is_reattribution": "boolean", "is_reinstallation": "boolean", "match_type": "string", "appmetrica_device_id": "integer", "city": "string", "connection_type": "string", "country_iso_code": "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", "os_name": "string", "os_version": "string", "windows_aid": "string", "app_package_name": "string", "app_version_name": "string" }, ... ] }
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
...
application_id
attribution_touch_type
click
| impression
| ''
(empty string).click_datetime
yyyy-mm-dd hh:mm:ss
format.click_id
''
(an empty string if the ID is not available).click_ipv6
click_timestamp
click_url_parameters
?param1=1¶m2=2...
will look like ?param1%3D1%26param2%3D2...
in the request).click_user_agent
profile_id
publisher_id
publisher_name
tracker_name
tracking_id
install_datetime
yyyy-mm-dd hh:mm:ss
format.install_ipv6
install_receive_datetime
install_datetime
due to network delays or if the user's device was not connected at the time of the event.install_receive_timestamp
install_timestamp
due to network delays or if the user's device was not connected at the time of the event.install_timestamp
is_reattribution
true
| false
.is_reinstallation
true
| false
.match_type
fingerprint
| referrer
|identifier
| ''
(empty string).appmetrica_device_id
city
connection_type
wifi
| cell
| unknown
.country_iso_code
device_locale
device_manufacturer
device_model
device_type
phone
| tablet
| unknown
.google_aid
ios_ifa
ios_ifv
mcc
mnc
operator_name
os_name
ios
| android
| windows
.os_version
windows_aid
app_package_name
app_version_name
Example
curl -X GET \ 'https://api.appmetrica.yandex.ru/logs/v1/export/installations.json?application_id=1111&date_since=2018-10-10&date_until=2018-10-11&fields=application_id,attribution_touch_type,click_datetime,click_id,click_ipv6,click_timestamp,click_url_parameters,click_user_agent,profile_id,publisher_id,publisher_name,tracker_name,tracking_id,install_datetime,install_ipv6,install_receive_datetime,install_receive_timestamp,install_timestamp,is_reattribution,is_reinstallation,match_type,appmetrica_device_id,city,connection_type,country_iso_code,device_locale,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,windows_aid,app_package_name,app_version_name' \ -H 'Authorization: OAuth oauth_token'
Copied to clipboard
Response:
{ "data": [ { "application_id": "1111", "attribution_touch_type": "click", "click_datetime": "yyyy-mm-dd hh:mm:ss", "click_id": "f2ae4254de8844dda58b29cac2cf0e87", "click_ipv6": "::ffff:5.255.232.147", "click_timestamp": "1556258660", "click_url_parameters": "click_id=f2ae4254de8844dda58b29cac2cf0e87&c=1234&google_aid=&google_aid_sha1=&google_aid_md5=&ios_ifa=&ios_ifa_sha1=&ios_ifa_md5&click_timestamp=1554824136&afpub_id=&site_id=&creative_id=&goal_id1=&goal_id2 ", "click_user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1 Mobile/15E148 Safari/604.1", "profile_id": "test", "publisher_id": "39", "publisher_name": "AdColony", "tracker_name": "Аdvertising iOS campaign", "tracking_id": "12345678901234567890", "install_datetime": "yyyy-mm-dd hh:mm:ss", "install_ipv6": "::ffff:5.255.232.147", "install_receive_datetime": "yyyy-mm-dd hh:mm:ss", "install_receive_timestamp": "1556258667", "install_timestamp": "1556258660", "is_reattribution": "false", "is_reinstallation": "false", "match_type": "fingerprint", "appmetrica_device_id": "123456789012345678", "city": "Moscow", "connection_type": "wifi", "country_iso_code": "RU", "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", "os_name": "ios", "os_version": "12.2", "windows_aid": "", "app_package_name": "ru.yandex.metro", "app_version_name": "1.0" } ] }
Copied to clipboard