--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/endpoints.md - https://appmetrica.yandex.com.tr/docs/ru/mobile-api/logs/endpoints.md --- > **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com.tr/docs/en/llms.txt # Available endpoints ## Tracking clicks and impressions {#clicks} ```no-highlight translate=no /logs/v1/export/clicks.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/clicks.md). Available fields: ```no-highlight translate=no application_id,click_datetime,click_id,click_ipv6,click_timestamp,click_url_parameters,click_user_agent,publisher_id,publisher_name,tracker_name,tracking_id,touch_type,is_bot,city,country_iso_code,device_manufacturer,device_model,device_type,google_aid,oaid,ios_ifa,ios_ifv,os_name,os_version,windows_aid ``` Tracking information #| || **Field** | **Description** || || `application_id` | Unique numeric identifier for the application in AppMetrica. || || `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. || || `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. || || `touch_type` | Type: click or impression. Possible values: `click` \| `impression` \| `unknown`. || || `is_bot` | Indicates a non-browser click. || |# Device Information (based on click recognition) #| || **Field** | **Description** || || `city` | The name of the city where the click was made (in English). || || `country_iso_code` | ISO country code. || || `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. || || `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 installations {#installations} ```no-highlight translate=no /logs/v1/export/installations.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/installations.md). Available fields: ```no-highlight 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,android_id,appmetrica_device_id,appmetrica_sdk_version,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_build_number,app_package_name,app_version_name ``` Tracking information #| || **Field** | **Description** || || `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. || |# Installation information #| || **Field** | **Description** || || `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. Acceptable values: - `unknown` - `fingerprint` - `ctv` - `desktop` || |# Device and operating system information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `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 information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || |# ## Postbacks {#postback} ```no-highlight translate=no /logs/v1/export/postbacks.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/postbacks.md). Available fields: ```no-highlight translate=no application_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_timestamp,match_type,appmetrica_device_id,city,country_iso_code,device_locale,device_manufacturer,device_model,device_type,google_aid,oaid,ios_ifa,os_name,os_version,windows_aid,app_package_name,app_version_name,conversion_datetime,conversion_timestamp,event_name,attempt_datetime,attempt_timestamp,cost_model (postback_type),notifying_status,postback_url,postback_url_parameters,response_body,response_code ``` Tracking information #| || **Field** | **Description** || || `application_id` | Unique numeric identifier for the application in AppMetrica. || || `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. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0. || || `publisher_name` | Name of the AppMetrica partner. If unattributed postbacks are enabled for the tracker, the field value will be empty. || || `tracker_name` | Name of the tracker being added to the AppMetrica interface. If unattributed postbacks are enabled for the tracker, the field value will be empty. || || `tracking_id` | ID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0. || |# Installation and re-engagement information #| || **Field** | **Description** || || `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_timestamp` | Time of the installation in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format, in seconds. || || `match_type` | [Attribution method](https://appmetrica.yandex.com.tr/docs/en/mobile-tracking/technology.md): `fingerprint` \| `referrer` \| `identifier` \| `''` (empty string). || |# Device Information (based on click recognition) #| || **Field** | **Description** || || `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 where the click was made (in English). || || `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. || || `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 information #| || **Field** | **Description** || || `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. || |# Event information #| || **Field** | **Description** || || `conversion_datetime` | Date and time of the event (for CPA postback), installation (for CPI postback), or re-engagement (for CPR postback) in `yyyy-mm-dd hh:mm:ss` format. || || `conversion_timestamp` | Time of the event (for CPA postback), installation (for CPI postback), or re-engagement (for CPR postback) in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. || || `event_name` | Name of the event (as passed to the SDK). || |# Information about the postback #| || **Field** | **Description** || || `attempt_datetime` | Date and time of sending in yyyy-mm-dd hh:mm:ss` format. || || `attempt_timestamp` | Time of sending in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. || || `cost_model (postback_type)` | Postback type. Possible values: `cpi` (installation) \| `cpa` (event) \| `cpr` (re-engagement). || || `notifying_status` | The status of the postback sending (`failed` \| `sent`). The same postback may appear multiple times in the response if sending failed. || || `postback_url` | Full Postback URL. || || `postback_url_parameters` | Postback URL parameters as shown in the URL. For example, `param1=1¶m2=2...`. || || `response_body` | Data received from the server. || || `response_code` | HTTP code for sending the postback. || |# ## Events {#events} ```no-highlight translate=no /logs/v1/export/events.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/events.md). Available fields: ```no-highlight translate=no event_datetime,event_json,event_name,event_receive_datetime,event_receive_timestamp,event_timestamp,session_id,installation_id,appmetrica_device_id,android_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,appmetrica_sdk_version ``` Event and session information #| || **Field** | **Description** || || `event_datetime` | Date and time of the event in `yyyy-mm-dd hh:mm:ss` format. || || `event_json` | Event attributes serialized into JSON. || || `event_name` | Name of the event (as passed to the SDK). || || `event_receive_datetime` | Date and time the event was received on the server side. May differ from `event_datetime` due to network delays or if the user's device was not connected at the time of the event. || || `event_receive_timestamp` | Time when the event was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. May differ from `event_timestamp` due to network delays or if the user's device was not connected at the time of the event. || || `event_timestamp` | Time of the event in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than 14 days. The API expects a value in seconds. || || `session_id` | Session ID. The set of values `installation_id`, `session_id` and the platform device ID (`google_aid` / `ios_ifa`) allows you to uniquely identify a user's session. || || `installation_id` | Installation ID. || |# Device and OS information #| || **Field** | **Description** || || `android_id` | Android device ID.|| || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK.|| || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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. || || `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. || || `original_device_model` | Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on). || || `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. || || `profile_id` | User profile ID. || || `windows_aid` | The device's Windows AID in the format received from the device. || |# App information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || || `application_id` | Unique numeric identifier for the application in AppMetrica. || |# ## E-commerce {#ecommerce} ```no-highlight translate=no /logs/v1/export/ecommerce_events.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/ecommerce_events.md). Available fields: ```no-highlight translate=no ecom_type,ecom_screen_name,ecom_screen_search_query,ecom_screen_payload,ecom_screen_category_path_1,ecom_screen_category_path_2,ecom_screen_category_path_3,ecom_screen_category_path_4,ecom_screen_category_path_5,ecom_screen_category_path_6,ecom_screen_category_path_7,ecom_screen_category_path_8,ecom_screen_category_path_9,ecom_screen_category_path_10,ecom_product_name,ecom_product_sku,ecom_product_promocodes,ecom_product_payload,ecom_product_category_path_1,ecom_product_category_path_2,ecom_product_category_path_3,ecom_product_category_path_4,ecom_product_category_path_5,ecom_product_category_path_6,ecom_product_category_path_7,ecom_product_category_path_8,ecom_product_category_path_9,ecom_product_category_path_10,ecom_product_actual_price_fiat_unit_type,ecom_product_actual_price_fiat_value,ecom_product_actual_price_internal_components,ecom_product_original_price_fiat_unit_type,ecom_product_original_price_fiat_value,ecom_product_original_price_internal_components,ecom_cart_item_price_fiat_unit_type,ecom_cart_item_price_fiat_value,ecom_cart_item_quantity,ecom_cart_item_internal_components,ecom_referrer_type,ecom_referrer_id,ecom_order_id,ecom_order_payload,event_datetime,event_json,event_name,event_receive_datetime,event_receive_timestamp,event_timestamp,session_id,installation_id,android_id,appmetrica_device_id,appmetrica_sdk_version,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 ``` Purchase details #| || **Field** | **Description** || || `ecom_type` | Purchase event type. Possible values: - `show_screen` - `show_product_card` - `show_product_details` - `add_cart_item` - `remove_cart_item` - `begin_checkout` - `purchase` || || `ecom_screen_name` | Screen name. || || `ecom_screen_search_query` | Search query. || || `ecom_screen_payload` | Screen parameters as passed to the SDK. The format is a JSON object with string key-value pairs, for example: ``` { "configuration": "landscape", "fullscreen": "true" } ``` || || `ecom_screen_category_path_1` | Screen category. Level 1. || || `ecom_screen_category_path_2` | Screen category. Level 2. || || `ecom_screen_category_path_3` | Screen category. Level 3. || || `ecom_screen_category_path_4` | Screen category. Level 4. || || `ecom_screen_category_path_5` | Screen category. Level 5. || || `ecom_screen_category_path_6` | Screen category. Level 6. || || `ecom_screen_category_path_7` | Screen category. Level 7. || || `ecom_screen_category_path_8` | Screen category. Level 8. || || `ecom_screen_category_path_9` | Screen category. Level 9. || || `ecom_screen_category_path_10` | Screen category. Level 10. || || `ecom_product_name` | Product name. || || `ecom_product_sku` | Product ID. || || `ecom_product_promocodes` | Product promo codes. The format is a JSON array of strings, for example: ``` ["BT79IYX", "UT5412EP"] ``` || || `ecom_product_payload` | Product parameters as passed to the SDK. The format is a JSON object with string key-value pairs, for example: ``` { "configuration": "landscape", "fullscreen": "true" } ``` || || `ecom_product_category_path_1` | Product category. Level 1. || || `ecom_product_category_path_2` | Product category. Level 2. || || `ecom_product_category_path_3` | Product category. Level 3. || || `ecom_product_category_path_4` | Product category. Level 4. || || `ecom_product_category_path_5` | Product category. Level 5. || || `ecom_product_category_path_6` | Product category. Level 6. || || `ecom_product_category_path_7` | Product category. Level 7. || || `ecom_product_category_path_8` | Product category. Level 8. || || `ecom_product_category_path_9` | Product category. Level 9. || || `ecom_product_category_path_10` | Product category. Level 10. || || `ecom_product_actual_price_fiat_unit_type` | Currency of the actual product price. || || `ecom_product_actual_price_fiat_value` | Actual product price. || || `ecom_product_actual_price_internal_components` | Components of the actual product price. The format is an array of JSON objects with one key-value pair each, for example: ``` [ { "wood": 25.01 }, { "iron": 10 } ] ``` || || `ecom_product_original_price_fiat_unit_type` | Currency of the base product price. || || `ecom_product_original_price_fiat_value` | Base product price. || || `ecom_product_original_price_internal_components` | Components of the base product price. The format is an array of JSON objects with one key-value pair each, for example: ``` [ { "wood": 25.01 }, { "iron": 10 } ] ``` || || `ecom_cart_item_price_fiat_unit_type` | Price currency for the item in the cart. || || `ecom_cart_item_price_fiat_value` | Price of the item in the cart. || || `ecom_cart_item_quantity` | Number of items in the cart. || || `ecom_cart_item_internal_components` | Price components for the item in the cart. The format is an array of JSON objects with one key-value pair each, for example: ``` [ { "wood": 25.01 }, { "iron": 10 } ] ``` || || `ecom_referrer_type` | Traffic source type. || || `ecom_referrer_id` | Traffic source ID. || || `ecom_order_id` | Purchase ID. || || `ecom_order_payload` | Purchase parameters as passed to the SDK. The format is a JSON object with string key-value pairs, for example: ``` { "configuration": "landscape", "fullscreen": "true" } ``` || |# Event and session information #| || **Field** | **Description** || || `event_datetime` | Date and time of the event in `yyyy-mm-dd hh:mm:ss` format. || || `event_name` | Name of the event (as passed to the SDK). || || `event_receive_datetime` | Date and time the event was received on the server side. May differ from `event_datetime` due to network delays or if the user's device was not connected at the time of the event. || || `event_receive_timestamp` | Time when the event was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. May differ from `event_timestamp` due to network delays or if the user's device was not connected at the time of the event. || || `event_timestamp` | Time of the event in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than 14 days. The API expects a value in seconds. || || `session_id` | Session ID. The set of values `installation_id`, `session_id` and the platform device ID (`google_aid` / `ios_ifa`) allows you to uniquely identify a user's session. || || `installation_id` | Installation ID. || |# Device and operating system information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `country` | The country name in English. || || `district` | The federal district name in English. || || `area` | The region name in English. || || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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`. || || `event_source` | Event source: `sdk` \| `import_api` \| `js` \| `system`. || || `event_datetime` | Date and time of the event in `yyyy-mm-dd hh:mm:ss` format. || || `google_aid` | The device's Google AID 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. || || `original_device_model` | Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on). || || `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. || || `profile_id` | User profile ID. || || `windows_aid` | The device's Windows AID in the format received from the device. || |# App information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || |# ## Profiles {#profiles} ``` /logs/v1/export/profiles_v2.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/profiles.md). Available fields: ```no-highlight translate=no profile_id,appmetrica_gender,appmetrica_birth_date,appmetrica_notifications_enabled,appmetrica_name,,appmetrica_crashes,appmetrica_errors,appmetrica_first_session_date,appmetrica_last_start_date,appmetrica_push_opens,appmetrica_push_send_count,appmetrica_sdk_version,appmetrica_sessions,android_id,appmetrica_device_id,city,connection_type,country_iso_code,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,windows_aid,app_build_number,app_framework,app_package_name,app_version_name ``` Information about user attributes #| || **Field** | **Description** || || `profile_id` | User profile ID. || || `appmetrica_gender` | Gender. || || `appmetrica_birth_date` | Age. || || `appmetrica_notifications_enabled` | Notifications are enabled. || || `appmetrica_name` | Name. || || `` | Name of a custom attribute. || |# Information about system attributes #| || **Field** | **Description** || || `appmetrica_crashes` | Number of crashes. || || `appmetrica_errors` | Number of errors. || || `appmetrica_first_session_date` | Date of the first session. || || `appmetrica_last_start_date` | Date when the app was last launched. || || `appmetrica_push_opens` | Number of opened push notifications. || || `appmetrica_push_send_count` | Number of sent push notifications. || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `appmetrica_sessions` | Number of sessions. || |# Device and OS information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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_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. || || `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 information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `app_framework` | Framework type. Returns one of the following values: - "0": Native. - "1": Unity. - "2": Xamarin. - "3": React. - "4": Cordova. || || `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. || |# ## Revenue {#revenue} ``` /logs/v1/export/revenue_events.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/revenue_events.md). Available fields: ```no-highlight translate=no revenue_quantity,revenue_price,revenue_currency,revenue_product_id,revenue_order_id,revenue_order_id_source,is_revenue_verified,is_revenue_autocollected,revenue_inapp_type,revenue_event_type,event_datetime,event_name,event_receive_datetime,event_receive_timestamp,event_timestamp,session_id,installation_id,android_id,appmetrica_device_id,appmetrica_sdk_version,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,event_datetime,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 ``` Revenue information #| || **Field** | **Description** || || `revenue_quantity` | Quantity of products purchased. || || `revenue_price` | Price. It can be negative, e.g. for refunds. || || `revenue_currency` | Currency code of the purchase in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. || || `revenue_product_id` | Item ID. || || `revenue_order_id` | Order ID. || || `revenue_order_id_source` | Source of the order ID. Possible values: `autogenerated` \| `user_defined`. || || `is_revenue_verified` | The flag that indicates the purchase verification in the store. Possible values: - `true`: Verified. - `false`: Verified and rejected. - `undefined`: Unknown. || || `is_revenue_autocollected` | The flag of [In-App purchase automatic tracking](../../data-collection/about-revenue#in-app-tracking). Possible values: - `true`: Collected automatically. - `false`: Sent manually. - `undefined`: Unknown. || || `revenue_inapp_type` | Purchase or subscription interaction flag. Possible values: - `one_time_purchase` - `subscription` || || `revenue_event_type` | Event subtype. Possible values: - `one_time_purchase` - `trial_subscription_started` - `intro_subscription_started` - `promo_subscription_started` - `subscription_converted` - `subscription_started` - `subscription_renewed` - `subscription_cancelled` - `subscription_uncancelled` - `subscription_expired` - `subscription_billing_issues` - `refund` - `unknown` || |# Event and session information #| || **Field** | **Description** || || `event_datetime` | Date and time of the event in `yyyy-mm-dd hh:mm:ss` format. || || `event_name` | Name of the event (as passed to the SDK). || || `event_receive_datetime` | Date and time the event was received on the server side. May differ from `event_datetime` due to network delays or if the user's device was not connected at the time of the event. || || `event_receive_timestamp` | Time when the event was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. May differ from `event_timestamp` due to network delays or if the user's device was not connected at the time of the event. || || `event_timestamp` | Time of the event in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than 14 days. The API expects a value in seconds. || || `session_id` | Session ID. The set of values `installation_id`, `session_id` and the platform device ID (`google_aid` / `ios_ifa`) allows you to uniquely identify a user's session. || || `installation_id` | Installation ID. || |# Device and OS information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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). || || `event_datetime` | Date and time of the event in `yyyy-mm-dd hh:mm:ss` format. || || `google_aid` | The device's Google AID 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. || || `original_device_model` | Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on). || || `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. || || `profile_id` | User profile ID. || || `windows_aid` | The device's Windows AID in the format received from the device. || |# App information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || |# ## App openings via a deeplink {#deeplinks} ``` /logs/v1/export/deeplinks.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/deeplinks.md). Available fields: ```no-highlight translate=no deeplink_url_host,deeplink_url_parameters,deeplink_url_path,deeplink_url_scheme,event_datetime,event_receive_datetime,event_receive_timestamp,event_timestamp,is_reengagement,profile_id,publisher_id,publisher_name,session_id,tracker_name,tracking_id,android_id,appmetrica_device_id,appmetrica_sdk_version,city,connection_type,country_iso_code,device_ipv6,device_locale,device_manufacturer,device_model,event_datetime,google_aid,ios_ifa,ios_ifv,mcc,mnc,original_device_model,os_name,os_version,windows_aid,app_build_number,app_package_name,app_version_name ``` Tracking information #| || **Field** | **Description** || || `deeplink_url_host` | Deeplink domain name. For example, for a link formatted as `[scheme]:[//host][/path][?parameters]`, it returns `host`. || || `deeplink_url_parameters` | Parameters that are passed to the deeplink. For more information about passing parameters, see [Parameters of the tracking URL](https://appmetrica.yandex.com.tr/docs/en/mobile-tracking/tracking-specification.md#to-deeplink). || || `deeplink_url_path` | URL path of the deeplink. For example, for a link formatted as `[scheme]:[//host][/path][?parameters]`, it returns `path`. || || `deeplink_url_scheme` | URL scheme of the deeplink. For example, for a link formatted as `[scheme]:[//host][/path][?parameters]`, it returns `scheme`. || || `event_datetime` | Date and time of the event in `yyyy-mm-dd hh:mm:ss` format. || || `event_receive_datetime` | Date and time the event was received on the server side. May differ from `event_datetime` due to network delays or if the user's device was not connected at the time of the event. || || `event_receive_timestamp` | Time when the event was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. May differ from `event_timestamp` due to network delays or if the user's device was not connected at the time of the event. || || `event_timestamp` | Time of the event in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. With the Post API, you can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than 14 days. The API expects a value in seconds. || || `is_reengagement` | Indicates that the tracker was created for a remarketing campaign. || || `profile_id` | User profile ID. || || `publisher_id` | ID of the AppMetrica publisher. || || `publisher_name` | Name of the AppMetrica partner. || || `session_id` | Session ID. The set of values `installation_id`, `session_id` and the platform device ID (`google_aid` / `ios_ifa`) allows you to uniquely identify a user's session. || || `tracker_name` | Name of the tracker being added to the AppMetrica interface. || || `tracking_id` | ID of the AppMetrica tracker. || |# Device and OS information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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. || || `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. || || `original_device_model` | Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on). || || `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 information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || |# ## Push tokens {#push-tokens} ``` /logs/v1/export/push_tokens.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/push_tokens.md). Available fields: ```no-highlight translate=no token,token_datetime,token_receive_datetime,token_receive_timestamp,token_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,os_name,os_version,profile_id,windows_aid,app_package_name,app_version_name,application_id ``` Information about push tokens #| || **Field** | **Description** || || `token` | Push token value. || || `token_datetime` | Time of token creation in `yyyy-mm-dd hh:mm:ss` format. || || `token_receive_datetime` | Time when the token was received on the server side in `yyyy-mm-dd hh:mm:ss` format. It may differ from `token_datetime` due to network delays or problems with the user's internet connection. || || `token_receive_timestamp` | Time when the token was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. It may differ from `token_datetime` due to network delays or problems with the user's internet connection. || || `token_timestamp` | Time of token creation in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. || |# Device and OS information #| || **Field** | **Description** || || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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. || || `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. || || `profile_id` | User profile ID. || || `windows_aid` | The device's Windows AID in the format received from the device. || |# App information #| || **Field** | **Description** || || `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. || || `application_id` | Unique numeric identifier for the application in AppMetrica. || |# ## Crashes {#crashes} ``` /logs/v1/export/crashes.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/crashes.md). Available fields: ```no-highlight translate=no crash,crash_datetime,crash_group_id,crash_id,crash_name,crash_receive_datetime,crash_receive_timestamp,crash_timestamp,android_id,appmetrica_device_id,appmetrica_sdk_version,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,os_name,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name,application_id ``` Information about an app crash #| || **Field** | **Description** || || `crash` | Stack trace. || || `crash_datetime` | Date and time of the app crash in `yyyy-mm-dd hh:mm:ss` format. || || `crash_group_id` | ID of a group of similar crashes. || || `crash_id` | Crash ID. || || `crash_name` | Crash name. || || `crash_receive_datetime` | Date and time the crash message was received on the server side in `yyyy-mm-dd hh:mm:ss` format. It may differ from `crash_datetime` due to network delays or problems with the user's internet connection || || `crash_receive_timestamp` | Time when the crash message was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. It may differ from `crash_timestamp` due to network delays or problems with the user's internet connection. || || `crash_timestamp` | Time of the app crash in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. || |# Device and OS information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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. || || `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. || || `profile_id` | User profile ID. || || `windows_aid` | The device's Windows AID in the format received from the device. || |# App information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || || `application_id` | Unique numeric identifier for the application in AppMetrica. || |# ## Errors {#errors} ``` /logs/v1/export/errors.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/errors.md). Available fields: ```no-highlight translate=no error,error_datetime,error_id,error_name,error_receive_datetime,error_receive_timestamp,error_timestamp,android_id,appmetrica_device_id,appmetrica_sdk_version,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,os_name,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name,application_id ``` Information about app errors #| || **Field** | **Description** || || `error` | Error text. || || `error_datetime` | Date and time of the error in `yyyy-mm-dd hh:mm:ss` format. || || `error_id` | Error ID. || || `error_name` | Error name. || || `error_receive_datetime` | Time when the error message was received on the server side in `yyyy-mm-dd hh:mm:ss` format. It may differ from `error_datetime` due to network delays or problems with the user's internet connection. || || `error_receive_timestamp` | Time when the error message was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. It may differ from `error_timestamp` due to network delays or problems with the user's internet connection. || || `error_timestamp` | Time of the error in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. || |# Device and OS information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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. || || `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. || || `profile_id` | User profile ID. || || `windows_aid` | The device's Windows AID in the format received from the device. || |# App information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || || `application_id` | Unique numeric identifier for the application in AppMetrica. || |# ## Session starts {#sessions_starts} ``` /logs/v1/export/sessions_starts.{csv | json} ``` See detailed description of the resource [in the reference](https://appmetrica.yandex.com.tr/docs/en/mobile-api/logs/ref/sessions_starts.md). Available fields: ```no-highlight translate=no session_id,session_start_datetime,session_start_receive_datetime,session_start_receive_timestamp,session_start_timestamp,android_id,appmetrica_device_id,appmetrica_sdk_version,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,os_name,os_version,profile_id,windows_aid,app_build_number,app_package_name,app_version_name,application_id ``` Session information #| || **Field** | **Description** || || `session_id` | Session ID. The set of values `installation_id`, `session_id` and the platform device ID (`google_aid` / `ios_ifa`) allows you to uniquely identify a user's session. || || `session_start_datetime` | Date and time of the session start in `yyyy-mm-dd hh:mm:ss` format. || || `session_start_receive_datetime` | Time when the session start message was received on the server side in `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` | Time when the session start message was received on the server side in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. It may differ from `session_timestamp` due to network delays or problems with the user's internet connection. || || `session_start_timestamp` | Time of the session start in [Unix time](https://en.wikipedia.org/wiki/Unix_time) format. || |# Device and OS information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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. || || `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.|| || `original_device_model` | Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on). || || `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. || || `profile_id` | User profile ID. || || `windows_aid` | The device's Windows AID in the format received from the device. || |# App information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || || `application_id` | Unique numeric identifier for the application in AppMetrica. || |# ## Ad Revenue {#ad_revenue} ``` /logs/v1/export/ad_revenue_events.{csv | json} ``` ```no-highlight translate=no ad_revenue_datetime,ad_revenue_timestamp,ad_revenue_receive_datetime,ad_revenue_receive_timestamp,ad_revenue,ad_revenue_currency,ad_revenue_type,ad_revenue_data_source,ad_revenue_network,ad_revenue_placement_id,ad_revenue_placement_name,ad_revenue_unit_id,ad_revenue_unit_name,ad_revenue_precision,ad_revenue_payload,session_id,installation_id,android_id,appmetrica_device_id,appmetrica_sdk_version,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 ``` Ad Revenue information #| || **Field** | **Description** || || `ad_revenue_datetime` | Date and time of the event in `yyyy-mm-dd hh:mm:ss` format. || || `ad_revenue_timestamp` | Time of the event in [UNIX timestamp](https://en.wikipedia.org/wiki/Unix_time) format. || || `ad_revenue_receive_datetime` | Date and time the event was received on the server side. May differ from `ad_revenue_datetime` due to network delays or if the user's device was not connected at the time of the event. || || `ad_revenue_receive_timestamp` | Time when the event was received on the server side, in [UNIX timestamp](https://en.wikipedia.org/wiki/Unix_time) format. May differ from `ad_revenue_timestamp` due to network delays or if the user's device was not connected at the time of the event. || || `ad_revenue` | Ad Revenue amount. || || `ad_revenue_currency` | Ad Revenue currency. || || `ad_revenue_type` | Ad Revenue type. Possible values: * `native` * `banner` * `rewarded` * `interstitial` * `mrec` * `other` || || `ad_revenue_data_source` | Flag indicating [that Ad Revenue was automatically collected](https://appmetrica.yandex.com.tr/docs/en/sdk/android/off-adrevenue.md). Possible values: * `autocollected` * `manual` || || `ad_revenue_network` | Advertising Network. || || `ad_revenue_placement_id` | Ad placement ID. || || `ad_revenue_placement_name` | Ad placement name. || || `ad_revenue_unit_id` | Ad unit ID. || || `ad_revenue_unit_name` | Ad unit name. || || `ad_revenue_precision` | Accuracy of the Ad Revenue amount (as passed to the SDK). For example, "publisher_defined" or "estimated". || || `ad_revenue_payload` | Additional data serialized into JSON. || |# Event and session information #| || **Field** | **Description** || || `session_id` | Session ID. The set of values `installation_id`, `session_id` and the platform device ID (`google_aid` / `ios_ifa`) allows you to uniquely identify a user's session. || || `installation_id` | Installation ID. || |# Device and operating system information #| || **Field** | **Description** || || `android_id` | Android device ID. || || `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). || || `appmetrica_sdk_version` | Version of the AppMetrica SDK. || || `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_ipv6` | The IP address at the time of the event in [IPv6](https://en.wikipedia.org/wiki/IPv6) format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. || || `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. || || `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. || || `original_device_model` | Factory model of the device (for example, the following values are possible for Galaxy S8: SM-G9550, SM-G9558, and so on). || || `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. || || `profile_id` | User profile ID. || || `windows_aid` | The device's Windows AID in the format received from the device. || |# App information #| || **Field** | **Description** || || `app_build_number` | App build number. || || `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. || |# 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