DokumentationExperience PlatformSjälvstudiekurs om mobila appar

Ställ in försäkring

Last update: Mon Dec 18 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Beginner
  • Intermediate
  • Developer

Lär dig hur du konfigurerar Adobe Experience Platform Assurance i en mobilapp.

Assurance, som formellt kallas Project Griffon, är utformat för att hjälpa er att inspektera, verifiera, simulera och validera hur ni samlar in data eller levererar upplevelser i er mobilapp.

Med Assurance kan du inspektera SDK-råhändelser som genererats av Adobe Experience Platform Mobile SDK. Alla händelser som samlas in av SDK är tillgängliga för inspektion. SDK-händelser läses in i en listvy, sorterade efter tid. Varje händelse har en detaljerad vy som ger mer information. Det finns även ytterligare vyer för att bläddra bland SDK-konfigurationer, dataelement, delade lägen och SDK-tilläggsversioner. Läs mer om Säkerhet i produktdokumentationen.

Förutsättningar

  • Appen har konfigurerats med SDK:er installerade och konfigurerade.

Utbildningsmål

I den här lektionen kommer du att:

  • Bekräfta att din organisation har åtkomst (och begär det om du inte har det).
  • Ange din bas-URL.
  • Lägg till nödvändig iOS-specifik kod.
  • Anslut till en session.

Bekräfta åtkomst

Bekräfta att din organisation har åtkomst till Assurance. Som användare bör du läggas till i profilen för Adobe Experience Platform. Se Användaråtkomst i Assurance-guiden för mer information.

Implementera

Förutom det allmänna SDK-installation, som du slutförde i den tidigare lektionen, behöver iOS även följande tillägg för att starta Assurance-sessionen för din app.

  1. Navigera till Luma > Luma > SceneDelegate i Xcodes projektnavigerare.

  2. Lägg till följande kod i func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>:

    code language-swift 
    // Called when the app in background is opened with a deep link.
if let deepLinkURL = URLContexts.first?.url {
    // Start the Assurance session
    Assurance.startSession(url: deepLinkURL)
}

    Den här koden startar en säkringssession när appen finns i bakgrunden och öppnas med en djuplänk.

Mer information finns här.

Definiera källidentifierare

Du måste ange en unik källidentifierare för ditt program.

  1. Öppna projektet i Xcode.

  2. Välj Luma i projektnavigatorn.

  3. Välj Luma mål.

  4. Välj Signering och funktioner -fliken.

  5. Definiera en Paketidentifierare.

    note important
    IMPORTANT
    Se till att du använder en unik källidentifierare och ersätt com.adobe.luma.tutorial.swiftui källidentifierare eftersom varje källidentifierare måste vara unik. Vanligtvis använder du ett omvänt DNS-format för paket-ID-strängar, som com.organization.brand.uniqueidentifier. I den färdiga versionen av den här självstudiekursen används com.adobe.luma.tutorial.swiftui.

    Xcode-signeringsfunktioner {modal="regular"}

Konfigurera en bas-URL

  1. Gå till projektet i Xcode.

  2. Välj Luma i projektnavigatorn.

  3. Välj Luma mål.

  4. Välj Info -fliken.

  5. Bläddra nedåt till om du vill lägga till en bas-URL URL-typer och väljer + -knappen.

  6. Ange Identifierare till valfri källidentifierare och ange en URL-scheman efter eget val.

    försäkrings-URL

    note important
    IMPORTANT
    Se till att du använder en unik källidentifierare och ersätt com.adobe.luma.tutorial.swiftui källidentifierare eftersom varje källidentifierare måste vara unik. Vanligtvis använder du ett omvänt DNS-format för paket-ID-strängar, som com.organization.brand.uniqueidentifier. Du kan använda samma källidentifierare som du har använt på Definiera källidentifierare.
    Använd på liknande sätt ett unikt URL-schema och ersätt det redan angivna lumatutorialswiftui med ditt unika URL-schema.

