Engagement

The "Engagement" report displays information about how much time the user spends in the app on average, how often the app starts, the average session length, the total number of sessions, and the total time in the app.

The report allows you to pull out certain users by defining data segments.

The report will help you:

Evaluate the time users spend in your app

Use the Timespent per user metric to determine the average time individual users spend in the app and the Total timespent metric for the total time spent by all users (this value could be 100,000 hours across all users).

Identify the average session length

Use the Average session length metric in various combinations with groupings by date, app version, or location. You can also use the Session length grouping for a clear breakdown by length.

Evaluate the frequency of app use

Use the Session per user metric in combination with groupings by period (day, week, or month).

Compare the engagement rates of different user groups

Use groupings by platform, app version, location, or a combination of those (for example, by week and app version).

Working with the report

General settings

1. Choose the time period and audience segment. By default, the report shows data for the week grouped by days.

   The time in the report is the beginning of the session on the user's device in the time zone specified in the app settings.

   Note

   To set a custom reporting period, use the element . The selected time interval can be grouped by hours, days, weeks, or months.

2. You can select specific users for the report using segmentation.

3. You can set up groupings and metrics in the report.

Configuring a chart with a choice of metrics

The report contains a visual chart with a choice of metrics. You can select no more than three metrics at a time. The selected metrics must have the same units. If a metric is not available in the list (its name is written in gray), it means that it has a different unit.

Selecting dimensions and metrics

The report contains metrics grouped into dimensions.

To set up dimensions and metrics:

1. Click the buttons one by one.

2. In each window, add dimensions and metrics you want to use to build the report.

3. Configure the order of metrics and dimensions.

   The order of metrics determines the order of columns, the order of dimensions determines the nesting of rows in the table.

Groupings

Engagement

Note

The Session length parameter can have the Undefined value if this was the user's only session. For more information, see A certain number of sessions have no defined duration.

• Session length. Grouped by intervals:

  Undefined | 0-9 seconds | 10-29 seconds | 30-59 seconds | 1 minute | 2 minutes | 3 minutes | 4 minutes | 5-9 minutes | 10-19 minutes | 20-29 minutes | 30-59 minutes | 1 hour | 2-4 hours | 5-9 hours | 10+ hours
  

Audience

• Operating system.
• OS version.
• Gender. Determined heuristically using Crypta technology. If the prediction accuracy is insufficient , it takes the Undefined value.
• Age. Determined heuristically using Crypta technology. Possible values: <18 | 18-24 | 25-34 | 35-44 | 45-54 | ≥55. If the prediction accuracy is insufficient, it is Undefined.

Geography

• Continent.
• Country.
• District.
• Region.
• City.
• City size.

Event

• Event. Event name.

• All parameters, nesting levels 1-5 Outputs all passed event parameters corresponding to the nesting levels.

• Parameter. Lets you select a specific parameter. You can select a dimension several times with different parameters.

  Alert

  Only nesting level 1 parameters are available.

Event date

• Month.
• Week.
• Day.

Application

• Version.
• Build number.

Metrics

Engagement

• Sessions. Number of sessions.
• Timespent per user. The total duration of sessions divided by the number of users with 1+ session per period (sessions with an undefined duration aren't taken into account. For more information, see A certain number of sessions have no defined duration).
• Average session length. The total duration of sessions divided by their number (sessions with an undefined duration aren't taken into account).
• Session per user. The number of sessions divided by the number of users with 1+ session per period.
• Total timespent. The total duration of all sessions (sessions with undefined duration aren't taken into account; for more information, see A certain number of sessions have no defined duration).

Data export

You can export data from a report. To do that, click → Export in the upper-right corner. The data is exported based on the selected report settings: segmentation, dimension, and time period.

The dropdown list contains the following elements:

• Export full report in CSV to export data from the table in CSV format.

• Chart→ CSV to export data from the chart in CSV format.

• Chart→ PNG to export chart images in PNG format.

• Copy table API request — Displays the query text for exporting data from the table using the Reporting API. You can use this query to build your own dashboard or create automated data export scripts.

  Note

  If you are getting the text of the query for the first time, make sure that the browser doesn't block the pop-up authorization window. In the authorization window, allow AppMetrica to access the data.

• Copy chart API request — Displays the query text for exporting data from the chart using the Reporting API. You can use this query to build your own dashboard or create automated data export scripts.

  Note

  If you are getting the text of the query for the first time, make sure that the browser doesn't block the pop-up authorization window. In the authorization window, allow AppMetrica to access the data.

Troubleshooting

A certain number of sessions have no defined duration

When using automatic session tracking (Android | iOS), AppMetrica receives information about the end of the session when the next app activity occurs, including in the background. This means that AppMetrica can't calculate the exact duration of a session if a user starts the app only once.

Too many sessions with a duration of 0–9 seconds

User activity is tracked using the SDK (Android | iOS). When using automatic tracking, the default session timeout is 10 seconds. You can change this value using the library configuration settings (Android | iOS).

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