Mobile Metrics and Dimensions Reference

Here is the reference information for the default mobile metrics and dimensions.

The following sections contain more information:

Tip: The dimension and metric permissions that are set in Adobe Analytics apply to Mobile Services. If you attempt to run a report without proper permissions, you will receive an error.

Metrics

Event

Configuration

First Launches

Triggered on the first run after an installation or a re-installation.

Upgrades

Triggered on the first run after an upgrade or when the version number changes.

Daily Engaged Users

Triggered when the application is used on a particular day.

Tip: The Daily Engaged Users event is not automatically stored in an Analytics metric. You must create a processing rule that sets a custom event to capture this metric.

Monthly Engaged Users

Triggered when the application is used during a month.

Tip: The Monthly Engaged Users event is not automatically stored in an Analytics metric. You must create a processing rule that sets a custom event to capture this metric.

Launches

Triggered on a run that is not an install or an upgrade. This also triggers when the application is brought out of the background.

By default, a new launch triggers when the application is in the background for five or more minutes. The amount of background time before triggering a new launch can be configured in SDK Analytics Options on Manage App Settings. For more information, see the Session Timeout (Seconds) row in Configure SDK Analytics Options.

Important: Because how visits in Adobe Analytics and mobile app launches in Adobe Mobile Services are calculated, you might see different results in reporting. For more information, see Compare Visits and Mobile App Launches.

Crashes

Triggered when the application does not correctly exit. This event is sent when the application starts after a crash.

Tip: The application is considered to crash if quit is not called.

Total Session Length

Aggregated total session length.

Dimensions

Dimension

Description

Install Date

Date of the first launch after the installation. The date is in the MM/DD/YYYY format.

App ID

Stores the Application name and version in the following format:

[AppName] [BundleVersion]

For example, myapp 1.1.

Launch Number

Number of times the application was launched or brought out of the background.

Days Since First Use

Number of days since the first run.

Days Since Last Use

Number of days since the last use.

Hour of Day

Measures the hour in which the app was launched and uses the 24-hour numerical format.

This dimension is also used for time parting to determine peak usage times.

Day of Week

Number of the week day the app was launched.

Operating System

Operating system of the device.

Operating System Version

Operating system version.

Days Since Last Upgrade

Number of days since the application version number has changed.

Launches Since Last Upgrade

Number of launches since the application version number has changed.

Device Name

Stores the device name.

iOS: Comma-separated, two-digit string that identifies the iOS device. The first number typically represents the device generation, and the second number typically versions different members of the device family. For a complete list of common device names, see iOS Device Versions.

Carrier Name

Stores the name of the mobile service provider.

Resolution

Width and height in actual pixels.