Einrichten von Assurance

Zusätzlich zur allgemeinen Installation von SDKiOS auch den folgenden zusätzlichen Code, um die Assurance-Sitzung für Ihre App zu starten.

1. Navigieren Sie im Projekt-Navigator Ihres Xcode zu Luma > Luma SceneDelegate.

2. Fügen Sie folgenden Code zu func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext> hinzu:

   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) }

   Dieser Code startet eine Sicherheitssitzung, wenn die App im Hintergrund läuft und über einen Deep-Link geöffnet wird.

Zusätzlich zur allgemeinen Installation von SDKAndroid auch den folgenden zusätzlichen Code, um die Assurance-Sitzung für Ihre App zu starten.

1. Navigieren Sie in Android Studio in der Ansicht Android zu app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication.

2. Fügen Sie folgenden Code zu fun handleDeeplink(deeplink: String?) hinzu:

   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)

   Dieser Code startet eine Sicherheitssitzung, wenn die App im Hintergrund läuft und über einen Deep-Link geöffnet wird.

1. Öffnen Sie das Projekt in Xcode.
2. Wählen Sie Luma im Projekt-Navigator aus.
3. Wählen Sie die Luma aus.
4. Wählen Sie die Registerkarte Signierung und Funktionen aus.
5. Definieren Sie eine Bundle-ID.

Stellen Sie sicher dass Sie eine eindeutige“ Bundle-Kennung verwenden und die com.adobe.luma.tutorial.swiftui Bundle-Kennung ersetzen, da jede Bundle-Kennung eindeutig sein muss. Normalerweise verwenden Sie ein Reverse-DNS-Format für Paket-ID-Zeichenfolgen wie com.organization.brand.uniqueidentifier. Die fertige Version dieses Tutorials verwendet beispielsweise com.adobe.luma.tutorial.swiftui.

{modal="regular"}

1. Öffnen Sie das Projekt in Android Studio.
2. Wählen Sie build.gradle.kts (Modul :app) im Navigator aus.
3. Stellen Sie sicher dass Sie eine Bundle-Kennung verwenden und den com.adobe.luma.tutorial.android Wert für namespace in android ersetzen
4. Stellen Sie sicher, dass Sie dieselbe eindeutige Bundle-Kennung verwenden und die com.adobe.luma.tutorial.android für applicationId in defaultConfig in android ersetzen

Normalerweise verwenden Sie ein Reverse-DNS-Format für Paket-ID-Zeichenfolgen wie com.organization.brand.uniqueidentifier. Die fertige Version dieses Tutorials verwendet beispielsweise com.adobe.luma.tutorial.android.

{modal="regular"}

1. Gehen Sie zu Ihrem Projekt in Xcode.

2. Wählen Sie Luma im Projekt-Navigator aus.

3. Wählen Sie die Luma aus.

4. Wählen Sie die Registerkarte Info aus.

5. Um eine Basis-URL hinzuzufügen, scrollen Sie nach unten zu URL-Typen und wählen Sie die Schaltfläche + aus.

6. Legen Sie Kennung auf die Bundle-Kennung Ihrer Wahl fest und legen Sie eine URL-Schemata Ihrer Wahl fest.

   {modal="regular"}

Stellen Sie sicher dass Sie eine eindeutige“ Bundle-Kennung verwenden und die com.adobe.luma.tutorial.swiftui Bundle-Kennung ersetzen, da jede Bundle-Kennung eindeutig sein muss. Normalerweise verwenden Sie ein Reverse-DNS-Format für Paket-ID-Zeichenfolgen wie com.organization.brand.uniqueidentifier. Sie können dieselbe Bundle-ID verwenden, die Sie unter „Bundle- definieren“haben.
Verwenden Sie auf ähnliche Weise ein eindeutiges URL-Schema und ersetzen Sie die bereits bereitgestellte lumatutorialswiftui durch Ihr eindeutiges URL-Schema.

Weitere Informationen zu URL-Schemata in iOS finden Sie in der Dokumentation zu Apple.

