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 metrics to the 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 metrics 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 click Add field groups.
- Click Save.
{% hint style="info" %} 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. {% endhint %}
{% hint style="warning" %} 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. {% endhint %}
- In Platform, from your mobile property, click the Extensions tab.
- On the Catalog tab, locate or search for the Mobile Core extension, and click Install.
- There are no configuration settings for Lifecycle for Edge Network.
- Click Save.
- Follow the publishing process to update SDK configuration.
In addition, use the following steps to Configure the Edge Network extension in Platform.
The Lifecycle for Edge Network extension dispatches application foreground and background events to the Mobile SDK. Create a rule to forward these events to the Adobe Experience Platform Edge Network.
-
On the Rules tab, click 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".
{% hint style="info" %} 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. {% endhint %}
- Under the Events section, click Add.
- From the Extension dropdown list, select Mobile Core.
- From the Event Type dropdown list, select Foreground.
- Click Keep Changes.
- Under the Events section again, click the plus icon to add another Event.
- From the Extension dropdown list, select Mobile Core.
- From the Event Type dropdown list, select Background.
- Click Keep Changes.
- Under the Actions section, click Add.
- From the Extension dropdown list, select Adobe Experience Platform Edge Network.
- From the Action Type dropdown list, select Forward event to Edge Network.
- Click Keep Changes.
After you complete your configuration, verify that your rule looks like the following:
- Click Save.
- Rebuild your mobile property and deploy it to the correct environment.
For implementation details, please reference: 1. Add Lifecycle to your app. 2. Register Lifecycle with Mobile Core and add appropriate Start/Pause calls.
In addition, use the following steps to add the Edge Network extension to your app.