This section provides information about the metrics and dimensions that can be measured automatically by the mobile library, after lifecycle is implemented, and a link to troubleshoot Lifecycle data. For more information about troubleshooting, go to Troubleshoot Lifecycle data.
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.
- To get started, go to Adobe Experience Platform Launch.
- To see what is in the Experience Platform SDK repositories, go to Github: Adobe Experience Platform SDKs.
When configured, lifecycle metrics are sent in context data parameters to Analytics, in parameters to Target with each mbox call, and as a signal to audience management. Analytics and Target use the same format, while audience management 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 on by using the metric or dimension, and the exceptions are noted.
-
First Launches
Triggered at the first run after installation or re-installation.
- Analytics Context Data/Target Parameter:
a.InstallEvent
- Audience Manager Signal:
c_a_InstallEvent
- Analytics Context Data/Target Parameter:
-
Upgrades
Triggered at the first run after an upgrade or when the version number changes.
- Analytics Context Data/Target Parameter:
a.UpgradeEvent
- Audience Manager Signal:
c_a_UpgradeEvent
- Analytics Context Data/Target Parameter:
-
Daily Engaged Users
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.
- Analytics Context Data/Target Parameter:
a.DailyEngUserEvent
- Audience Manager Signal:
c_a_DailyEngUserEvent
- Analytics Context Data/Target Parameter:
-
Monthly Engaged Users
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.
- Analytics Context Data/Target Parameter:
a.MonthlyEngUserEvent
- Audience Manager Signal:
c_a_MonthlyEngUserEvent
- Analytics Context Data/Target Parameter:
-
Launches
Triggered at every run, including crashes and installs. Also triggered on a resume from the background when the lifecycle session timeout has been exceeded.
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.
- Analytics Context Data/Target Parameter:
a.LaunchEvent
- Audience Manager Signal:
c_a_LaunchEvent
- Analytics Context Data/Target Parameter:
-
Crashes
Triggered when the application is not backgrounded before being closed. The event is sent when the application is started after the crash. Adobe Mobile crash reporting does not implement a global uncaught exception handler.
- Analytics Context Data/Target Parameter:
a.CrashEvent
- Audience Manager Signal:
c_a_CrashEvent
- Analytics Context Data/Target Parameter:
-
Previous 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.
- Analytics Context Data/Target Parameter:
a.PrevSessionLength
- Audience Manager Signal:
c_a_PrevSessionLength
- Analytics Context Data/Target Parameter:
-
Install Date
Date of first launch after installation. The date format is MM/DD/YYYY.
- Analytics Context Data/Target Parameter:
a.InstallDate
- Audience Manager:
c_a_InstallDate
- Analytics Context Data/Target Parameter:
-
App ID
Stores the application name and version in the
[AppName] [BundleVersion]
format. An example of this format ismyapp 1.1
.- Analytics Context Data/Target Parameter:
a.AppID
- Audience Manager:
c_a_AppID
- Analytics Context Data/Target Parameter:
-
Launch Number
Number of times the application was launched or brought out of the background.
- Analytics Context Data/Target Parameter:
a.Launches
- Audience Manager:
c_a_Launches
- Analytics Context Data/Target Parameter:
-
Days since first use
Number of days since the first run.
- Analytics Context Data/Target Parameter:
a.DaysSinceFirstUse
- Audience Manager:
c_a_DaysSinceFirstUse
- Analytics Context Data/Target Parameter:
-
Days since last use
Number of days since the last use.
- Analytics Context Data/Target Parameter:
a.DaysSinceLastUse
- Audience Manager:
c_a_DaysSinceLastUse
- Analytics Context Data/Target Parameter:
-
Hour of Day
Measures the hour that the app was launched. This metric uses the 24-hour numerical format and is used for time parting to determine peak usage times.
- Analytics Context Data/Target Parameter:
a.HourOfDay
- Audience Manager:
c_a_HourOfDay
- Analytics Context Data/Target Parameter:
-
Day of Week
Number of the day in a week when the app was launched.
- Analytics Context Data/Target Parameter:
a.DayOfWeek
- Audience Manager:
c_a_DayOfWeek
- Analytics Context Data/Target Parameter:
-
Operating System Version
The OS version.
- Analytics Context Data/Target Parameter:
a.OSVersion
- Audience Manager:
c_a_OSVersion
- Analytics Context Data/Target Parameter:
-
Days since last upgrade
Number of days since the application version number has changed.
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.
- Analytics Context Data/Target Parameter:
a.DaysSinceLastUpgrade
- Audience Manager:
c_a_DaysSinceLastUpgrade
- Analytics Context Data/Target Parameter:
-
Launches since last upgrade
Number of launches since the application version number has changed.
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.
- Analytics Context Data/Target Parameter:
a.LaunchesSinceUpgrade
- Audience Manager:
c_a_LaunchesSinceUpgrade
- Analytics Context Data/Target Parameter:
-
Device Name
Stores the device name.
- Analytics Context Data/Target Parameter:
a.DeviceName
- Audience Manager:
c_a_DeviceName
- Analytics Context Data/Target Parameter:
-
Carrier Name
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.
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.
- Analytics Context Data/Target Parameter:
a.CarrierName
- Audience Manager:
c_a_CarrierName
- Analytics Context Data/Target Parameter:
-
Resolution
Width x Height in actual pixels.
- Analytics Context Data/Target Parameter:
a.Resolution
- Audience Manager:
c_a_Resolution
- Analytics Context Data/Target Parameter:
The following metrics and dimensions are captured in mobile solution variables by the method listed in the Description column.
-
Action Time Total
Populated by
trackTimedAction
methods.- Analytics Context Data/Target Parameter:
a.action.time.total
- Audience Manager Trait:
c_a_action_time_total
- Analytics Context Data/Target Parameter:
-
Action Time In App
Populated by
trackTimedAction
methods.- Analytics Context Data/Target Parameter:
a.action.time.inapp
- Audience Manager Trait:
c_a_action_time_inapp
- Analytics Context Data/Target Parameter:
-
Lifetime Value (event)
Populated by
trackLifetimeValue
methods.- Analytics Context Data/Target Parameter:
a.ltv.amount
- Audience Manager Trait:
c_a_ltv_amount
- Analytics Context Data/Target Parameter:
-
Location (down to 10 km)
Populated by
trackLocation
methods.-
Analytics Context Data/Target Parameters:
a.loc.lat.a
a.loc.lon.a
-
Audience Manager Traits:
c_a_loc_lat_a
c_a_loc_lon_a
-
-
Location (down to 100 m)
Populated by trackLocation methods.
-
Analytics Context Data/Target Parameters:
a.loc.lat.b
a.loc.lon.b
-
Audience Manager Traits:
c_a_loc_lat_b
c_a_loc_lon_b
-
-
Location (down to 1 m)
Populated by trackLocation methods.
-
Analytics Context Data/Target Parameters:
a.loc.lat.c
a.loc.lon.c
-
Audience Manager Traits:
c_a_loc_lat_c
c_a_loc_lon_c
-
-
Point of Interest Name
Populated by trackLocation methods when device is within a defined POI.
- Analytics Context Data/Target Parameters:
a.loc.poi
- Audience Manager Trait:
c_a_loc_poi
- Analytics Context Data/Target Parameters:
-
Distance to Point of Interest Center
Populated by trackLocation methods when device is within a defined POI.
- Analytics Context Data/Target Parameters:
a.loc.dist
- Audience Manager Trait:
c_a_loc_dist
- Analytics Context Data/Target Parameters:
-
Lifetime Value (conversion variable)
Populated by trackLifetimeValue methods.
- Analytics Context Data/Target Parameters:
a.ltv.amount
- Audience Manager Trait:
c_a_ltv_amount
- Analytics Context Data/Target Parameters:
-
Tracking Code
Populated by Mobile App Acquisition and automatically generated by Adobe mobile services.
- Analytics Context Data/Target Parameters:
a.referrer.campaign.trackingcode
- Audience Manager Trait:
c_a_referrer_campaign_trackingcode
- Analytics Context Data/Target Parameters:
-
Campaign
Name of the campaign, also stored in the campaign variable. Populated by Mobile App Acquisition.
- Analytics Context Data/Target Parameters:
a.referrer.campaign.name
- Audience Manager Trait:
c_a_referrer_campaign_name
- Analytics Context Data/Target Parameters:
-
Campaign Content
The name or ID of the content that displayed the link. Populated by Mobile App Acquisition.
- Analytics Context Data/Target Parameters:
a.referrer.campaign.content
- Audience Manager Trait:
c_a_referrer_campaign_content
- Analytics Context Data/Target Parameters:
-
Campaign Medium
Marketing medium, such as a banner or email. Populated by Mobile App Acquisition.
- Analytics Context Data/Target Parameters:
a.referrer.campaign.medium
- Audience Manager Trait:
c_a_referrer_campaign_medium
- Analytics Context Data/Target Parameters:
-
Campaign Source
Original referrer, such as a newsletter or a social media network. Populated by Mobile App Acquisition.
- Analytics Context Data/Target Parameters:
a.referrer.campaign.source
- Audience Manager Trait:
c_a_referrer_campaign_source
- Analytics Context Data/Target Parameters:
-
Campaign Term
Paid keywords or other terms that you want to track with this acquisition. Populated by Mobile App Acquisition.
- Analytics Context Data/Target Parameters:
a.referrer.campaign.term
- Audience Manager Trait:
c_a_referrer_campaign_term
- Analytics Context Data/Target Parameters: