Einrichten der Sicherheit

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

Assurance, formell als Project Griffon bekannt, soll Ihnen dabei helfen, zu untersuchen, zu testen, zu simulieren und zu überprüfen, wie Sie Daten erfassen oder Erlebnisse in Ihrer mobilen App bereitstellen.

Mithilfe von "Assurance"können Sie unformatierte SDK-Ereignisse überprüfen, die vom Adobe Experience Platform Mobile SDK generiert wurden. Alle vom SDK erfassten Ereignisse stehen zur Überprüfung zur Verfügung. SDK-Ereignisse werden in einer Listenansicht geladen, sortiert nach Zeit. Jedes Ereignis verfügt über eine detaillierte Ansicht, die weitere Details enthält. Zusätzliche Ansichten zum Durchsuchen von SDK-Konfigurationen, Datenelementen, freigegebenen Status und SDK-Erweiterungsversionen werden ebenfalls bereitgestellt. Weitere Informationen zum Assurance in der Produktdokumentation.

Voraussetzungen

  • Richten Sie die App erfolgreich mit installierten und konfigurierten SDKs ein.

Lernziele

In dieser Lektion werden Sie:

  • Vergewissern Sie sich, dass Ihr Unternehmen Zugriff hat (und fordern Sie ihn an, falls nicht möglich).
  • Richten Sie Ihre Basis-URL ein.
  • Fügen Sie erforderlichen iOS-spezifischen Code hinzu.
  • Stellen Sie eine Verbindung zu einer Sitzung her.

Zugriff bestätigen

Vergewissern Sie sich, dass Ihr Unternehmen Zugriff auf die Zertifizierung hat. Als Benutzer sollten Sie zum Profil für Adobe Experience Platform hinzugefügt werden. Siehe Benutzerzugriff im Zuverlässigkeitshandbuch für weitere Informationen.

Implementierung

Neben der allgemeinen SDK-InstallationWenn Sie in der vorherigen Lektion abgeschlossen haben, erfordert iOS auch den folgenden Zusatz, um die Assurance-Sitzung für Ihre App zu starten.

  1. Navigieren Sie zu Luma > Luma > SceneDelegate im Projektnavigator Ihres Xcode-Codes ein.

  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 sich die App im Hintergrund befindet und über einen Deep-Link geöffnet wird.

Weitere Informationen finden Sie unter here.

Bundle-Kennung definieren

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

  1. Öffnen Sie das Projekt in Xcode.

  2. Auswählen Luma im Projekt-Navigator.

  3. Wählen Sie die Luma Zielgruppe.

  4. Wählen Sie die Signieren und Funktionen Registerkarte.

  5. Definieren Sie eine Bundle-Kennung.

    note important
    IMPORTANT
    Stellen Sie sicher, dass Sie eine eindeutig Bundle-ID und ersetzen Sie com.adobe.luma.tutorial.swiftui Bundle-Kennung, da jede Bundle-ID eindeutig sein muss. In der Regel verwenden Sie ein Reverse-DNS-Format für Bundle-ID-Zeichenfolgen, z. B. com.organization.brand.uniqueidentifier. Die abgeschlossene Version dieses Tutorials verwendet beispielsweise com.adobe.luma.tutorial.swiftui.

    Xcode-Signaturfunktionen {modal="regular"}

Einrichten einer Basis-URL

  1. Wechseln Sie zu Ihrem Projekt in Xcode.

  2. Auswählen Luma im Projekt-Navigator.

  3. Wählen Sie die Luma Zielgruppe.

  4. Wählen Sie die Info Registerkarte.

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

  6. Satz Kennung auf die Bundle-ID Ihrer Wahl klicken und eine URL-Schemata Ihrer Wahl .

    Sicherungs-URL

    note important
    IMPORTANT
    Stellen Sie sicher, dass Sie eine eindeutig Bundle-ID und ersetzen Sie com.adobe.luma.tutorial.swiftui Bundle-Kennung, da jede Bundle-ID eindeutig sein muss. In der Regel verwenden Sie ein Reverse-DNS-Format für Bundle-ID-Zeichenfolgen, z. B. com.organization.brand.uniqueidentifier. Sie können dieselbe Bundle-ID verwenden, die Sie unter Bundle-Kennung definieren.
    Verwenden Sie auf ähnliche Weise ein eindeutiges URL-Schema und ersetzen Sie die bereits bereitgestellten lumatutorialswiftui mit Ihrem eindeutigen URL-Schema.

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

