Lifecycle for Edge Network data

When used with the Edge Network extension, the following data is collected and sent to Platform on every application launch. An additional rule in the mobile property is required to send Lifecycle data to the Edge Network extension.

When the Analytics service is enabled in the datastream configuration, the XDM Lifecycle data is automatically mapped to Analytics. See the XDM object variable mapping to Adobe Analytics documentation for more information.

data-variant=warning

data-slots=text
This data is not used with Lifecycle for Analytics. Instead, view the Lifecycle data reference.

Lifecycle Application Foreground data

The following data is collected on each Lifecycle Application Foreground event. The structure of this data is defined in the Experience Data Model (XDM) field group AEP Mobile Lifecycle Details.

Application

Property
Type
Description
xdm:id
String
Identifier of the application.
xdm:name
String
Name of the application.
xdm:version
String
Version of the application.
xdm:isLaunch
boolean
Indicates the application has launched. Every application foreground event sets isLaunch to true.
xdm:isInstall
boolean
Indicates the application was installed. If true, signifies the first launch of the application. The Experience Event's timestamp property can be used as the application's install date.
xdm:isUpgrade
boolean
Indicates the application was upgraded. If true, signifies the first launch of the application after an upgrade.
dc:language
String
The language of the application to represent the user's linguistic, geographical, or cultural preferences for data presentation.
data-variant=info

data-slots=text1, text2, text3, text4
For the Edge Network extension, the xdm:isUpgrade property, which identifies app upgrades, is collected within the Lifecycle extension by comparing version information at each app launch. Starting with Lifecycle extension for Android version 3.0.1 and Lifecycle extension for iOS version 5.1.0, there is an enhancement to the method of calculating this property.
xdm:isUpgrade (Previous Method) In Lifecycle extension for Android version (2.0.0 - 3.0.0) and Lifecycle extension for iOS version (4.0.0 - 5.0.0), the app upgrade event is detected by comparing the build numbers on iOS and the version names on Android.
xdm:isUpgrade (New Method) Starting with Lifecycle extension for Android version 3.0.1 and Lifecycle extension for iOS version 5.1.0, the app upgrade event is detected through comparisons of the xdm:version properties which has the format versionName (versionCode) on Android and Version (Build) on iOS.
This change now more accurately detects when an application upgrade occurs. Applications which only change the build number on iOS or the version name on Android when upgrading, may see an increase in Lifecycle upgrade events. Other applications, however, should not see a change to Lifecycle upgrade events.

Device

Property
Type
Description
xdm:type
String
The type of device being tracked.
xdm:manufacturer
String
The name of the organization who owns the design and creation of the device.
xdm:model
String
The name of the model for the device.
xdm:modelNumber
String
The unique model number designation assigned by the manufacturer for this device.
xdm:screenHeight
integer
The number of vertical pixels of the device's active display in the default orientation.
xdm:screenWidth
integer
The number of horizontal pixels of the device's active display in the default orientation.

Environment

Property
Type
Description
xdm:type
String
The type of the application environment.
xdm:carrier
String
A mobile network carrier or MNO, also known as a wireless service provider, wireless carrier, cellular company, or mobile network carrier.
xdm:operatingSystem
String
The name of the operating system used when the observation was made.
xdm:operatingSystemVersion
String
The full version identifier for the operating system used when the observation was made.
dc:language
String
The language of the environment to represent the user's linguistic, geographical, or cultural preferences for data presentation.

Lifecycle Application Background data

The following data is collected on each Lifecycle Application Background event. The structure of this data is defined in the Experience Data Model (XDM) field group AEP Mobile Lifecycle Details.

Application

Property
Type
Description
xdm:isClose
boolean
Indicates the application was closed. Every application background event sets isClose to true.
xdm:closeType
String
Type of application close, sent on application isClose. Type is close on graceful termination of an application, or unknown when application termination source is unknown, such as a forced close or application crash.
xdm:sessionLength
integer
Length of the application session in seconds. Usually referred as the time the application was in foreground. Will not be less than zero.