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 zur Zuverlässigkeit finden Sie 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. Weitere Informationen finden Sie unter Benutzerzugriff im Zuverlässigkeitshandbuch.

Implementierung

Zusätzlich zur allgemeinen SDK-Installation, die Sie in der vorherigen Lektion abgeschlossen haben, erfordert iOS auch die folgende Ergänzung, um die Assurance-Sitzung für Ihre App zu starten.

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

Weitere Informationen finden Sie hier.

Bundle-Kennung definieren

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

  1. Öffnen Sie das Projekt in Xcode.

  2. Wählen Sie im Projektnavigator Luma aus.

  3. Wählen Sie das Ziel Luma aus.

  4. Wählen Sie die Registerkarte Signing & Capabilities aus.

  5. Definieren Sie eine Bundle-Kennung.

    note important
    IMPORTANT
    Stellen Sie sicher, dass Sie eine eindeutige Bundle-ID verwenden und die com.adobe.luma.tutorial.swiftui -Bundle-ID ersetzen, da jede Bundle-ID eindeutig sein muss. Normalerweise 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. Wählen Sie im Projektnavigator Luma aus.

  3. Wählen Sie das Ziel 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. Setzen Sie Kennung auf die Bundle-Kennung Ihrer Wahl und legen Sie ein URL-Schema Ihrer Wahl fest.

    Sicherungs-URL

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

Weitere Informationen zu URL-Schemata in iOS finden Sie in der 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 mit Play aus.

    note tip
    TIP
    Optional können Sie Ihren Build "bereinigen", insbesondere wenn unerwartete Ergebnisse angezeigt werden. Wählen Sie dazu Ordner bereinigen… aus dem Menü Xcode Produkt aus.
  2. Wählen Sie im Dialogfeld Zulassen, dass "Luma App"Ihre Position verwendet" die Option Während Verwendung der App zulassen.

    {width="300"}

  3. Wählen Sie im Dialogfeld "Luma App"Möchten Sie Benachrichtigungen senden die Option Zulassen.

    {width="300"}

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

    {width="300"}

  5. Wählen Sie im Dialogfeld Zulassen, dass "Luma App"Ihre Aktivität über die Apps und Websites anderer Unternehmen hinweg verfolgt, die Option Zulassen aus.

    {width="300"}

In Ihrem Browser:

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

  2. Wählen Sie in der linken Leiste die Option Versicherung aus.

  3. Wählen Sie Sitzung erstellen aus.

  4. Wählen Sie Start aus.

  5. Geben Sie einen Sitzungsnamen wie Luma Mobile App Session und die Basis-URL an, bei denen es sich um die URL-Schemas handelt, die Sie in Xcode eingegeben haben, gefolgt von :// Beispiel: lumatutorialswiftui://

  6. Klicken Sie auf Weiter.
    assurance create session

  7. Im modalen Dialogfeld Neue Sitzung erstellen :

    Wenn Sie ein physisches Gerät verwenden:

    • Wählen Sie QR-Code scannen aus. 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.

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

      Link zum Kopieren der Garantie

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

  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, lesen Sie die technischen und die allgemeinen Dokumentation.

Überprüfen von Erweiterungen

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.

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

    Erweiterungsversionen

  5. Um Ihre Erweiterungsversionen zu aktualisieren (z. B. Messaging und Optimize), wählen Sie das Paket (Erweiterung) aus Paketabhängigkeiten (z. B. APMessaging) und wählen Sie im Kontextmenü die Option Paket aktualisieren aus. 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 aus Herstellen einer Verbindung zu einer Sitzung und Überprüfen von Erweiterungen, um sicherzustellen, dass die Zuverlässigkeitsberichte die richtigen Erweiterungen in einer neuen Zuverlässigkeitssitzung enthalten.
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, allgemeine Rückmeldungen oder Anregungen zu künftigen Inhalten teilen möchten, teilen Sie diese auf diesem Experience League Community-Diskussionbeitrag mit.

Weiter: Einverständnis implementieren

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