Collecter des données de cycle de vie

Découvrez comment collecter des données de cycle de vie dans une application mobile.

L’extension Adobe Experience Platform Mobile SDK Lifecycle permet de collecter des données de cycle de vie à partir de votre application mobile. L’extension Adobe Experience Platform Edge Network envoie ces données de cycle de vie à Platform Edge Network, où elles sont ensuite transférées à d’autres applications et services en fonction de la configuration de votre train de données. En savoir plus sur l’extension Lifecycle dans la documentation du produit.

Conditions préalables

Objectifs d’apprentissage

Dans cette leçon, vous allez :

  • Activez des mesures de cycle de vie précises en démarrant/mettant correctement en pause lorsque l’application passe du premier plan à l’arrière-plan.
  • Envoyez des données de l’application vers Platform Edge Network.
  • Validez dans Assurance.

Modifications de la mise en œuvre

Vous pouvez maintenant mettre à jour votre projet pour enregistrer les événements de cycle de vie.

iOS
  1. Accédez à Luma > Luma > SceneDelegate dans le navigateur de projet Xcode.

  2. Une fois lancée, si votre application reprend à partir d’un état d’arrière-plan, iOS peut appeler votre méthode de délégué sceneWillEnterForeground:, qui est l’endroit où vous souhaitez déclencher un événement de début de cycle de vie. Ajoutez ce code à func sceneWillEnterForeground(_ scene: UIScene) :

    code language-swift
    // When in foreground start lifecycle data collection
    MobileCore.lifecycleStart(additionalContextData: nil)
    
  3. Lorsque l’application entre en arrière-plan, vous devez suspendre la collecte de données de cycle de vie à partir de la méthode de délégué sceneDidEnterBackground: de votre application. Ajoutez ce code à func sceneDidEnterBackground(_ scene: UIScene) :

    code language-swift
    // When in background pause lifecycle data collection
    MobileCore.lifecyclePause()
    
Android
  1. Accédez à app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication dans le navigateur d’Android Studio.

  2. Une fois lancée, si votre application reprend à partir d’un état d’arrière-plan, Android peut appeler votre fun onActivityResumed function de remplacement et cette fonction est l’endroit où vous souhaitez déclencher un événement de début de cycle de vie. Ajoutez ce code à override fun onActivityResumed(activity: Activity) :

    code language-kotlin
    // When in foreground start lifecycle data collection
    MobileCore.lifecycleStart(null)
    
  3. Lorsque l’application entre en arrière-plan, vous devez suspendre la collecte de données de cycle de vie à partir de la fonction override fun onActivityPaused de votre application. Ajoutez ce code à override fun onActivityPaused(activity: Activity) :

    code language-kotlin
    // When in background pause lifecycle data collection
    MobileCore.lifecyclePause()
    

Valider avec Assurance

  1. Consultez la section instructions de configuration pour connecter votre simulateur ou votre appareil à Assurance.

  2. Envoyez l’application en arrière-plan. Recherchez des événements LifecyclePause dans l’interface utilisateur d’Assurance.

  3. Mettez l’application au premier plan. Recherchez les événements LifecycleResume dans l’interface utilisateur d’Assurance.

    valider le cycle de vie {modal="regular"}

Transférer les données vers Platform Edge Network

L’exercice précédent distribue les événements de premier plan et d’arrière-plan à Adobe Experience Platform Mobile SDK. Pour transférer ces événements vers Platform Edge Network :

  1. Sélectionnez Règles dans la propriété Balises.
    Créer une règle {modal="regular"}

  2. Sélectionnez Version initiale comme bibliothèque à utiliser.

  3. Sélectionnez Créer une règle.
    Créer une règle {modal="regular"}

  4. Dans l’écran Créer une règle, saisissez Application Status pour Nom.

  5. Sélectionnez Ajouter Ajouter ci-dessous ÉVÉNEMENTS.
    Boîte de dialogue Créer une règle {modal="regular"}

  6. À l’étape Configuration d’événement :

    1. Sélectionnez Mobile Core comme Extension.

    2. Sélectionnez Premier plan comme Type d’événement.

    3. Sélectionnez Conserver les modifications.

      Configuration d’événement de règle {modal="regular"}

  7. De retour dans l’écran Créer une règle, sélectionnez Ajouter Ajouter en regard de Mobile Core - Premier plan.
    Configuration de l’événement suivant {modal="regular"}

  8. À l’étape Configuration d’événement :

    1. Sélectionnez Mobile Core comme Extension.

    2. Sélectionnez Arrière-plan comme Type d’événement.

    3. Sélectionnez Conserver les modifications.

      Configuration d’événement de règle {modal="regular"}

  9. De retour dans l’écran Créer une règle, sélectionnez Ajouter Ajouter sous ACTIONS.

    Ajouter une action de règle {modal="regular"}

  10. À l’étape Configuration d’action :

    1. Sélectionnez Adobe Experience Edge Network comme extension.

    2. Sélectionnez Transférer l’événement vers Edge Network comme Type d’action.

    3. Sélectionnez Conserver les modifications.

      Configuration de l’action de règle {modal="regular"}

  11. Sélectionnez Enregistrer dans la bibliothèque.
    Règle - Enregistrer dans la bibliothèque {modal="regular"}

  12. Sélectionnez Créer pour recréer la bibliothèque.
    Règle - Créer {modal="regular"}

Une fois la propriété créée, les événements sont envoyés à Platform Edge Network et les événements sont transférés à d’autres applications et services en fonction de la configuration de votre flux de données.

Vous devriez voir les événements Fermeture de l’application (arrière-plan) et Lancement de l’application (premier plan) contenant des données XDM dans Assurance.

valider le cycle de vie envoyé à Platform Edge {modal="regular"}

SUCCESS
Vous avez maintenant configuré votre application pour envoyer des événements d’état d’application (premier plan, arrière-plan) à Adobe Experience Platform Edge Network et à tous les services que vous avez définis dans votre flux de données.
Merci d’avoir consacré votre temps à découvrir Adobe Experience Platform Mobile SDK. Si vous avez des questions, souhaitez partager des commentaires généraux ou des suggestions sur le contenu futur, partagez-les dans ce article de discussion de la communauté Experience League

Suivant : Suivi des données d’événement

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b