Installieren von Adobe Experience Platform Mobile SDKs
Erfahren Sie, wie Sie das Adobe Experience Platform Mobile SDK in eine Mobile App implementieren.
Voraussetzungen
- eine Tag-Bibliothek mit den in der vorherigen Lektion beschriebenen Erweiterungen erfolgreich erstellt wurde.
- Kennung der Entwicklungsumgebung aus den Anweisungen zur mobilen Installation.
- Laden Sie die leere Beispiel-App herunter.
- Erlebnis mit Xcode.
Lernziele
In dieser Lektion werden Sie:
- Fügen Sie Ihrem Projekt mithilfe des Swift Package Manager die erforderlichen SDKs hinzu.
- Registrieren Sie die Erweiterungen.
Swift Package Manager
Anstatt CocoaPods und eine Pod-Datei zu verwenden (wie in SDK-Installationsanweisungen generieren beschrieben), fügen Sie einzelne Pakete mithilfe des nativen Swift Package Manager von Xcode hinzu. Für das Xcode-Projekt wurden bereits alle Paketabhängigkeiten hinzugefügt. Der Bildschirm Xcode Paketabhängigkeiten sollte wie folgt aussehen:
In Xcode können Sie Datei > Pakete hinzufügen… verwenden, um Pakete hinzuzufügen. Die nachstehende Tabelle enthält Links zu den URLs, die Sie zum Hinzufügen von Paketen verwenden würden. Über die Links gelangen Sie zu weiteren Informationen zu den einzelnen Paketen.
Die Erweiterungen AEPCore, AEPServices und AEPIdentity stellen die Grundlage des Adobe Experience Platform SDK dar. Jede App, die das SDK verwendet, muss sie enthalten. Diese Module enthalten einen gemeinsamen Satz von Funktionen und Diensten, die für alle SDK-Erweiterungen erforderlich sind.
AEPCoreenthält die Implementierung des Ereignis-Hub. Der Ereignis-Hub ist der Mechanismus zur Bereitstellung von Ereignissen zwischen der App und dem SDK. Der Ereignis-Hub wird auch zum Freigeben von Daten zwischen Erweiterungen verwendet.AEPServicesbietet mehrere wiederverwendbare Implementierungen, die für die Plattformunterstützung erforderlich sind, einschließlich Netzwerk, Festplattenzugriff und Datenbankverwaltung.AEPIdentityimplementiert die Integration mit Adobe Experience Platform Identity-Diensten.AEPSignalsteht für die Adobe Experience Platform SDKs Signal-Erweiterung, mit der Marketing-Experten ein "Signal"an ihre Apps senden können, um Daten an externe Ziele zu senden oder URLs zu öffnen.AEPLifecyclesteht für die Adobe Experience Platform SDKs-Lebenszykluserweiterung, die die Erfassung von Lebenszyklusmetriken für Anwendungen unterstützt, wie z. B. Informationen zur Anwendungsinstallation oder -aktualisierung, zum Anwendungsstart und zu Sitzungsinformationen, Geräteinformationen und alle vom Anwendungsentwickler bereitgestellten zusätzlichen Kontextdaten.
AEPEdge) können Sie Daten von einer Mobile App an das Adobe Edge-Netzwerk senden. Mit dieser Erweiterung können Sie Adobe Experience Cloud-Funktionen robuster implementieren, mehrere Adobe-Lösungen über einen Netzwerkaufruf bereitstellen und diese Informationen gleichzeitig an die Adobe Experience Platform weiterleiten.Die mobile Edge Network-Erweiterung ist eine Erweiterung für das Adobe Experience Platform SDK und erfordert die Erweiterungen
AEPCore und AEPServices für die Ereignisverarbeitung sowie die Erweiterung AEPEdgeIdentity zum Abrufen der Identitäten, z. B. ECID.AEPEdgeIdentity) ermöglicht die Verarbeitung von Benutzeridentitätsdaten aus einer Mobile App bei Verwendung des Adobe Experience Platform SDK und der Edge Network-Erweiterung.AEPConsent) ermöglicht die Erfassung von Zustimmungsvoreinstellungen von der Mobile App bei Verwendung des Adobe Experience Platform SDK und der Edge Network-Erweiterung.AEPUserProfile) ist eine Erweiterung zur Verwaltung von Benutzerprofilen für das Adobe Experience Platform SDK.AEPPlaces) können Sie Geolocation-Ereignisse verfolgen, wie in der Adobe Places-Benutzeroberfläche und in den Adobe-Datenerfassungs-Tag-Regeln definiert.AEPMessaging) können Sie Push-Benachrichtigungstoken und Push-Benachrichtigungs-Clickthrough-Feedback an die Adobe Experience Platform senden.AEPOptimize) bietet APIs, um Echtzeit-Personalisierungs-Workflows in den Adobe Experience Platform Mobile SDKs mithilfe von Adobe Target oder Adobe Journey Optimizer Offer decisioning zu aktivieren. Zum Senden von Personalisierungsabfrageereignissen an das Experience Edge-Netzwerk sind die Erweiterungen AEPCore und AEPEdge erforderlich.AEPAssurance), mit der Sie die Erfassung, den Testversand, die Simulation und die Validierung von Daten und die Bereitstellung von Erlebnissen in Ihrer App überprüfen und testen können. Diese Erweiterung aktiviert Ihre App für die Qualitätssicherung.Importieren von Erweiterungen
Navigieren Sie in Xcode zu Luma > Luma > AppDelegate und stellen Sie sicher, dass die folgenden Importe Teil dieser Quelldatei sind.
// import AEP MobileSDK libraries
import AEPCore
import AEPServices
import AEPIdentity
import AEPSignal
import AEPLifecycle
import AEPEdge
import AEPEdgeIdentity
import AEPEdgeConsent
import AEPUserProfile
import AEPPlaces
import AEPMessaging
import AEPOptimize
import AEPAssurance
Führen Sie dasselbe für Luma > Luma > Utils > MobileSDK aus.
AppDelegate aktualisieren
Navigieren Sie im Xcode Project-Navigator zu Luma > Luma > AppDelegate .
-
Ersetzen Sie den
@AppStorage-WertYOUR_ENVIRONMENT_ID_GOES_HEREfürenvironmentFileIddurch den Wert für die ID der Entwicklungsumgebung-Datei, den Sie aus den Tags in den SDK-Installationsanweisungen generieren abgerufen haben.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
Fügen Sie der Funktion
application(_, didFinishLaunchingWithOptions)den folgenden Code hinzu.code language-swift // Define extensions let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ] // Register extensions MobileCore.registerExtensions(extensions, { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Logger.aepMobileSDK.info("Luma - using mobile config: \(self.environmentFileId)") MobileCore.configureWith(appId: self.environmentFileId) // set this to false or comment it when deploying to TestFlight (default is false), // set this to true when testing on your device. MobileCore.updateConfigurationWith(configDict: ["messaging.useSandbox": true]) if appState != .background { // only start lifecycle if the application is not in the background MobileCore.lifecycleStart(additionalContextData: nil) } // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(.unknown) })
Der obige Code führt Folgendes aus:
- Registriert die erforderlichen Erweiterungen.
- Konfiguriert MobileCore und andere Erweiterungen für die Verwendung Ihrer Tag-Eigenschaftenkonfiguration.
- Aktiviert die Debug-Protokollierung. Weitere Informationen und Optionen finden Sie in der Dokumentation zum Adobe Experience Platform Mobile SDK🔗 .
- Startet die Lebenszyklusüberwachung. Weitere Informationen finden Sie im Schritt Lebenszyklus des Tutorials.
- Legt die Standardzustimmung auf unbekannt fest. Weitere Informationen finden Sie im Schritt Einverständnis des Tutorials.
MobileCore.configureWith(appId: self.environmentFileId) mit dem appId aktualisieren, der auf dem environmentFileId der Tag-Umgebung basiert, für die Sie erstellen (Entwicklung, Staging oder Produktion).Weiter: Einrichten der Versicherung