Assurance funktioniert durch Öffnen einer URL, entweder über einen Browser oder 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 aus Xcode neu und führen Sie sie mithilfe von Play .

    note tip
    TIP
    Optional können Sie Ihren Build "bereinigen", insbesondere wenn unerwartete Ergebnisse angezeigt werden. Wählen Sie dazu Bereinigen Sie den Build-Ordner… aus dem Xcode Produkt Menü.
  2. Im "Luma App"darf Ihren Standort verwenden Dialogfeld auswählen Zulassen bei Verwendung der App.

    {width="300"}

  3. Im "Luma App"möchte Ihnen Benachrichtigungen senden Dialogfeld auswählen Zulassen.

    {width="300"}

  4. Auswählen Weiter… , damit die App Ihre Aktivität verfolgen kann.

    {width="300"}

  5. Im Mit "Luma App"können Sie Ihre Aktivitäten über die Apps und Websites anderer Unternehmen hinweg verfolgen. Dialogfeld auswählen Zulassen.

    {width="300"}

In Ihrem Browser:

  1. Rufen Sie die Benutzeroberfläche für die Datenerfassung auf.

  2. Auswählen Assurance über die linke Leiste.

  3. Auswählen Sitzung erstellen.

  4. Auswählen Starten.

  5. Stellen Sie eine Sitzungsname wie Luma Mobile App Session und Basis-URL; dies sind die URL-Schemas, die Sie in Xcode eingegeben haben, gefolgt von :// Beispiel: lumatutorialswiftui://

  6. Klicken Sie auf Weiter.
    Sicherheitssitzung erstellen

  7. Im Neue Sitzung erstellen modaler Dialog:

    Wenn Sie ein physisches Gerät verwenden:

    • Auswählen QR-Code scannen. Um die App zu öffnen, verwenden Sie die Kamera auf Ihrem physischen Gerät, um den QR-Code zu scannen, und tippen Sie auf den Link.

      Zuverlässigkeitsqa-Code

    Wenn Sie einen Simulator verwenden:

    1. Auswählen Link kopieren.

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

      Link zum Kopieren der Assets

  8. Wenn die App geladen wird, wird Ihnen ein modales Dialogfeld angezeigt, in dem Sie aufgefordert werden, die in Schritt 7 dargestellte 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 Zuverlässigkeitssymbol, das über der App angezeigt wird.

      {width="300"}

    • Experience Cloud-Updates in der Assurance-Benutzeroberfläche, die Folgendes zeigen:

      1. Erlebnisereignisse aus der App.

      2. Details eines ausgewählten Ereignisses.

      3. Gerät und Timeline.

        Zuverlässigkeitsereignisse

Wenn Sie auf Herausforderungen stoßen, überprüfen Sie die technisch and general documentation.

Überprüfen von Erweiterungen

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

  1. Auswählen Konfigurieren.

  2. Auswählen Hinzufügen für 123 Erweiterungsversionen.

  3. Wählen Sie Speichern aus.

    Erweiterungsversionen konfigurieren

  4. Auswählen 123 Erweiterungsversionen , um einen Überblick über die neuesten verfügbaren Erweiterungen und die in Ihrer Version des Programms verwendeten Erweiterungen zu erhalten.

    Erweiterungsversionen

  5. So aktualisieren Sie Ihre Erweiterungsversionen (z. B. Messaging und Optimieren) wählen Sie das Paket (Erweiterung) aus Paketabhängigkeiten (zum Beispiel: AGPessaging) und wählen Sie im Kontextmenü die Option Paket aktualisieren. Xcode aktualisiert die Paketabhängigkeiten.

NOTE
Nachdem Sie Ihre Erweiterungen (Pakete) in Xcode aktualisiert haben, schließen und löschen Sie die aktuelle Sitzung und wiederholen Sie alle Schritte von Herstellen einer Verbindung zu einer Sitzung und Überprüfen von Erweiterungen , um sicherzustellen, dass die Zuverlässigkeitserklärung die korrekten Erweiterungen in einer neuen Zuverlässigkeitssitzung ordnungsgemäß meldet.
SUCCESS
Sie haben Ihre App jetzt so eingerichtet, dass sie für den Rest des Tutorials Assurance verwendet.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, ein allgemeines Feedback oder Vorschläge zu künftigen Inhalten teilen möchten, teilen Sie diese hier mit. Experience League Community-Diskussionsbeitrag

Weiter: Implementieren der Zustimmung

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