Mer information om URL-scheman i iOS finns i Apple dokumentation.

Assurance fungerar genom att öppna en URL, antingen via webbläsaren eller QR-koden. Den URL:en börjar med den bas-URL som öppnar appen och innehåller ytterligare parametrar. Dessa unika parametrar används för att ansluta sessionen.

Ansluta till en session

I Xcode:

  1. Bygg eller återskapa och kör appen i simulatorn eller på en fysisk enhet från Xcode med Spela upp .

    note tip
    TIP
    Om du vill kan du rensa ditt bygge, särskilt när du ser oväntade resultat. Gör detta genom att välja Rensa byggmapp… från Xcode Produkt -menyn.

  2. I Tillåt att"Luma App" använder din plats dialogruta, välja Tillåt när appen används.

    {width="300"}

  3. I "Luma App" vill skicka meddelanden till dig dialogruta, välja Tillåt.

    {width="300"}

  4. Välj Fortsätt… så att appen kan spåra din aktivitet.

    {width="300"}

  5. I Tillåt att"Luma App" spårar din aktivitet över andra företags appar och webbplatser dialogruta, välja Tillåt.

    {width="300"}

I webbläsaren:

  1. Gå till användargränssnittet för datainsamling.

  2. Välj Säkerhet från den vänstra listen.

  3. Välj Skapa session.

  4. Välj Starta.

  5. Ange en Sessionsnamn som Luma Mobile App Session och Bas-URL, som är det URL-schema som du angav i Xcode, följt av :// Till exempel: lumatutorialswiftui://

  6. Välj Nästa.
    skapa trygghet, session

  7. I Skapa ny session modal dialog:

    Om du använder en fysisk enhet:

    • Välj Skanna QR-kod. Om du vill öppna appen använder du kameran på den fysiska enheten för att skanna QR-koden och trycka på länken.

      qa-kod för försäkring

    Om du använder en simulator:

    1. Välj Kopiera länk.

    2. Kopiera den djupa länken med Kopiera och använd länken till att öppna appen med Safari i simulatorn.

      Länk till Assurance-kopia

  8. När appen läses in visas en modal dialogruta där du ombeds ange den PIN-kod som visas i steg 7.

    {width="300"}

    Ange PIN-koden och välj Anslut.

  9. Om anslutningen lyckades ser du:

    • En säkerhetsikon visas ovanpå din app.

      {width="300"}

    • Uppdateringar från Experience Cloud i försäkringsgränssnittet som visar:

      1. Experience Events kommer från appen.

      2. Information om en markerad händelse.

      3. Enheten och tidslinjen.

        säkringshändelser

Om du stöter på några problem kan du gå igenom teknisk and general documentation.

Verifiera tillägg

Så här kontrollerar du om ditt program använder de senaste tilläggen:

  1. Välj Konfigurera.

  2. Välj Lägg till for 123 Tilläggsversioner.

  3. Välj Spara.

    Konfigurera tilläggsversioner

  4. Välj 123 Tilläggsversioner om du vill se en översikt över de senaste tillgängliga tilläggen och de tillägg som används i din version av programmet.

    Tilläggsversioner

  5. Så här uppdaterar du tilläggsversioner (till exempel Meddelanden och Optimera) väljer du paketet (tillägg) från Paketberoenden (till exempel AEPMessaging) och på snabbmenyn väljer Uppdateringspaket. Xcode uppdaterar paketberoendena.

NOTE
När du har uppdaterat dina tillägg (paket) i Xcode stänger du och tar bort den aktuella sessionen och upprepar alla steg från Ansluta till en session och Verifiera tillägg för att säkerställa att Assurance rapporterar rätt tillägg i en ny Assurance-session.
SUCCESS
Du har nu konfigurerat din app att använda Assurance för resten av självstudiekursen.
Tack för att du lade ned din tid på att lära dig om Adobe Experience Platform Mobile SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem om detta Experience League diskussionsinlägg

Nästa: Implementera medgivande

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