Lifecycle for Edge Network
The Adobe Experience Platform Mobile SDK Lifecycle extension enables application lifecycle data collection from your mobile app when using the Adobe Experience Platform Mobile SDK and the Edge Network extension. Use the following steps to set up an application to forward Lifecycle extension data to the Adobe Experience Platform.
Add AEP Mobile Lifecycle Details field group to your XDM Schema in Adobe Experience Platform
Include the "AEP Mobile Lifecycle Details" field group to the schema defined in your Edge configuration data stream. This field group defines all the data auto-collected by the Lifecycle for Edge Network extension.
- In Adobe Experience Platform, log in to your organization.
- Under Schemas section, select the Browse tab and search for the schema used in the application's Edge configuration.
- In the Field groups section, select Add.
- Search for AEP Mobile Lifecycle Details. Select it, then select Add field groups.
- Select Save.
Configure the Adobe Experience Platform Lifecycle extension in Data Collection UI
The Lifecycle for Edge Network extension is part of the Mobile Core extension. There is no separate card for the Lifecycle for Edge Network extension in the Extensions Catalog.
The configuration setting "Session Timeout" in the Mobile Core extension configuration is used when collecting Lifecycle session data for Analytics and is not used for the Lifecycle for Edge Network extension.
- In the Data Collection UI, from your mobile property, select the Extensions tab.
- On the Catalog tab, locate or search for the Mobile Core extension, and select Install.
- There are no configuration settings for Lifecycle for Edge Network.
- Select Save.
- Follow the publishing process to update SDK configuration.
In addition, use the following steps to Configure the Edge Network extension.
Configure a Rule to forward Lifecycle data to Platform
The Lifecycle for Edge Network extension dispatches application launch (foreground) and application close (background) events to the Mobile SDK. Create a rule to forward these events to the Adobe Experience Platform Edge Network.
Create a rule
On the Rules tab, select Create New Rule.
Give your rule an easily recognizable name in your list of rules.
In this example, the rule is named "Forward Lifecycle XDM events to Edge Network".
If you do not have existing rules for this property, the Create New Rule button will be in the middle of the screen. If your property has rules, the button will be in the top right of the screen.
Select an event
- Under the Events section, select Add.
- From the Extension dropdown list, select Mobile Core.
- From the Event Type dropdown list, select Foreground.
- Select Keep Changes.
- Under the Events section again, select the plus icon to add another Event.
- From the Extension dropdown list, select Mobile Core.
- From the Event Type dropdown list, select Background.
- Select Keep Changes.
Define the action
- Under the Actions section, select Add.
- From the Extension dropdown list, select Adobe Experience Platform Edge Network.
- From the Action Type dropdown list, select Forward event to Edge Network.
- Select Keep Changes.
Save the rule and rebuild your property
After you complete your configuration, verify that your rule looks like the following:
- Select Save.
- Rebuild your mobile property and deploy it to the correct environment.
Add the Lifecycle extension to your app
For implementation details, please reference the Lifecycle documentation to learn how to add Lifecycle to your app. as well as register Lifecycle with Mobile Core and add appropriate the Start/Pause calls.
In addition, use the following steps to add the Edge Network extension to your app.