Available endpoints

Clicks

/logs/v1/export/clicks.{csv | json | parts}

Available attributes:

Tracking information
Field Description
application_id Unique numeric identifier for the application in AppMetrica.
click_datetime Date and time of the click in the yyyy-mm-dd hh:mm:ss format.
click_id ID of the click or '' (an empty string, if the ID is not available)
click_ipv6 IP address at the time of the click, in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147
click_timestamp Time of the click in UNIX timestamp format, in seconds.
click_url_parameters Parameters as they are shown in the URL. Special characters must be escaped (for example, ?param1=1&param2=2... will look like ?param1%3D1%26param2%3D2... in the request)
click_user_agent User-agent of the click.
profile_id User profile ID.
publisher_id ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports.
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. You may use it to identify the publisher in AppMetrica reports.
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.
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

/logs/v1/export/installations.{csv | json | parts}

Available attributes:

Tracking information
Field Description
application_id Unique numeric identifier for the application in AppMetrica.
click_datetime Date and time of the click in the yyyy-mm-dd hh:mm:ss format.
click_id ID of the click or '' (an empty string, if the ID is not available)
click_ipv6 IP address at the time of the click, in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147
click_timestamp Time of the click in UNIX timestamp format, in seconds.
click_url_parameters Parameters as they are shown in the URL. Special characters must be escaped (for example, ?param1=1&param2=2... will look like ?param1%3D1%26param2%3D2... in the request)
click_user_agent User-agent of the click.
profile_id User profile ID.
publisher_id ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports.
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. You may use it to identify the publisher in AppMetrica reports.
Installation information
Field Description
install_datetime Date and time of the installation in the yyyy-mm-dd hh:mm:ss format.
install_ipv6 The IP address at the time of installation, in 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 timestamp 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 installation in UNIX timestamp 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: fingerprint | referrer | identifier | '' (empty string).
Device and OS information
Field Description
appmetrica_device_id A unique device identifier detected by the AppMetrica service.
city The name of the city where the click was made (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.
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.

Postbacks

/logs/v1/export/postbacks.{csv | json | parts}

Available attributes:

Tracking information
Field Description
application_id Unique numeric identifier for the application in AppMetrica.
click_datetime Date and time of the click in the yyyy-mm-dd hh:mm:ss format.
click_id ID of the click or '' (an empty string, if the ID is not available)
click_ipv6 IP address at the time of the click, in IPv6 format. For example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147
click_timestamp Time of the click in UNIX timestamp format, in seconds.
click_url_parameters Parameters as they are shown in the URL. Special characters must be escaped (for example, ?param1=1&param2=2... will look like ?param1%3D1%26param2%3D2... in the request)
click_user_agent User-agent of the click.
profile_id User profile ID.
publisher_id ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports.
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. You may use it to identify the publisher in AppMetrica reports.
Installation and re-engagement information
Field Description
install_datetime Date and time of the installation (for CPI postback), or re-engagement (for CPR postback) in the yyyy-mm-dd hh: mm: ss format.
install_ipv6 The IP address at the time of installation (for CPI postback), or re-engagement (for CPR postback) in IPv6 format (for example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147).
install_timestamp Installation time (for CPI postback) or re-engagement (CPR postback) in seconds in the UNIX timestamp format.
match_type Attribution method: 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.
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.
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.
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.
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 the 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 the UNIX timestamp 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 the yyyy-mm-dd hh:mm:ss format.
attempt_timestamp Time sent in 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

/logs/v1/export/events.{csv | json | parts}

Available attributes:

Event and session information
Field Description
event_datetime Date and time of the event in the yyyy-mm-dd hh:mm:ss format.
event_json Event attributes in the JSON-serialized 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 the UNIX timestamp 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 the UNIX timestamp format.
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
appmetrica_device_id A unique device identifier detected by the AppMetrica service.
city The name of the city where the click was made (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 event, in the 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 Device model from the manufacturer (e.g. for Galaxy S8 the following values are possible: SM-G9550, SM-G9558, etc.).
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.

Profiles

/logs/v1/export/profiles.{csv | json | parts}

Available attributes:

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.
<any attribute 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 The Android device ID.
appmetrica_device_id A unique device identifier detected by the AppMetrica service.
city The name of the city where the click was made (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

Type of framework.

Returns one of the following possible 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.

Openings via deeplink

/logs/v1/export/deeplinks.{csv | json | parts}

Available attributes:

Tracking information
Field Description
deeplink_url_host The deeplink domain name. For example, for the following link [scheme]:[//host][/path][?parameters], it returns host.
deeplink_url_parameters Parameters that are passed to deeplink. For more information about transmitting parameters, see Parameters of the tracking URL.
deeplink_url_path URL path of the deeplink. For example, for the following link [scheme]:[//host][/path][?parameters], it returns path.
deeplink_url_scheme URL scheme of the deeplink. For example, for the following link [scheme]:[//host][/path][?parameters], it returns scheme.
event_datetime Date and time of the event in the 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 the UNIX timestamp 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 the UNIX timestamp format.
is_reengagement Indicates that the tracker was created for a remarketing campaign.
profile_id User profile ID.
publisher_id ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports.
publisher_name Name of the AppMetrica partner.
session_id Session ID.
tracker_name Name of the tracker being added to the AppMetrica interface
tracking_id ID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports.
Device and OS information
Field Description
android_id The Android device ID.
appmetrica_device_id A unique device identifier detected by the AppMetrica service.
appmetrica_sdk_version Version of the AppMetrica SDK.
city The name of the city where the click was made (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 event, in the 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 Device model from the manufacturer (e.g. for Galaxy S8 the following values are possible: SM-G9550, SM-G9558, etc.).
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

/logs/v1/export/push_tokens.{csv | json | parts}

Available attributes:

Information about push tokens
Field Description
token Push token value.
token_datetime Time of push token creation in the yyyy-mm-dd hh:mm:ss format.
token_receive_datetime Time when the server received the token, in the 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 server received the token, in the UNIX timestamp 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 the Unix timestamp format
Device and OS information
Field Description
appmetrica_device_id A unique device identifier detected by the AppMetrica service.
city The name of the city where the click was made (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 event, in the 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.

App crashes

/logs/v1/export/crashes.{csv | json | parts}

Available attributes:

Information about an app crash
Field Description
crash Stack trace.
crash_datetime Date and time of the app crash in the 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 The date and time the crash message was received on the server, in the 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 The time when the server received the crash message, in the UNIX-time format. It may differ from crash_timestamp due to network delays or problems with the user's internet connection.
crash_timestamp The time of the app crash in the UNIX-time format.
Device and OS information
Field Description
appmetrica_device_id A unique device identifier detected by the AppMetrica service.
city The name of the city where the click was made (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 event, in the 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.

Errors

/logs/v1/export/errors.{csv | json | parts}

Available attributes:

Information about app errors
Field Description
error Error text.
error_datetime Date and time of the error in the yyyy-mm-dd hh:mm:ss format.
error_id Error ID.
error_name Error name.
error_receive_datetime The time when the server received the error message, in the 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 the 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 the UNIX-time format.
Device and OS information
Field Description
appmetrica_device_id A unique device identifier detected by the AppMetrica service.
city The name of the city where the click was made (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 event, in the 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.

Sessions starts

/logs/v1/export/sessions_starts.{csv | json | parts}

Available attributes:

Session information
Field Description
session_id Session ID.
session_start_datetime Date and time of the session start in the yyyy-mm-dd hh:mm:ss format.
session_start_receive_datetime The time when the server received the session start message, in the 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 the 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 the UNIX time format.
Device and OS information
Field Description
appmetrica_device_id A unique device identifier detected by the AppMetrica service.
city The name of the city where the click was made (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 event, in the 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 Device model from the manufacturer (e.g. for Galaxy S8 the following values are possible: SM-G9550, SM-G9558, etc.).
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.