Available endpoints

  1. Clicks
  2. App installations
  3. Postbacks
  4. Events
  5. Profiles
  6. Push tokens
  7. App crashes
  8. Errors
  9. Sessions starts

Clicks

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

Available attributes:

Tracking information
FieldDescription
application_idUnique numeric identifier for the application in AppMetrica.
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
publisher_idID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports.
tracking_idID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports.
publisher_nameName of the AppMetrica partner.
tracker_nameName of the tracker being added to the AppMetrica interface
click_datetimeDate and time of the click in the yyyy-mm-dd hh:mm:ss format.
click_timestampTime of the click in UNIX timestamp format, in seconds.
click_ipv6IP 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_url_parametersParameters 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_idID of the click or '' (an empty string, if the ID is not available)
click_user_agentUser-agent of the click.
Device Information (based on click recognition)
FieldDescription
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
country_iso_codeISO country code.
cityThe name of the city where the click was made (in English).

App installations

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

Available attributes:

Tracking information
FieldDescription
application_idUnique numeric identifier for the application in AppMetrica.
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
publisher_idID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports.
tracking_idID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports.
publisher_nameName of the AppMetrica partner.
tracker_nameName of the tracker being added to the AppMetrica interface
click_datetimeDate and time of the click in the yyyy-mm-dd hh:mm:ss format.
click_timestampTime of the click in UNIX timestamp format, in seconds.
click_ipv6IP 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_url_parametersParameters 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_idID of the click or '' (an empty string, if the ID is not available)
click_user_agentUser-agent of the click.
Installation information
FieldDescription
match_typeAttribution method: fingerprint | referrer | identifier | '' (empty string).
install_datetimeDate and time of the installation in the yyyy-mm-dd hh:mm:ss format.
install_timestampTime of installation in UNIX timestamp format, in seconds.
install_receive_datetimeDate 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_timestampTime 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_ipv6The IP address at the time of installation, in IPv6 format (for example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147).
is_reinstallationWhether the app has been reinstalled. Possible values: true | false.
is_reattributionWhether the installation is reattributed to the new source. Possible values: true | false.
Device and OS information
FieldDescription
appmetrica_device_idA unique device identifier detected by the AppMetrica service.
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
device_localeThe language on the device.
connection_typeType of connection. Possible values: wifi | cell | unknown.
operator_nameName of the mobile operator.
mccMobile country code.
mncMobile network code.
country_iso_codeISO country code.
cityThe name of the city where the click was made (in English).
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
App information
FieldDescription
application_idUnique numeric identifier for the application in AppMetrica.
app_version_nameThe app version in the format specified by the developer.
app_package_nameThe package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).

Postbacks

/logs/v1/export/postbacks.{csv | json | parts}
Available attributes:
Tracking information
FieldDescription
application_idUnique numeric identifier for the application in AppMetrica.
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
publisher_idID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports.
tracking_idID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports.
publisher_nameName of the AppMetrica partner.
tracker_nameName of the tracker being added to the AppMetrica interface
click_datetimeDate and time of the click in the yyyy-mm-dd hh:mm:ss format.
click_timestampTime of the click in UNIX timestamp format, in seconds.
click_ipv6IP 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_url_parametersParameters 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_idID of the click or '' (an empty string, if the ID is not available)
click_user_agentUser-agent of the click.
Installation information
FieldDescription
match_typeAttribution method: fingerprint | referrer | identifier | '' (empty string).
install_datetimeDate and time of the installation in the yyyy-mm-dd hh:mm:ss format.
install_timestampTime of installation in UNIX timestamp format, in seconds.
install_ipv6The IP address at the time of installation, in IPv6 format (for example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147).
Device Information (based on click recognition)
FieldDescription
appmetrica_device_idA unique device identifier detected by the AppMetrica service.
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
device_localeThe language on the device.
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
App information
FieldDescription
application_idUnique numeric identifier for the application in AppMetrica.
app_version_nameThe app version in the format specified by the developer.
app_package_nameThe package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).
Event information
FieldDescription
event_nameName of the CPA postback event.
conversion_datetimeDate and time of the event (for CPA postback) or install (for CPI postback) in the yyyy-mm-dd hh:mm:ss format.
conversion_timestampTime of the event (for CPA postback) or install (for CPI postback) in the UNIX timestamp format.
Information about the postback
FieldDescription
cost_model (postback_type)cpi | cpa
postback_urlFull Postback URL.
postback_url_parametersPostback URL parameters as shown in the URL. For example:
?param1=1&param2=2...
attempt_timestampTime sent in UNIX-time format.
attempt_datetimeDate and time of sending in the yyyy-mm-dd hh:mm:ss format.
notifying_statusThe status of the postback sending (failed | sent). The same postback may appear multiple times in the response if sending failed.
response_codeHTTP code for sending the postback.
response_bodyData received from the server.

