Here are the metrics and dimensions that can be automatically measured by the mobile library after lifecycle is implemented.
Looking for information and documentation related to the Adobe Experience Platform Mobile SDK? Click here for our latest documentation.
As of September 2018, we released a new, major version of the SDK. These new Adobe Experience Platform Mobile SDKs are configurable through Experience Platform Launch.
After lifecycle metrics are configured, the metrics are sent in context data parameters to Analytics, parameters to Target with each mbox call, and as a signal to Audience Manager. Analytics and Target use the same format, while Audience Manager uses a different prefix for each metric.
For Analytics, the context data that is sent with each lifecycle tracking call is automatically captured in and reported by using the metric or dimension that listed in the first column.
Exceptions are provided in the description.
First Launches
Triggered at the first run after installation or re-installation.
a.InstallEventc_a_InstallEventUpgrades
Triggered at the first run after upgrade or anytime the version number changes.
a.UpgradeEventc_a_UpgradeEventDaily Engaged Users
Triggered when the application is used on a particular day.
a.DailyEngUserEventc_a_DailyEngUserEventMonthly Engaged Users
Triggered when the application is used during a particular month.
a.MonthlyEngUserEventc_a_MonthlyEngUserEventLaunches
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.
a.LaunchEventc_a_LaunchEventCrashes
Triggered when the application is not backgrounded before closing. The event is sent when the application is started again after the crash. Adobe Mobile crash reporting does not implement a global uncaught exception handler.
a.CrashEventc_a_CrashEventPrevious Session Length
Reports the number of seconds that a previous application session lasted based on how long the application was open and in the foreground.
a.PrevSessionLengthc_a_PrevSessionLengthThe Daily Engaged Users and Monthly Engaged Users metrics are not automatically stored in an Analytics metric. You must create a processing rule that sets a custom event to capture these metrics.
Install Date
Date of first launch after installation. The date format is MM/DD/YYYY.
a.InstallDatec_a_InstallDateApp ID
Stores the Application name and version in the [AppName] [BundleVersion] format. For example, myapp 1.1.
a.AppIDc_a_AppIDLaunch Number
Number of times the application was launched or brought out of the background.
a.Launchesc_a_LaunchesDays since first use
Number of days since first run.
a.DaysSinceFirstUsec_a_DaysSinceFirstUseDays since last use
Number of days since last use.
a.DaysSinceLastUsec_a_DaysSinceLastUseHour of Day
Measures the hour the app was launched and uses the 24-hour numerical format. Used for time parting to determine peak usage times.
a.HourOfDayc_a_HourOfDayDay of Week
Number of the week day the app was launched.
a.DayOfWeekc_a_DayOfWeekOperating System Version
Number of days since the application version number has changed.
a.OSVersionc_a_OSVersion|OS versionDays since last upgrade
Days since last upgrade.
a.DaysSinceLastUpgradec_a_DaysSinceLastUpgradeLaunches since last upgrade
Number of launches since the application version number has changed.
a.LaunchesSinceUpgradec_a_LaunchesSinceUpgradeDevice Name
Stores the device name. 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 list of common device names, see iOS Device Versions.
a.DeviceNamec_a_DeviceNameCarrier Name
Stores the name of the mobile service provider as provided by the device.
a.CarrierNamec_a_CarrierNameResolution
Width x Height in actual pixels.
a.Resolutionc_a_ResolutionThe Days since last upgrade, Launches since last upgrade, and the Carrier Name dimensions are not automatically stored in an Analytics variable. You must create a processing rule to copy the values to an Analytics variable for reporting.
The following metrics and dimensions are captured in mobile solution variables by the listed method.
Action Time Total
Populated by trackTimedAction methods.
a.action.time.totalc_a_action_time_totalAction Time In App
Populated by trackTimedAction methods.
a.action.time.inappc_a_action_time_inappLifetime Value (event)
Populated by trackLifetimeValue methods.
a.ltv.amountc_a_ltv_amountLocation (down to 10 km)
Populated by trackLocation methods.
Analytics Context Data/Target parameter:
a.loc.lat.aa.loc.lon.aAudience Management trait:
c_a_loc_lat_ac_a_loc_lon_aLocation (down to 100 m)
Populated by trackLocation methods.
Analytics Context Data/Target parameter:
a.loc.lat.ba.loc.lon.bAudience Management trait:
c_a_loc_lat_bc_a_loc_lon_bLocation (down to 1 m)
Populated by trackLocation methods.
Analytics Context Data/Target parameter:
a.loc.lat.ca.loc.lon.cAudience Management trait:
c_a_loc_lat_cc_a_loc_lon_cPoint of Interest Name
Populated by trackLocation methods when device is in a defined POI.
a.loc.poic_a_loc_poiDistance to Point of Interest Center
Populated by trackLocation methods when device is in a defined POI.
a.loc.distc_a_loc_distLifetime Value (conversion variable)
Populated by trackLifetimeValue methods.
a.ltv.amountc_a_ltv_amountTracking Code
Populated by Mobile App Acquisition. Generated automatically by Adobe mobile services.
a.referrer.campaign.trackingcodec_a_referrer_campaign_trackingcodeCampaign
Name of the campaign, also stored in the campaign variable. Populated by Mobile App Acquisition.
a.referrer.campaign.namec_a_referrer_campaign_nameCampaign Content
The name or ID of the content that displayed the link. Populated by Mobile App Acquisition.
a.referrer.campaign.contentc_a_referrer_campaign_contentCampaign Medium
Marketing medium, such as banner or email. Populated by Mobile App Acquisition.
a.referrer.campaign.mediumc_a_referrer_campaign_mediumCampaign Source
Original referrer, such as newsletter or social media network. Populated by Mobile App Acquisition.
a.referrer.campaign.sourcec_a_referrer_campaign_sourceCampaign Term
Paid keywords or other terms you want to track with this acquisition. Populated by Mobile App Acquisition.
a.referrer.campaign.termc_a_referrer_campaign_term