Documentation

Terms and definitions

Active user
An app user who has at least one session over the selected time period. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
App version
The version of the application that the user has installed, including the build number. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Age
This indicator is detected using Crypta technology. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Geography
The region of the user's location is detected using GPS, LBS, or the user's IP address. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Guest access

Allows you to give another user access to your app statistics. For more information, see the section Managing app access.

Session length
The time difference between the first and last event in the session
[no-highlight[

A session of the user interacting with the app. The session starts when the app is opened, and ends when the app is closed, a new session is force started, the app crashes, or the user is inactive for a prolonged period (session timeout). By default, the timeout is 10 seconds. You can change this value by calling the setSessionTimeout method in the SDK API.

]no-highlight]
. The session starts when the app is opened, and ends when the app is closed, a new session is force started, the app crashes, or the user is inactive for a prolonged period (session timeout). By default, the timeout is 10 seconds. You can change this value by calling the setSessionTimeout method in the SDK API. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Identification

For device identification, the AppMetrica SDK uses various types of identifiers available in the system depending on the platform, or combines them for increased accuracy. For this purpose, the Google AID is collected on Android devices, and the Apple IDFA and IV are collected on iOS devices.

More information about identifiers
Google AID

An advertising ID that is assigned by Google Play services. The advertiser can use it to identify a unique user, display targeted ads, and track the number of click-throughs from an ad to a website. If desired, the user can reset the ID or disable ad personalization.

Apple IDFA

An advertising ID. The advertiser can use it to identify a unique user, display targeted ads, and track the number of click-throughs from an ad to a website. If desired, the user can reset the ID.

IFV
An ID that is issued to the advertiser of an app. The same IFV is used for all apps from the same developer.
Traffic source
The source for an app install. The source may be an advertising campaign that engages users, or organic installs (directly from the app store). Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Crash
A critical error that leads to emergency shutdown of the app. Collected and sent automatically. To disable collecting and sending errors, call the setReportCrashesEnabled method in the SDK API. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Cohort analysis

Allows you to group users by the app install date and track changes over time for each cohort in the percentage of users who return to the app, or the percentage of users who complete a target event (event conversion). You can also compare these cohorts with each other. For more information, see Cohort analysis.

Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Cohort
A group of users who share a characteristic and the date of completing a target event. The shared characteristic may be an app install or a target event.
Event conversion
The percentage of the total number of users who completed a target event during the selected time period.
New user

A user who installed and launched the app at least once during the selected time period. If a user performed multiple installations during this period, only the first installation is counted. If a user removed the app and then re-installed it, this user is considered a new user.

Operator
The mobile carrier that the device uses to connect to mobile internet. Determined based on the MCC (Mobile Country Code) and MNC (Mobile Network Code). Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Organic

All app installs that users make themselves (for example, from the app store), as well as installs that weren't attributed to a partner or advertising campaign.

Error
Any error (not a crash) that occurred in the app. It can be sent by calling the ReportError method in the SDK API. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Gender
This indicator is detected using Crypta technology. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Platform
The platform that the app is running on (for example, iOS, Android, or WindowsPhone). Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Segment

A subset of users filtered by a formal attribute (for example, by the OS name).

Sampling

Controls the accuracy of report data. If generating a report requires a large amount of data, collecting this information might take a long time. In order to generate the report faster, the service can use just part of the data (for example, 10%). You can control sampling manually.

Session

A session of the user interacting with the app. The session starts when the app is opened, and ends when the app is closed, a new session is force started, the app crashes, or the user is inactive for a prolonged period (session timeout). By default, the timeout is 10 seconds. You can change this value by calling the setSessionTimeout method in the SDK API.

Event

Programming code used for transmitting information about user activity that you want to track, such as app installs.

You can use the AppMetrica SDK to transmit event messages and events with additional parameters.

You can pass any JSON data structure for calculations:

  • object — A tree branch is created for each object key, and the algorithm is called recursively for each value.
  • string — Counts the number of times each different value of the string occurs.
  • number — Calculates the total and average value of all numbers.
  • true, false or null — Calculates the number of times each value occurs.
  • array — Creates a [Parameters] tree branch and calculates the number of times when the value is an array. The algorithm is run recursively for each item in the array.
Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
. For more information about how data is presented in reports, see Adding custom events.
Connection
Type of internet connection (for example, Wifi, Hspa+, LTE, HSDPA). Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Tracker

A container with URLs and settings for tracking and collecting statistics about app installs via partners as part of an ad campaign. You can set the destination URL, deeplink, or post-click landing and get a tracking URL. When users go to this URL (and then install or open the app), it is reflected in the report.

Device
Names of device models. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Destination URL
Leads to the app store or a page where the user can install the app.
Screen
The screen resolution in pixels (such as 1280x720). Orientation is not considered. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Interface language
The system locale (such as ru-RU or tr-TR). Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Deeplink
Postback URL

A link for sending an event message (about an install or a target event). The event recipient is a partner. You can send additional parameters to the postback URL.

Postback

A GET request to the specified URL (the postback URL), which certain parameters can be sent to. You can add up to 5 requests per campaign. More information about the postback policy.

Retention

The percentage of users who installed the app during a given day, week, or month (the reference period) and then returned to the app (opened it) on a specific day, week, or month after installing.

This metric is calculated as the ratio of the number of users running the app during the Nth day, week, or month to the number of users who installed the app in the reference period (this number is taken as 100%).

Rolling Retention

The percentage of users who installed the app during a given day, week, or month (the reference period) and then returned to the app during a specific day, week, or month, assuming they could have potentially returned during the preceding time period. These users are not interpreted as lost (inactive) until the last time they start the app.

To better understand how Rolling Retention works, imagine a user who first opened the app on the day of installation (the reference day), and next opened it on the fourth day after installing. This user is counted as active on the fourth day and for all the previous days, as well. Even though it took the user four days to come back to the app, this was always a possibility during that time.

Post-click landing

The page that will be opened in the user's browser after clicking the link to install the app. You can enter it when you configure the tracker.

Root status
Whether the device has root access. Root access is used on a device for deleting system applications, making unauthorized changes, or installing apps that only work in this mode. Sample report *
[no-highlight[

* To view the sample report, you need to get demo access.

]no-highlight]
.
Tracking URL

A link in the format https://appmetriсa.yandex.com/serve/* that takes the user to the app store for installing the app. If the app is already installed, it opens the app (if a deeplink is specified). Created when setting up the tracker. For more information about tracking, see What is tracking?.

* To view the sample report, you need to get demo access.