DokumentationExperience PlatformSjälvstudiekurs om mobila appar

Ställ in försäkring

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Utvecklare

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 försäkringen i produktdokumentationen.

Förhandskrav

  • 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. Mer information finns i Användaråtkomst i kontrollguiden.

Implementera

Utöver den allmänna SDK-installationen 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 Xcode 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 målet Luma.

  4. Välj fliken Signering och funktioner.

  5. Definiera en Bundle Identifier.

    note important
    IMPORTANT
    Se till att du använder en unik-paketidentifierare och ersätt com.adobe.luma.tutorial.swiftui-paketidentifieraren, eftersom varje paketidentifierare 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älvstudien används till exempel 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 målet Luma.

  4. Välj fliken Info.

  5. Om du vill lägga till en bas-URL rullar du ned till URL-typer och väljer knappen + .

  6. Ange Identifierare till den paketidentifierare du vill använda och ange ett URL-schema som du väljer.

    försäkrings-URL

    note important
    IMPORTANT
    Se till att du använder en unik-paketidentifierare och ersätt com.adobe.luma.tutorial.swiftui-paketidentifieraren, eftersom varje paketidentifierare 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 den redan tillhandahållna 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 Play .

    note tip
    TIP
    Om du vill kan du rensa ditt bygge, särskilt när du ser oväntade resultat. Om du vill göra det väljer du Clean Build Folder… på Xcode Product-menyn.

  2. Välj Allow While Using App i dialogrutan Allow “Luma App” to use your location.

    {width="300"}

  3. Välj Allow i dialogrutan “Luma App” Would Like to Send You Notifications.

    {width="300"}

  4. Välj Continue… om du vill att appen ska kunna spåra din aktivitet.

    {width="300"}

  5. Välj Allow i dialogrutan Allow “Luma App” to track your activity across other companies’ apps and websites.

    {width="300"}

I webbläsaren:

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

  2. Välj Assurance i den vänstra listen.

  3. Välj Create Session.

  4. Välj Start.

  5. Ange en Session Name som Luma Mobile App Session och Base URL, som är de URL-scheman som du angav i Xcode, följt av :// Till exempel: lumatutorialswiftui://

  6. Välj Next.
    försäkrings-/skapandesession

  7. I dialogrutan Create New Session modal:

    Om du använder en fysisk enhet:

    • Välj Scan QR Code. 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äkran

    Om du använder en simulator:

    1. Välj Copy Link.

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

      Länk för säkringskopia

  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 Connect.

  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 läsa teknisk och allmän dokumentation.

Verifiera tillägg

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

  1. Välj Configure.

  2. Välj Lägg till för 123 Extension Versions.

  3. Välj Save.

    Konfigurera tilläggsversioner

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

    Tilläggsversioner

  5. Om du vill uppdatera tilläggsversionerna (till exempel Messaging och Optimize) väljer du paketet (tillägget) från Package Dependencies (till exempel AEPMessaging) och väljer Update Package på snabbmenyn. 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 i det här Experience League-diskussionsinlägget

Nästa: Implementera samtycke

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