Lifecycle metrics

Install

Metric

Key

DescriptIon

First Launches

a.InstallEvent

Triggered at the first run after installation or re-installation.

Install Date

a.InstallDate

Date of first launch after installation. The format is M/d/yyyy, and an example is 5/3/2017.

Upgrade

Metric

Key

Description

Upgrades

a.UpgradeEvent

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

Days since last upgrade

a.DaysSinceLastUpgrade

Number of days since the application version number changed. Important: This metric is not automatically stored in an Analytics metric. You must create a processing rule that sets a custom event to capture this metric.

Launches since last upgrade

a.LaunchesSinceUpgrade

Number of launches since the application version number changed. Important: This metric is not automatically stored in an Analytics metric. You must create a processing rule that sets a custom event to capture this metric.

Launch

Metric

Key

Description

Daily Engaged Users

a.DailyEngUserEvent

Triggered when the application is used on a particular day. Important: This metric 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

a.MonthlyEngUserEvent

Triggered when the application is used during a particular month. Important: This metric is not automatically stored in an Analytics metric. You must create a processing rule that sets a custom event to capture this metric.

Launches

a.LaunchEvent

Triggered on every run, including crashes and installs. Also triggered when the app is resumed from the background after the lifecycle session timeout is exceeded.

Previous Session Length

a.PrevSessionLength

Reports the number of seconds that a previous application session lasted based on how long the application was open and in the foreground.

Ignored Session Length

a.ignoredSessionLength

If the last session is set to last longer than lifecycle.sessionTimeout, that session length is ignored and recorded here.

Launch Number

a.Launches

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

Days since first use

a.DaysSinceFirstUse

Number of days since first run.

Days since last use

a.DaysSinceLastUse

Number of days since last use.

Hour of Day

a.HourOfDay

Measures the hour the app was launched and uses the 24-hour numerical format. Used for time parting to determine peak usage times.

Day of Week

a.DayOfWeek

Measures the day of the week the app was launched.

Crash

Metric

Key

Description

Crashes

a.CrashEvent

Triggered when the application crashed before closing. The event is sent when the application is started again after the crash.

Device Information

Metric

Key

Description

App ID

a.AppID

Stores the application name and version in the following format: AppName BundleVersion (app version code) . An example of this format is MyAppName 1.1(1).

Device Name

a.DeviceName

Stores the device name.

Operating System Version

a.OSVersion

Operating system name and version.

Carrier Name

a.CarrierName

Stores the name of the mobile service provider as provided by the device.

Important: This metric is not automatically stored in an Analytics variable. You must create a processing rule to copy this value to an Analytics variable for reporting.

Resolution

a.Resolution

Width x Height in pixels.

Locale

a.locale

Locale set for this device, for example, en-US.