Installieren von Adobe Experience Platform Mobile SDKs tutorial_install_mobile_sdks
Erfahren Sie, wie Sie das Adobe Experience Platform Mobile SDK in einer App implementieren.
Voraussetzungen
- Eine Tag-Bibliothek mit den in der vorherigen Lektion beschriebenen Erweiterungen wurde erstellt.
- Datei-ID der Entwicklungsumgebung aus der Installationsanweisungen für Mobilgeräte.
- hat die Beispielanwendung für iOS oder Beispielanwendung für Android".
- Erfahrung mit Xcode (iOS) oder Android Studio (Android)
Lernziele
In dieser Lektion erfahren Sie Folgendes:
- Fügen Sie Ihrem Projekt die erforderlichen SDKs hinzu.
- Registrieren Sie die Erweiterungen.
Swift Package Manager
Anstatt CocoaPods und eine Pod-Datei zu verwenden (wie unter Generate SDK install instructions beschrieben), fügen Sie einzelne Pakete mit dem nativen Swift Package Manager von Xcode hinzu. Dem 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. 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.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 | |
---|---|
Paket | Beschreibung |
AEP Core |
Die
|
AEP Edge | Mit der Adobe Experience Platform Edge Network Mobile-Erweiterung (AEPEdge ) können Sie Daten von einer Mobile App an das Adobe Edge Network 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 Adobe Experience Platform weiterleiten.Die Edge Network Mobile-Erweiterung ist eine Erweiterung für Adobe Experience Platform SDK. Die Erweiterung erfordert die AEPCore - und AEPServices -Erweiterungen für die Ereignisverarbeitung sowie die AEPEdgeIdentity -Erweiterung zum Abrufen der Identitäten (z. B. ECID). |
AEP Edge Identity | Die Adobe Experience Platform Edge Identity Mobile-Erweiterung (AEPEdgeIdentity ) ermöglicht die Verarbeitung von Benutzeridentitätsdaten aus einer Mobile App bei Verwendung der Adobe Experience Platform SDK und der Edge Network-Erweiterung. |
Einverständnis mit AEP Edge | Die Adobe Experience Platform Consent Collection Mobile Extension (AEPConsent ) ermöglicht die Erfassung von Einverständnisvoreinstellungen über die Mobile App bei Verwendung der Adobe Experience Platform SDK und der Edge Network-Erweiterung. |
AEP-Benutzerprofil | Die Adobe Experience Platform User Profile Mobile-Erweiterung (AEPUserProfile ) ist eine Erweiterung zur Verwaltung von Benutzerprofilen für die Adobe Experience Platform SDK. |
AEP Places | Mit der Adobe Experience Platform Places-Erweiterung (AEPPlaces ) können Sie Geolokalisierungsereignisse verfolgen, wie sie in der Adobe Places-Benutzeroberfläche und in Datenerfassungs-Tag-Regeln von Adobe definiert sind. |
AEP-Nachrichten | Mit der Adobe Experience Platform Messaging-Erweiterung (AEPMessaging ) können Sie Push-Benachrichtigungs-Token und Clickthrough-Feedback für Push-Benachrichtigungen an die Adobe Experience Platform senden. |
AEP Optimize | Die Adobe Experience Platform Optimize-Erweiterung (AEPOptimize ) stellt APIs bereit, um Echtzeit-Personalisierungs-Workflows in den Adobe Experience Platform Mobile SDKs mit Adobe Target oder Adobe Journey Optimizer Offer Decisioning zu ermöglichen. Es sind AEPCore - und AEPEdge -Erweiterungen erforderlich, um Personalisierungsabfrageereignisse an Experience Edge Network zu senden. |
AEP Assurance | Adobe Experience Platform Assurance ist ein Produkt von Adobe Experience Cloud, mit dem Sie die Datenerfassung und die Bereitstellung von Erlebnissen in Ihrer Mobile App untersuchen, testen, simulieren und validieren können. |
Erweiterungen importieren
Öffnen Sie in Xcode das Projekt im Start-Ordner der Beispielanwendung.
Navigieren Sie in Xcode zu Luma > Luma > AppDelegate und stellen Sie sicher, dass die folgenden Importe Teil dieser Quelldatei sind.
code language-swift |
---|
|
Tun Sie dasselbe für Luma > Luma > Utils > MobileSDK.
AppDelegate aktualisieren
Navigieren Sie im Xcode-Projekt Luma Navigator zu Luma > > AppDelegate.
-
Ersetzen Sie den
@AppStorage
WertYOUR_ENVIRONMENT_ID_GOES_HERE
fürenvironmentFileId
durch den Wert für die Umgebungsdatei-ID, den Sie von Tags in Installationsanweisungen für SDK generieren abgerufen haben.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Fügen Sie der
application(_, didFinishLaunchingWithOptions)
-Funktion 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 bewirkt Folgendes:
- Registriert die erforderlichen Erweiterungen.
- Konfiguriert MobileCore und andere Erweiterungen für die Verwendung Ihrer Tag-Eigenschaftskonfiguration.
- Aktiviert die Debug-Protokollierung. Weitere Informationen und Optionen finden Sie in der Dokumentation zu Adobe Experience Platform Mobile SDK.
- Startet die Lebenszyklusüberwachung. Weitere finden SieSchritt „Lebenszyklus“ im Tutorial .
- Setzt das Standard-Einverständnis auf unbekannt. Weitere finden SieSchritt „Einverständnis“ im Tutorial .
Stellen Sie sicher, dass Sie MobileCore.configureWith(appId: self.environmentFileId)
mit der appId
aktualisieren, basierend auf der environmentFileId
aus der Tag-Umgebung, für die Sie sie erstellen (Entwicklung, Staging oder Produktion).
Gradle
Wenn Sie die Abhängigkeiten aus den Installationsanweisungen für SDK generieren verwenden, um mithilfe der Integration von Gradle in Android individuelle Pakete hinzuzufügen, wurden im Android Studio-Projekt bereits alle Paketabhängigkeiten hinzugefügt.
-
Wählen Sie
-
Ansicht Android auswählen.
-
Wählen Sie Gradle scripts > build.gradle.kts (Module :app) im linken Bereich aus. Scrollen Sie dann im rechten Bereich, bis Sie
dependencies
sehen.
In Android Studio können Sie mit Datei > Projektstruktur… Modulabhängigkeiten hinzufügen. Wählen Sie Abhängigkeiten aus und verwenden Sie dann Module
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 | |
---|---|
package com.adobe marketing.mobile: |
Beschreibung |
core |
Die
|
edge | Mit der Adobe Experience Platform Edge Network Mobile-Erweiterung (AEPEdge ) können Sie Daten von einer Mobile App an das Adobe Edge Network 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 Adobe Experience Platform weiterleiten.Die Edge Network Mobile-Erweiterung ist eine Erweiterung für Adobe Experience Platform SDK. Für die Ereignisbehandlung sind die Erweiterungen Mobile Core und Services erforderlich. Und die Identity for Edge Network -Erweiterung zum Abrufen der Identitäten, z. B. ECID. |
EdgeIdentity | Die Adobe Experience Platform Edge Identity Mobile-Erweiterung ermöglicht die Verarbeitung von Benutzeridentitätsdaten aus einer Mobile App unter Verwendung der Adobe Experience Platform SDK und der Edge Network-Erweiterung. |
edgeConsent | Die Adobe Experience Platform-Erweiterung für Mobilgeräte zur Einverständniserfassung ermöglicht die Erfassung von Einverständnisvoreinstellungen über die Mobile App bei Verwendung der Adobe Experience Platform SDK und der Edge Network-Erweiterung. |
userprofile | Die Adobe Experience Platform-Erweiterung Benutzerprofil für Mobilgeräte ist eine Erweiterung zur Verwaltung von Benutzerprofilen für Adobe Experience Platform SDK. |
aepplaces | Adobe Places Service ist ein Standortdienst, der mobile Apps mit Standorterkennung ermöglicht. Außerdem erhalten Sie ein Verständnis des Standortkontexts durch die Verwendung umfangreicher und benutzerfreundlicher SDK-Schnittstellen sowie einer flexiblen Datenbank mit Interessensschwerpunkten (POIs). Weitere Informationen finden Sie in der Dokumentation zum Places-Service . Dieser Service ist die Places Mobile-Erweiterung für Android 2.x Adobe Experience Platform SDK und erfordert die Core-Erweiterung für die Ereignisverarbeitung. |
Messaging | Die Adobe Experience Platform Messaging-Erweiterung ermöglicht Push-Benachrichtigungen, In-App-Nachrichten und Code-basierte Erlebnisse für Ihre Mobile Apps. Diese Erweiterung hilft Ihnen auch bei der Erfassung von Benutzer-Push-Token und verwaltet die Interaktionsmessung mit Adobe Experience Platform-Services. |
Optimieren | Die Adobe Experience Platform Optimize-Erweiterung bietet APIs, um Echtzeit-Personalisierungs-Workflows in den Adobe Experience Platform SDKs mit Adobe Target oder Adobe Journey Optimizer Offer Decisioning zu ermöglichen. Dies hängt vom Mobile Core ab und erfordert, dass die Edge-Erweiterung Personalisierungsabfrageereignisse an Experience Edge Network sendet. |
Assurance | Assurance (auch bekannt als Projekt Griffon) ist eine mobile Erweiterung für Adobe Experience Platform, die die Integration mit Adobe Experience Platform Assurance ermöglicht. Die Erweiterung hilft beim Überprüfen, Testen, Simulieren und Überprüfen der Art und Weise, wie Sie Daten erfassen oder Erlebnisse in Ihrer Mobile App bereitstellen. Diese Erweiterung erfordert MobileCore. |
Erweiterungen importieren
Navigieren Sie in Android Studio zu app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication und stellen Sie sicher, dass die folgenden Importe Teil der Quelldatei sind.
code language-kotlin |
---|
|
Tun Sie dasselbe für app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK.
LumaApplication aktualisieren
In der Ansicht Android navigieren Sie zu app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication in Android Studio.
-
Ersetzen Sie
"YOUR_ENVIRONMENT_FILE_ID"
inprivate var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
durch den Wert für die Umgebungsdatei-ID, den Sie von Tags in Installationsanweisungen für SDK generieren abgerufen haben.code language-kotlin private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Fügen Sie den folgenden Code zu
override fun onCreate()
Funktion inclass LumaApplication : Application()
hinzu.code language-kotlin // Define extensions val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION ) // Register extensions MobileCore.registerExtensions(extensions) { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Log.i("Luma", "Using mobile config: $environmentFileId") MobileCore.configureWithAppID(environmentFileId) // set this to true when testing on your device, default is false. //MobileCore.updateConfiguration(mapOf("messaging.useSandbox" to true)) // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN) }
Der obige Code bewirkt Folgendes:
- Registriert die erforderlichen Erweiterungen.
- Konfiguriert MobileCore und andere Erweiterungen für die Verwendung Ihrer Tag-Eigenschaftskonfiguration.
- Aktiviert die Debug-Protokollierung. Weitere Informationen und Optionen finden Sie in der Dokumentation zu Adobe Experience Platform Mobile SDK.
- Startet die Lebenszyklusüberwachung. Weitere finden SieSchritt „Lebenszyklus“ im Tutorial .
- Setzt das Standard-Einverständnis auf unbekannt. Weitere finden SieSchritt „Einverständnis“ im Tutorial .
Stellen Sie sicher, dass Sie MobileCore.configureWith(environmentFileId)
mit der environmentFileId
aktualisieren, basierend auf der Umgebungsdatei-ID aus der Tag-Umgebung, für die Sie sie erstellen (Entwicklung, Staging oder Produktion).
Weiter: Einrichten von Assurance