Events

/logs/v1/export/events.{csv | json | parts}
Available attributes:
Event and session information
FieldDescription
event_nameName of the event (as passed to the SDK).
event_jsonEvent attributes in the JSON-serialized format.
event_datetimeDate and time of the event in the yyyy-mm-dd hh:mm:ss format.
event_timestampTime of the event in the UNIX timestamp format.
event_receive_datetimeDate 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_timestampTime 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.
session_idSession ID.
Device and OS information
FieldDescription
appmetrica_device_idA unique device identifier detected by the AppMetrica service.
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
original_device_modelDevice model from the manufacturer (e.g. for Galaxy S8 the following values are possible: SM-G9550, SM-G9558, etc.).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
device_localeThe language on the device.
connection_typeType of connection. Possible values: wifi | cell | unknown.
operator_nameName of the mobile operator.
mccMobile country code.
mncMobile network code.
country_iso_codeISO country code.
cityThe name of the city where the click was made (in English).
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
device_ipv6The 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
App information
FieldDescription
app_build_numberApp build number.
application_idUnique numeric identifier for the application in AppMetrica.
app_version_nameThe app version in the format specified by the developer.
app_package_nameThe package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).

Profiles

/logs/v1/export/profiles.{csv | json | parts}
Available attributes:
Information about user attributes
FieldDescription
profile_idUser profile ID.
appmetrica_gender

Gender.

appmetrica_birth_dateAge.
appmetrica_notifications_enabledNotifications are enabled.
appmetrica_nameName.
<any attribute name>Name of a custom attribute.
Information about system attributes
FieldDescription
appmetrica_crashesNumber of crashes.
appmetrica_errorsNumber of errors.
appmetrica_first_session_dateDate of the first session.
appmetrica_last_start_dateDate when the app was last launched.
appmetrica_sdk_versionVersion of the AppMetrica SDK.
appmetrica_push_send_countNumber of sent push notifications.
appmetrica_push_opensNumber of opened push notifications.
appmetrica_sessionsNumber of sessions.
Device and OS information
FieldDescription
appmetrica_device_idA unique device identifier detected by the AppMetrica service.
android_idThe Android device ID.
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
connection_typeType of connection. Possible values: wifi | cell | unknown.
operator_nameName of the mobile operator.
mccMobile country code.
mncMobile network code.
country_iso_codeISO country code.
cityThe name of the city where the click was made (in English).
App information
FieldDescription
app_build_numberApp build number.
app_frameworkType of framework.
Returns one of the following possible values:
  • "0" — Native.
  • "1" — Unity.
  • "2" — Xamarin.
  • "3" — React.
  • "4" — Cordova.
app_version_nameThe app version in the format specified by the developer.
app_package_nameThe package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).

Push tokens

/logs/v1/export/push_tokens.{csv | json | parts}
Available attributes:
Information about push tokens
FieldDescription
tokenPush token value.
token_datetimeTime of push token creation in the yyyy-mm-dd hh:mm:ss format.
token_timestampTime of token creation in the Unix timestamp format
token_receive_datetimeTime 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_timestampTime 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
Device and OS information
FieldDescription
appmetrica_device_idA unique device identifier detected by the AppMetrica service.
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
device_localeThe language on the device.
connection_typeType of connection. Possible values: wifi | cell | unknown.
operator_nameName of the mobile operator.
mccMobile country code.
mncMobile network code.
country_iso_codeISO country code.
cityThe name of the city where the click was made (in English).
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
device_ipv6The 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
App information
FieldDescription
application_idUnique numeric identifier for the application in AppMetrica.
app_version_nameThe app version in the format specified by the developer.
app_package_nameThe package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).