Assurance öffnet eine URL entweder über einen Browser oder einen QR-Code. Diese URL beginnt mit der Basis-URL, die die App öffnet und zusätzliche Parameter enthält. Diese eindeutigen Parameter werden verwendet, um die Sitzung zu verbinden. In der Beispiel-App wird der Deep-Link lumatutorialswiftui://.

1. Navigieren Sie zur Ansicht Android Ihres Projekts in Android Studio.

2. Wählen Sie app > manifests > AndroidManifest.xml im Navigator aus.

3. Stellen Sie sicher dass XML-Element manifest > aktivität wie folgt aussieht:

   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>

Stellen Sie sicher, dass Sie eine android:scheme angeben (z. B. lumatutorialandroid) und android:host (zum Beispiel default), um die Basis-URL zu definieren.

Weitere Informationen zu Deep-Links in Android finden Sie unter Erstellen von Deep-Links zu App-Inhalten.

Assurance öffnet eine URL entweder über einen Browser oder einen QR-Code. Diese URL beginnt mit der Basis-URL, die die App öffnet und zusätzliche Parameter enthält. Diese eindeutigen Parameter werden verwendet, um die Sitzung zu verbinden. In der Beispiel-App wird der Deep-Link lumatutorialandroid://default.

In Xcode:

1. Erstellen Sie die App im Simulator oder auf einem physischen Gerät mit Xcode und verwenden Sie .

   Optional können Sie Ihren Build bereinigen insbesondere dann, wenn unerwartete Ergebnisse auftreten. Wählen Build-Ordner bereinigen… aus dem Menü Produkt von Xcode aus.

2. Wählen im Dialogfeld „Zulassen, dass „Luma-App“ Ihren Standort verwendet die Option Zulassen, während Sie die App verwenden aus.

   {width="300"}

3. Wählen Sie im Dialogfeld "-App Luma möchte Ihnen Benachrichtigungen senden die Option Zulassen aus.

   {width="300"}

4. Wählen Sie Weiter… aus, damit die App Ihre Aktivität verfolgen kann.

   {width="300"}

5. Wählen im Dialogfeld „Luma-App zulassen“, um Ihre Aktivität über die Apps und Websites anderer Unternehmen hinweg verfolgen, Zulassen.

   {width="300"}

6. Wählen Sie Weiter aus.

In Ihrem Browser:

1. Navigieren Sie zur Datenerfassungs-Benutzeroberfläche.

2. Wählen Sie in der Leiste Assurance aus.

3. Wählen Sie Neue Sitzung erstellen und dann die Option Deep link connect.

4. Wählen Sie Starten aus.

5. Geben Sie einen Sitzungsnamen“. B. Luma Mobile App Session und die Basis-URL an. Dies sind die URL-Schemata, die Sie in Xcode eingegeben haben, gefolgt von :// Beispiel: lumatutorialswiftui://

6. Klicken Sie auf Weiter.
   {modal="regular"}

7. Im modalen „Neue Sitzung erstellen:

   Wenn Sie ein physisches Gerät verwenden:

   • Wählen Sie QR-Code scannen aus. Um die App zu öffnen, scannen Sie den QR-Code mit der Kamera auf Ihrem physischen Gerät und tippen Sie auf den Link.

     {modal="regular"}

   Wenn Sie einen Simulator verwenden:

   1. Wählen Sie Link kopieren aus.

   2. Kopieren Sie den Deep-Link mit und verwenden Sie den Deep-Link, um die App mit Safari im Simulator zu öffnen.

      {modal="regular"}

8. Beim Laden der App wird ein modales Dialogfeld angezeigt, in dem Sie aufgefordert werden, die in Schritt 7 angezeigte PIN einzugeben.

   {width="300"}

   Geben Sie die PIN ein und wählen Sie Verbinden.

9. Wenn die Verbindung erfolgreich hergestellt wurde, sehen Sie Folgendes:

   • Ein Assurance-Symbol, das über Ihrer App schwebt.

     {width="300"}

   • Experience Cloud-Aktualisierungen, die in der Benutzeroberfläche von Assurance eintreffen und Folgendes anzeigen:

     1. Erlebnisereignisse aus der App.

     2. Details eines ausgewählten Ereignisses.

     3. Das Gerät und die Zeitleiste.

        {modal="regular"}

