Einrichten von Assurance

Erfahren Sie, wie Sie Adobe Experience Platform Assurance in einer Mobile App einrichten.

Assurance, offiziell Project Griffon, soll Ihnen dabei helfen, die Datenerfassung und die Bereitstellung von Erlebnissen in Ihrer Mobile App zu untersuchen, zu testen, zu simulieren und zu validieren.

Mit Assurance können Sie unformatierte SDK-Ereignisse untersuchen, die von Adobe Experience Platform Mobile SDK generiert wurden. Alle von der SDK erfassten Ereignisse stehen zur Einsicht bereit. SDK-Ereignisse werden in einer Listenansicht geladen, sortiert nach Zeit. Jedes Ereignis verfügt über eine Detailansicht, die weitere Details enthält. Zusätzliche Ansichten zum Durchsuchen der SDK-Konfiguration, Datenelemente, freigegebenen Status und SDK-Erweiterungsversionen sind ebenfalls verfügbar. Weitere Informationen zur Assurance finden Sie in der Produktdokumentation.

Voraussetzungen

  • Die App erfolgreich eingerichtet, wobei SDKs installiert und konfiguriert sind.

Lernziele

In dieser Lektion erfahren Sie Folgendes:

  • Vergewissern Sie sich, dass Ihre Organisation Zugriff hat (und fordern Sie ihn an, falls nicht).
  • Einrichten der Basis-URL.
  • Fügen Sie den erforderlichen iOS-spezifischen Code hinzu.
  • Verbindung zu einer Sitzung herstellen.

Zugriff bestätigen

Vergewissern Sie sich, dass Ihr Unternehmen Zugriff auf Assurance hat. Sie als Benutzer sollten dem Profil für Adobe Experience Platform hinzugefügt werden. Weitere Informationen Sie im„Benutzerzugriff“ im Assurance-Handbuch.

Implementierung

Zusätzlich zur allgemeinen Installation von SDK, die Sie in der vorherigen Lektion abgeschlossen haben, benötigt iOS auch die folgende Ergänzung, 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.

Weitere Informationen finden Sie hier.

Bundle-Kennung definieren

Sie müssen eine eindeutige Bundle-Kennung für Ihre App angeben.

  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.

    note important
    IMPORTANT
    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.

    Xcode-Signaturfunktionen {modal="regular"}

Einrichten einer Basis-URL

  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 URL-Schemata Ihrer Wahl fest.

    Assurance-URL

    note important
    IMPORTANT
    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 über 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.

Herstellen einer Verbindung zu einer Sitzung

In Xcode:

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

    note tip
    TIP
    Optional können Sie Ihren Build „bereinigen“, insbesondere wenn unerwartete Ergebnisse auftreten. Wählen Sie dazu Build-Ordner bereinigen… aus dem Menü Xcode Produkt.
  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"}

In Ihrem Browser:

  1. Navigieren Sie zur Datenerfassungs-Benutzeroberfläche.

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

  3. Wählen Sie Sitzung erstellen aus.

  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.
    Sitzung erstellen

  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.

      QA-Code

    Wenn Sie einen Simulator verwenden:

    1. Wählen Sie Link kopieren aus.

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

      Assurance Copy-Link

  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-Updates, die über die Assurance-Benutzeroberfläche eingehen, mit folgendem Inhalt:

      1. Erlebnisereignisse aus der App.

      2. Details eines ausgewählten Ereignisses.

      3. Das Gerät und die Zeitleiste.

        Assurance-

Wenn Sie auf Probleme stoßen, lesen Sie die technische und allgemeine Dokumentation.

Erweiterungen überprüfen

So überprüfen Sie, ob Ihre App die aktuellsten Erweiterungen verwendet:

  1. Wählen Sie Konfigurieren aus.

  2. Wählen Sie Hinzufügen für 123 Erweiterungsversionen aus.

  3. Wählen Sie Speichern aus.

    Konfigurieren von Erweiterungsversionen

  4. Wählen Sie 123 Erweiterungsversionen aus, um einen Überblick über die neuesten verfügbaren Erweiterungen und die in Ihrer Version der App verwendeten Erweiterungen zu erhalten.

    Erweiterungsversionen

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

NOTE
Nachdem Sie Ihre Erweiterungen (Pakete) in Xcode aktualisiert haben, schließen und löschen Sie Ihre aktuelle Sitzung, und wiederholen Sie alle Schritte von Verbindung zu einer Sitzung herstellen und Erweiterungen überprüfen, um sicherzustellen, dass Assurance die richtigen Erweiterungen in einer neuen Assurance-Sitzung ordnungsgemäß meldet.
SUCCESS
Sie haben jetzt Ihre App so eingerichtet, dass sie für den Rest des Tutorials Assurance verwendet.
Vielen Dank, dass Sie sich Zeit genommen haben, um mehr über Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, allgemeines Feedback geben möchten oder Vorschläge für zukünftige Inhalte haben, teilen Sie diese auf diesem Experience League Community-Diskussionsbeitrag

Weiter: Implementieren des Einverständnisses

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