App crashes

/logs/v1/export/crashes.{csv | json | parts}
Available attributes:
Information about an app crash
FieldDescription
crashStack trace.
crash_nameCrash name.
crash_idCrash ID.
crash_group_idID of a group of similar crashes.
crash_datetimeDate and time of the app crash in the yyyy-mm-dd hh:mm:ss format.
crash_timestampThe time of the app crash in the UNIX-time format.
crash_receive_datetimeThe 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_timestampThe 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.
Device and OS information
FieldDescription
appmetrica_device_idA unique device identifier detected by the AppMetrica service.
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
device_localeThe language on the device.
connection_typeType of connection. Possible values: wifi | cell | unknown.
operator_nameName of the mobile operator.
mccMobile country code.
mncMobile network code.
country_iso_codeISO country code.
cityThe name of the city where the click was made (in English).
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
device_ipv6The 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
App information
FieldDescription
application_idUnique numeric identifier for the application in AppMetrica.
app_version_nameThe app version in the format specified by the developer.
app_package_nameThe package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).

Errors

/logs/v1/export/errors.{csv | json | parts}
Available attributes:
Information about app errors
FieldDescription
errorError text.
error_nameError name.
error_idError ID.
error_datetimeDate and time of the error in the yyyy-mm-dd hh:mm:ss format.
error_timestampTime of the error in the UNIX-time format.
error_receive_datetimeThe 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_timestampTime 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.
Device and OS information
FieldDescription
appmetrica_device_idA unique device identifier detected by the AppMetrica service.
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
device_localeThe language on the device.
connection_typeType of connection. Possible values: wifi | cell | unknown.
operator_nameName of the mobile operator.
mccMobile country code.
mncMobile network code.
country_iso_codeISO country code.
cityThe name of the city where the click was made (in English).
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
device_ipv6The 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
App information
FieldDescription
application_idUnique numeric identifier for the application in AppMetrica.
app_version_nameThe app version in the format specified by the developer.
app_package_nameThe package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).

Sessions starts

/logs/v1/export/sessions_starts.{csv | json | parts}
Available attributes:
Session information
FieldDescription
session_idSession ID.
session_start_datetimeDate and time of the session start in the yyyy-mm-dd hh:mm:ss format.
session_start_timestampTime of the session start in the UNIX time format.
session_start_receive_datetimeThe 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_timestampTime 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.
Device and OS information
FieldDescription
appmetrica_device_idA unique device identifier detected by the AppMetrica service.
ios_ifaThe device's IFA in the format received from the device.
ios_ifvIFV for the app in the format received from the device.
google_aidThe device's Google AID in the format received from the device.
windows_aidThe device's Windows AID in the format received from the device.
os_nameOperating system on the user's device: ios | android | windows.
os_versionThe version of the operating system on the user's device.
device_manufacturerThe device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).
device_modelThe device model detected by the AppMetrica service (for example, Galaxy S6).
original_device_modelDevice model from the manufacturer (e.g. for Galaxy S8 the following values are possible: SM-G9550, SM-G9558, etc.).
device_typeThe device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.
device_localeThe language on the device.
connection_typeType of connection. Possible values: wifi | cell | unknown.
operator_nameName of the mobile operator.
mccMobile country code.
mncMobile network code.
country_iso_codeISO country code.
cityThe name of the city where the click was made (in English).
profile_idUser profile ID.
Note. Can be set using the corresponding SDK methods.
device_ipv6The 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
App information
FieldDescription
app_build_numberApp build number.
application_idUnique numeric identifier for the application in AppMetrica.
app_version_nameThe app version in the format specified by the developer.
app_package_nameThe package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).