Ställ in försäkring
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.
-
Navigera till Luma > Luma > SceneDelegate i Xcode projektnavigerare.
-
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.
-
Öppna projektet i Xcode.
-
Välj Luma i projektnavigatorn.
-
Välj målet Luma.
-
Välj fliken Signering och funktioner.
-
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, somcom.organization.brand.uniqueidentifier
. I den färdiga versionen av den här självstudien används till exempelcom.adobe.luma.tutorial.swiftui
.
Konfigurera en bas-URL
-
Gå till projektet i Xcode.
-
Välj Luma i projektnavigatorn.
-
Välj målet Luma.
-
Välj fliken Info.
-
Om du vill lägga till en bas-URL rullar du ned till URL-typer och väljer knappen + .
-
Ange Identifierare till den paketidentifierare du vill använda och ange ett URL-schema som du väljer.
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, somcom.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ållnalumatutorialswiftui
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:
-
Bygg eller återskapa och kör appen i simulatorn eller på en fysisk enhet från Xcode med
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. -
Välj Allow While Using App i dialogrutan Allow “Luma App” to use your location.
-
Välj Allow i dialogrutan “Luma App” Would Like to Send You Notifications.
-
Välj Continue… om du vill att appen ska kunna spåra din aktivitet.
-
Välj Allow i dialogrutan Allow “Luma App” to track your activity across other companies’ apps and websites.
I webbläsaren:
-
Gå till användargränssnittet för datainsamling.
-
Välj Assurance i den vänstra listen.
-
Välj Create Session.
-
Välj Start.
-
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://
-
Välj Next.
-
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.
Om du använder en simulator:
-
Välj Copy Link.
-
Kopiera den djupa länken med
-
-
När appen läses in visas en modal dialogruta där du ombeds ange den PIN-kod som visas i steg 7.
Ange PIN-koden och välj Connect.
-
Om anslutningen lyckades ser du:
-
En säkerhetsikon visas ovanpå din app.
-
Uppdateringar från Experience Cloud i försäkringsgränssnittet som visar:
-
Experience Events kommer från appen.
-
Information om en markerad händelse.
-
Enheten och tidslinjen.
-
-
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:
-
Välj Configure.
-
Välj
-
Välj Save.
-
Välj
-
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.
Nästa: Implementera samtycke