Konfigurera Assurance

Utöver den allmänna SDK-installationen behöver iOS även följande extra kod 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.

Utöver den allmänna SDK-installationen behöver Android även följande extra kod för att starta Assurance-sessionen för din app.

1. I Android Studio går du till Android > app > kotlin+java > com.adobe.luma.tutorial.android i vyn LumaApplication.

2. Lägg till följande kod i fun handleDeeplink(deeplink: String?):

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

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

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.

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.

{modal="regular"}

1. Öppna projektet i Android Studio.
2. Välj build.gradle.kts (Module :app) i navigatorn.
3. Se till att du använder en unik-källidentifierare och ersätt com.adobe.luma.tutorial.android-värdet för namespace i android
4. Se till att du använder samma unika-källidentifierare och ersätt com.adobe.luma.tutorial.android för applicationId i defaultConfig i android

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

{modal="regular"}

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 Identifieraren till valfri källidentifierare och ange ett URL-schema som du väljer.

   {modal="regular"}

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-adress, antingen via en webbläsare eller QR-kod. 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. I exempelappen är den djupa länken lumatutorialswiftui://.

1. Gå till Android-vyn för ditt projekt i Android Studio.

2. Välj app > manifests > AndroidManifest.xml i navigatorn.

3. Kontrollera att XML-elementet manifest > application > activity ser ut så här:

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

Se till att du anger android:scheme (till exempel. lumatutorialandroid) och android:host (till exempel default) för att definiera bas-URL:en.

Mer information om djupa länkar i Android finns i Skapa djupa länkar till appinnehåll.

Assurance fungerar genom att öppna en URL-adress, antingen via en webbläsare eller QR-kod. Den URL:en börjar med bas-URL:en, som öppnar programmet och innehåller ytterligare parametrar. Dessa unika parametrar används för att ansluta sessionen. I exempelappen är den djupa länken lumatutorialandroid://default.

I Xcode:

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

   Om du vill kan du rensa ditt bygge, särskilt när oväntade resultat visas. Välj Clean Build Folder… på Xcode Product-menyn.

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

   {width="300"}

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

   {width="300"}

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

   {width="300"}

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

   {width="300"}

6. Välj Continue.

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 New Session och alternativet Deep link connect.

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.
   {modal="regular"}

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.

     {modal="regular"}

   Om du använder en simulator:

   1. Välj Copy Link.

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

      {modal="regular"}

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 Assurance-ikon visas ovanpå din app.

     {width="300"}

   • Experience Cloud-uppdateringar som kommer igenom i Assurance användargränssnitt, som visar:

     1. Experience Events kommer från appen.

     2. Information om en markerad händelse.

     3. Enheten och tidslinjen.

        {modal="regular"}

10. Välj Continue om du vill gå till hemskärmen.

I Android Studio:

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

   Om du vill kan du rensa ditt bygge, särskilt när oväntade resultat visas. Välj Clean Project på menyn Android Studio Build.

2. Välj Allow Luma Android to send you notifications i dialogrutan Allow.

   {width="300"}

3. Välj Show permission dialog.

   {width="300"}

4. I Allow Luma Android to access this device’s location?…

   {width="300"}

   • Välj Precise.
   • Välj While using the app.

5. Välj Open device settings på introduktionsappens skärm.

6. Välj Location permission på skärmen Allow all the time. Välj sedan ← för att återgå till introduktionsappskärmen.

   {width="300"}

7. Välj Continue om du vill gå till hemskärmen.

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 New Session och alternativet Deep link connect.

4. Välj Start.

5. Ange en Session Name, till exempel Luma Mobile App Session och Base URL, som är android:scheme och android:host som du definierade i AndroidManifest.xml i Android Studio, avgränsade med :// till exempel: lumatutorialandroid://default

6. Välj Next.
   {modal="regular"}

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.

     {modal="regular"}

   Om du använder en simulator:

   1. Välj Copy Link.
   2. Kopiera den djupa länken med och använd den djupa länken för att öppna appen med Chrome i simulatorn.

   {modal="regular"}

   Välj Fortsätt när du uppmanas i Chrome att fortsätta till Luma Android.

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 Assurance-ikon visas ovanpå din app.

     {width="300"}

   • Experience Cloud-uppdateringar som kommer igenom i Assurance användargränssnitt, som visar:

     1. Experience Events kommer från appen.

     2. Information om en markerad händelse.

     3. Enheten och tidslinjen.

        {modal="regular"}

{modal="regular"}

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.

{modal="regular"}

Om du ser föråldrade tillägg läser du Android Studio-dokumentationen om hur du uppdaterar dina beroendemoduler för ditt projekt.