10. Wählen Sie Weiter, um zum Startbildschirm zu gelangen.

In Android Studio:

1. Erstellen oder erstellen Sie die App neu und führen Sie sie im Simulator oder auf einem physischen Gerät aus Android Studio mithilfe von aus.

   Optional können Sie Ihren Build bereinigen insbesondere dann, wenn unerwartete Ergebnisse auftreten. Wählen Projekt bereinigen aus dem Menü Erstellen von Android Studio aus.

2. Wählen Sie im Dialogfeld Zulassen, dass Luma Android Ihnen Benachrichtigungen sendet die Option Zulassen.

   {width="300"}

3. Wählen Berechtigungsdialog anzeigen aus.

   {width="300"}

4. In der Luma Android Zugriff auf den Speicherort dieses Geräts gewähren?…

   {width="300"}

   • Wählen Sie Präzise.
   • Wählen Sie Bei Verwendung der App aus.

5. Wählen Sie im Begrüßungsbildschirm der App Geräteeinstellungen öffnen aus.

6. Wählen Sie im Standortberechtigung die Option Immer zulassen aus. Wählen Sie dann ← aus, um zum Einführungsbildschirm der App zurückzukehren.

   {width="300"}

7. Wählen Sie Weiter, um zum Startbildschirm zu gelangen.

In Ihrem Browser:

1. Navigieren Sie zur Datenerfassungs-Benutzeroberfläche.

2. Wählen Sie in der Leiste Assurance aus.

3. Wählen Sie Neue Sitzung erstellen und dann die Option Deep link connect.

4. Wählen Sie Starten aus.

5. Geben Sie einen Sitzungsnamen z. B. Luma Mobile App Session und die Basis-URL an. Dies ist die android:scheme und android:host, die Sie in AndroidManifest.xml in Android Studio definiert haben, getrennt durch :// Beispiel: lumatutorialandroid://default

6. Klicken Sie auf Weiter.
   {modal="regular"}

7. Im modalen „Neue Sitzung erstellen:

   Wenn Sie ein physisches Gerät verwenden:

   • Wählen Sie QR-Code scannen aus. Um die App zu öffnen, scannen Sie den QR-Code mit der Kamera auf Ihrem physischen Gerät und tippen Sie auf den Link.

     {modal="regular"}

   Wenn Sie einen Simulator verwenden:

   1. Wählen Sie Link kopieren aus.
   2. Kopieren Sie den Deep-Link mit und verwenden Sie den Deep-Link, um die App mit Chrome im Simulator zu öffnen.

   {modal="regular"}

   Wenn Sie in Chrome zum Weiter zu Luma Android aufgefordert werden, klicken Sie auf Weiter.

8. Beim Laden der App wird ein modales Dialogfeld angezeigt, in dem Sie aufgefordert werden, die in Schritt 7 angezeigte PIN einzugeben.

   {width="300"}

   Geben Sie die PIN ein und wählen Sie Verbinden.

9. Wenn die Verbindung erfolgreich hergestellt wurde, sehen Sie Folgendes:

   • Ein Assurance-Symbol, das über Ihrer App schwebt.

     {width="300"}

   • Experience Cloud-Aktualisierungen, die in der Benutzeroberfläche von Assurance eintreffen und Folgendes anzeigen:

     1. Erlebnisereignisse aus der App.

     2. Details eines ausgewählten Ereignisses.

     3. Das Gerät und die Zeitleiste.

        {modal="regular"}

{modal="regular"}

Um Ihre Erweiterungsversionen (z. B. Messaging und Optimize) zu aktualisieren, wählen Sie das Paket (die Erweiterung) unter Paketabhängigkeiten (z. B. AEPMMessaging) und wählen Sie im Kontextmenü Paket aktualisieren. Xcode aktualisiert die Paketabhängigkeiten.

{modal="regular"}

Wenn Sie veraltete Erweiterungen sehen, lesen Sie die Dokumentation zu Android, wie Sie Ihre Abhängigkeitsmodule für Ihr Projekt aktualisieren können.