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.
-
Navigieren Sie im Projektnavigator Ihres Xcode zu Luma > Luma > SceneDelegate .
-
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.
-
Öffnen Sie das Projekt in Xcode.
-
Wählen Sie im Projektnavigator Luma aus.
-
Wählen Sie das Ziel Luma aus.
-
Wählen Sie die Registerkarte Signing & Capabilities aus.
-
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 beispielsweisecom.adobe.luma.tutorial.swiftui
.{modal="regular"}
Einrichten einer Basis-URL
-
Wechseln Sie zu Ihrem Projekt in Xcode.
-
Wählen Sie im Projektnavigator Luma aus.
-
Wählen Sie das Ziel Luma aus.
-
Wählen Sie die Registerkarte Info aus.
-
Um eine Basis-URL hinzuzufügen, scrollen Sie nach unten zu URL-Typen und wählen Sie die Schaltfläche + aus.
-
Setzen Sie Kennung auf die Bundle-Kennung Ihrer Wahl und legen Sie ein URL-Schema Ihrer Wahl fest.
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 bereitgestelltelumatutorialswiftui
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:
-
Erstellen Sie die App im Simulator oder auf einem physischen Gerät aus Xcode neu und führen Sie sie mit 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. -
Wählen Sie im Dialogfeld Zulassen, dass "Luma App"Ihre Position verwendet" die Option Während Verwendung der App zulassen.
{width="300"}
-
Wählen Sie im Dialogfeld "Luma App"Möchten Sie Benachrichtigungen senden die Option Zulassen.
{width="300"}
-
Wählen Sie Fortfahren… aus, damit die App Ihre Aktivität verfolgen kann.
{width="300"}
-
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:
-
Rufen Sie die Benutzeroberfläche für die Datenerfassung auf.
-
Wählen Sie in der linken Leiste die Option Versicherung aus.
-
Wählen Sie Sitzung erstellen aus.
-
Wählen Sie Start aus.
-
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://
-
Klicken Sie auf Weiter.
-
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.
Wenn Sie einen Simulator verwenden:
-
Wählen Sie Link kopieren aus.
-
Kopieren Sie den Deep-Link mit und verwenden Sie den Deep-Link, um die App mit Safari im Simulator zu öffnen.
-
-
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.
-
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:
-
Erlebnisereignisse aus der App.
-
Details eines ausgewählten Ereignisses.
-
Gerät und Timeline.
-
-
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:
-
Wählen Sie Konfigurieren aus.
-
Wählen Sie für Erweiterungsversionen.
-
Wählen Sie Speichern aus.
-
Wählen Sie Erweiterungsversionen aus, um einen Überblick über die neuesten verfügbaren Erweiterungen und die in Ihrer Version der App verwendeten Erweiterungen anzuzeigen.
-
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.
Weiter: Einverständnis implementieren