--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/installations.md - https://appmetrica.yandex.com.tr/docs/ru/mobile-api/logs/ref/installations.md --- > **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com.tr/docs/en/llms.txt # App installations Returns installations data for a specific date range. ## Request format {#request-format} ``` GET https://api.appmetrica.yandex.com/logs/v1/export/installations.{csv | json} ? application_id= & date_since= & date_until= & fields= & [date_dimension=] & [limit=] & [use_utf8_bom=] & [=] & [skip_unavailable_shards=] ``` #| || `application_id`* | Filtering by the app's numeric ID in AppMetrica || || `date_since`* | Start of the date range in `yyyy-mm-dd hh:mm:ss` format. You can also define the date and time type that affects the data in the `date_dimension` query parameter. || || `date_until`* | End of the date range in `yyyy-mm-dd hh:mm:ss` format. You can also define the date and time type that affects the data in the `date_dimension` query parameter. || || `fields`* | A comma-separated [list of fields](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/endpoints.md) for the sample. A list that contains all available fields (for quick copy): ```objectivec translate=no application_id,installation_id,attributed_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,fingerprint_method,appmetrica_device_id,city,connection_type,country_iso_code,device_locale,device_manufacturer,device_model,device_type,google_aid,oaid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,windows_aid,app_package_name,app_version_name ``` || || `date_dimension` | This parameter defines the point to calculate the date range from: - `default`: When the event occurred on the device. - `receive`: When the server received information about the event. || || `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 `false`. || || `` | Filtering by the value of one of the available fields. Only the equality check operation is supported. || || `skip_unavailable_shards` | Used for [improving data accessibility](../request-procedure.md#availability). The default value is `false`. || |# ## Response format {#response-format} If all available fields are requested: {% list tabs %} - JSON ```json translate=no { "data": [ { "application_id": "integer", "installation_id": "string", "attributed_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", "fingerprint_method": "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", "oaid": "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" }, ... ] } ``` - CSV ``` application_id,ios_ifa,os_name,... 1111,024AE7EB-4128-4237-9803-D24950323D4D,ios,... 1111,3A86D5E8-1985-4A23-B147-5A1C0CF8781E,ios,... 1111,,android ... ``` {% endlist %} #| || `application_id` | Unique numeric identifier for the application in AppMetrica. || || `installation_id` | Installation ID. || || `attributed_touch_type`| Ad interaction type: `click` \| `impression` \| `unknown`. || || `click_datetime` | Date and time of the click/impression in `yyyy-mm-dd hh:mm:ss` format. || || `click_id` | ID of the click/impression or `''` (an empty string if the ID is not available). || || `click_ipv6` | IP address at the time of the click/impression in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example: `2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147`. || || `click_timestamp` | Time of the click/impression in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format, in seconds. || || `click_url_parameters` | Parameters as they are shown in the URL. Special characters must be escaped (for example, `?param1=1¶m2=2...` will look like `?param1%3D1%26param2%3D2...` in the request). || || `click_user_agent` | User-agent of the click/impression. || || `profile_id` | User profile ID. || || `publisher_id` | ID of the AppMetrica publisher. || || `publisher_name` | Name of the AppMetrica partner. || || `tracker_name` | Name of the tracker being added to the AppMetrica interface. || || `tracking_id` | ID of the AppMetrica tracker. || || `install_datetime` | Date and time of the installation in `yyyy-mm-dd hh:mm:ss`. || || `install_ipv6` | The IP address at the time of the installation in [IPv6](https://en.wikipedia.org/wiki/IPv6) format (for example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147). || || `install_receive_datetime` | Date and time when the install event was received on the server side. May differ from `install_datetime` due to network delays or if the user's device was not connected at the time of the event. || || `install_receive_timestamp` | Time when the install event was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. May differ from `install_timestamp` due to network delays or if the user's device was not connected at the time of the event. || || `install_timestamp` | Time of the installation in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format, in seconds. || || `is_reattribution` | Whether the installation is reattributed to the new source. Possible values: `true` \| `false`. || || `is_reinstallation` | Whether the app has been reinstalled. Possible values: `true` \| `false`. || || `match_type` | [Attribution method](https://appmetrica.yandex.com.tr/docs/en/mobile-tracking/technology.md): `fingerprint` \| `referrer` \| `identifier` \| `''` (empty string). || || `fingerprint_method` | The method that was effective for attribution using `fingerprint`. Possible values: - `unknown` - `fingerprint` - `ctv` - `desktop` || || `appmetrica_device_id` | A unique device identifier detected by the AppMetrica service. In Android from [AppSetId](https://developer.android.com/identity/app-set-id), in iOS from [IFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). || || `city` | The name of the city in English. || || `connection_type` | Type of connection. Possible values: `wifi` \| `cell` \| `unknown`. || || `country_iso_code` | ISO country code. || || `device_locale` | The language on the device. || || `device_manufacturer` | The device manufacturer detected by the AppMetrica service (for example, Apple or Samsung). || || `device_model` | The device model detected by the AppMetrica service (for example, Galaxy S6). || || `device_type` | The device type detected by the AppMetrica service. Possible values: `phone` \| `tablet` \| `unknown`. || || `google_aid` | The device's Google AID in the format received from the device. || || `oaid` | The device's Huawei OAID in the format received from the device. || || `ios_ifa` | The device's IFA in the format received from the device. || || `ios_ifv` | IFV for the app in the format received from the device. || || `mcc` | Mobile country code. || || `mnc` | Mobile network code. || || `operator_name` | Name of the mobile operator. || || `os_name` | Operating system on the user's device: `ios` \| `android` \| `windows`. || || `os_version` | The version of the operating system on the user's device. || || `windows_aid` | The device's Windows AID in the format received from the device. || || `app_package_name` | The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro). || || `app_version_name` | The app version in the format specified by the developer. || |# ## Example {#example} Request: ```bash translate=no curl -X GET \ 'https://api.appmetrica.yandex.com/logs/v1/export/installations.json?application_id=1111&date_since=2018-10-10&date_until=2018-10-11&fields=application_id,installation_id,attributed_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,fingerprint_method,appmetrica_device_id,city,connection_type,country_iso_code,device_locale,device_manufacturer,device_model,device_type,google_aid,oaid,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' ``` Response: ```json translate=no { "data": [ { "application_id": "1111", "installation_id": "fdfssd23432", "attributed_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": "Advertising 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", "fingerprint_method": "ctv", "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": "", "oaid": "", "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" } ] } ``` If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible. Contact support Suggest an improvement for documentation