Levenscyclusgegevens verzamelen

Leer hoe u levenscyclusgegevens kunt verzamelen in een mobiele app.

Met de Adobe Experience Platform Mobile SDK Lifecycle-extensie kunt u levenscyclusgegevens van uw mobiele app verzamelen. De Adobe Experience Platform Edge Network-extensie verzendt deze levenscyclusgegevens naar het Platform Edge Network, waar deze vervolgens worden doorgestuurd naar andere toepassingen en services volgens uw configuratie van de gegevensstroom. Leer meer over de uitbreiding van de Levenscyclusin de productdocumentatie.

Vereisten

  • App met SDK's geïnstalleerd en geconfigureerd met succes gemaakt en uitgevoerd. Als onderdeel van deze les bent u al begonnen met levenscycluscontrole. Zie SDKs installeren - Update AppDelegateaan overzicht.
  • Registreerde de uitbreiding van Assurance zoals die in de vorige leswordt beschreven.

Leerdoelstellingen

In deze les zult u:

  • Zorg voor nauwkeurige levenscyclusmetrische gegevens door de toepassing correct te starten/pauzeren wanneer deze van de voorgrond naar de achtergrond gaat.
  • Gegevens vanuit de app verzenden naar Platform Edge Network.
  • Valideren in Assurance.

Wijzigingen in implementatie

Nu kunt u uw project bijwerken en de levenscyclusgebeurtenissen registreren.

iOS
  1. Navigeer naar Luma > Luma > SceneDelegate in de Xcode-projectnavigator.

  2. Als uw app wordt gestart en deze wordt hervat vanaf een achtergrondstatus, roept iOS mogelijk uw gedelegeerde methode sceneWillEnterForeground: aan. Met deze methode wilt u een start-gebeurtenis voor de levenscyclus activeren. Deze code toevoegen aan func sceneWillEnterForeground(_ scene: UIScene) :

    code language-swift
    // When in foreground start lifecycle data collection
    MobileCore.lifecycleStart(additionalContextData: nil)
    
  3. Wanneer de app de achtergrond betreedt, wilt u de gegevensverzameling tijdens de levenscyclus van de gedelegeerde methode van uw app voor sceneDidEnterBackground: pauzeren. Deze code toevoegen aan func sceneDidEnterBackground(_ scene: UIScene) :

    code language-swift
    // When in background pause lifecycle data collection
    MobileCore.lifecyclePause()
    
Android
  1. Navigeer naar app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication in de Android Studio-navigator.

  2. Als uw app wordt gestart en de toepassing op de achtergrond wordt hervat, roept Android mogelijk uw overschrijving fun onActivityResumed function aan en u wilt met deze functie een gebeurtenis voor het starten van de levenscyclus activeren. Deze code toevoegen aan override fun onActivityResumed(activity: Activity) :

    code language-kotlin
    // When in foreground start lifecycle data collection
    MobileCore.lifecycleStart(null)
    
  3. Wanneer de app de achtergrond betreedt, wilt u de gegevensverzameling tijdens de levenscyclus van de functie override fun onActivityPaused van uw app pauzeren. Deze code toevoegen aan override fun onActivityPaused(activity: Activity) :

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

Valideren met Assurance

  1. Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.

  2. Verzend de app naar de achtergrond. Controleren op LifecyclePause -gebeurtenissen in de gebruikersinterface van Assurance.

  3. Breng de app naar de voorgrond. Controleren op LifecycleResume -gebeurtenissen in de gebruikersinterface van Assurance.

    bevestigt levenscyclus {modal="regular"}

Gegevens doorsturen naar Platform Edge Network

De vorige oefening verzendt de voor- en achtergrondgebeurtenissen naar Adobe Experience Platform Mobile SDK. Deze gebeurtenissen doorsturen naar Platform Edge Network:

  1. Selecteer Rules in de eigenschap Codes.
    creeer Regel {modal="regular"}

  2. Selecteer Initial Build als de bibliotheek die u wilt gebruiken.

  3. Selecteer Create New Rule.
    creeer Nieuwe Regel {modal="regular"}

  4. Typ Create Rule for Application Status in het scherm Name .

  5. Selecteer toevoegen Add hieronder EVENTS.
    creeer de dialoog van de Regel {modal="regular"}

  6. In de stap Event Configuration :

    1. Selecteer Mobile Core als de Extension .

    2. Selecteer Foreground als de Event Type .

    3. Selecteer Keep Changes.

      Configuratie van de Gebeurtenis van de Regel {modal="regular"}

  7. Terug in het Create Rule scherm, uitgezocht voeg Add naast Mobile Core - Foreground toe.
    Volgende gebeurtenisconfiguratie {modal="regular"}

  8. In de stap Event Configuration :

    1. Selecteer Mobile Core als de Extension .

    2. Selecteer Background als de Event Type .

    3. Selecteer Keep Changes.

      Configuratie van de Gebeurtenis van de Regel {modal="regular"}

  9. Terug in het Create Rule scherm, uitgezocht voeg toe Add onder ACTIONS.

    Regel voegt Actie {modal="regular"} toe

  10. In de stap Action Configuration :

    1. Selecteer Adobe Experience Edge Network als de Extension .

    2. Selecteer Forward event to Edge Network als de Action Type .

    3. Selecteer Keep Changes.

      Configuratie van de Actie van de Regel {modal="regular"}

  11. Selecteer Save to Library.
    Regel - sparen aan Bibliotheek {modal="regular"}

  12. Selecteer Build om de bibliotheek opnieuw samen te stellen.
    Regel - bouw {modal="regular"}

Zodra u met succes het bezit hebt gebouwd, worden de gebeurtenissen verzonden naar Platform Edge Network, en de gebeurtenissen door:sturen aan andere toepassingen en de diensten volgens uw datastreamconfiguratie.

Gebeurtenissen Application Close (Background) en Application Launch (Foreground) die XDM-gegevens bevatten, worden weergegeven in Assurance.

bevestigt levenscyclus die naar Platform Edge wordt verzonden {modal="regular"}

SUCCESS
U hebt nu uw app zo ingesteld dat toepassingsstatusgebeurtenissen (voorgrond, achtergrond) naar de Adobe Experience Platform Edge Network en alle services die u in uw gegevensstroom hebt gedefinieerd, worden verzonden.
Bedankt dat je tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene terugkoppelen willen delen, of suggesties over toekomstige inhoud hebben, hen op deze Communautaire besprekingspost van Experience Leaguedelen

Volgende: de gebeurtenisgegevens van het Spoor

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