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 Erweiterungen, die im Abschnitt vorherige Lektion.
- Entwicklungsumgebung - Datei-ID aus Installationsanweisungen für Mobilgeräte.
- Leere herunterladen Beispielanwendung.
- 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 (siehe SDK-Installationsanweisungen generieren), fügen Sie mithilfe des nativen Swift Package Manager von Xcode einzelne Pakete hinzu. Für das Xcode-Projekt wurden bereits alle Paketabhängigkeiten hinzugefügt. Der Xcode Paketabhängigkeiten Der Bildschirm sollte wie folgt aussehen:
{modal="regular"}
In Xcode können Sie Datei > Pakete hinzufügen… , 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 AEPCore
, AEPServices
, und AEPIdentity
Erweiterungen 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.
AEPCore
enthä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.AEPServices
bietet mehrere wiederverwendbare Implementierungen, die für die Plattformunterstützung erforderlich sind, einschließlich Netzwerk, Festplattenzugriff und Datenbankverwaltung.AEPIdentity
implementiert die Integration mit Adobe Experience Platform Identity-Diensten.AEPSignal
stellt die Signal-Erweiterung der Adobe Experience Platform SDKs dar, die es Marketing-Experten ermöglicht, ein "Signal"an ihre Apps zu senden, um Daten an externe Ziele zu senden oder URLs zu öffnen.AEPLifecycle
stellt die Adobe Experience Platform SDKs Lifecycle-Erweiterung dar, die bei der Erfassung von Lebenszyklusmetriken für Anwendungen wie Informationen zur Anwendungsinstallation oder -aktualisierung, zum Anwendungsstart und zu Sitzungsinformationen, Geräteinformationen und zusätzlichen Kontextdaten, die vom Anwendungsentwickler bereitgestellt werden, hilft.
AEPEdge
) ermöglicht den Versand von Daten von einer Mobile App an das Adobe Edge-Netzwerk. 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
AEPCore
und AEPServices
Erweiterungen für die Ereignisverarbeitung sowie die AEPEdgeIdentity
Erweiterung 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
) ermöglicht das Senden von Push-Benachrichtigungstoken und Push-Benachrichtigungs-Clickthrough-Feedback an die Adobe Experience Platform.AEPOptimize
) bietet APIs zum Aktivieren von Echtzeit-Personalisierungs-Workflows in den Adobe Experience Platform Mobile SDKs mithilfe der Adobe Target- oder Adobe Journey Optimizer-Offer decisioning. Sie erfordert AEPCore
und AEPEdge
Erweiterungen zum Senden von Personalisierungsabfrageereignissen an das Experience Edge-Netzwerk.AEPAssurance
), damit Sie die Erfassung, den Testversand, die Simulation und die Validierung der Datenerfassung und der Bereitstellung von Erlebnissen in Ihrer App unterstützen 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
Tun Sie dasselbe für Luma > Luma > Utils > MobileSDK.
AppDelegate aktualisieren
Navigieren Sie zu Luma > Luma > AppDelegate im Xcode-Projektnavigator.
-
Ersetzen Sie die
@AppStorage
valueYOUR_ENVIRONMENT_ID_GOES_HERE
fürenvironmentFileId
zum Wert der Datei-ID der Entwicklungsumgebung hinzufügen, den Sie aus den Tags in SDK-Installationsanweisungen generieren.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Fügen Sie den folgenden Code zum
application(_, didFinishLaunchingWithOptions)
-Funktion.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 im Dokumentation zum Adobe Experience Platform Mobile SDK.
- Startet die Lebenszyklusüberwachung. Siehe Lebenszyklus im Tutorial für weitere Details.
- Legt die Standardzustimmung auf unbekannt fest. Siehe Einverständnis im Tutorial für weitere Details.
MobileCore.configureWith(appId: self.environmentFileId)
mit dem appId
basierend auf der environmentFileId
aus der Tag-Umgebung, für die Sie erstellen (Entwicklung, Staging oder Produktion).Weiter: Einrichten der Sicherheit