Installieren von Adobe Experience Platform Mobile SDKs

Erfahren Sie, wie Sie das Adobe Experience Platform Mobile SDK in eine Mobile App implementieren.

Voraussetzungen

Lernziele

In dieser Lektion werden Sie:

  • Fügen Sie Ihrem Projekt mithilfe des Swift Package Manager die erforderlichen SDKs hinzu.
  • Registrieren Sie die Erweiterungen.
NOTE
In einer Mobile-App-Implementierung sind die Begriffe "Erweiterungen"und "SDKs"nahezu austauschbar.

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:

Abhängigkeiten von Xcode-Paketen {zoomable="yes"}

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.

Paket
Beschreibung
AEP Core

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.
AEP Edge
Die mobile Adobe Experience Platform Edge Network-Erweiterung (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.
AEP Edge Identity
Die mobile Erweiterung "AEP Edge Identity"(AEPEdgeIdentity) ermöglicht die Verarbeitung von Benutzeridentitätsdaten aus einer Mobile App bei Verwendung des Adobe Experience Platform SDK und der Edge Network-Erweiterung.
Zustimmung zu AEP Edge
Die mobile Erweiterung "AEP Consent Collection"(AEPConsent) ermöglicht die Erfassung von Zustimmungsvoreinstellungen von der Mobile App bei Verwendung des Adobe Experience Platform SDK und der Edge Network-Erweiterung.
AEP-Benutzerprofil
Die Mobile-Erweiterung des Adobe Experience Platform-Benutzerprofils (AEPUserProfile) ist eine Erweiterung zur Verwaltung von Benutzerprofilen für das Adobe Experience Platform SDK.
AEP Places
Die AEP Places-Erweiterung (AEPPlaces) können Sie Geolocation-Ereignisse verfolgen, wie in der Adobe Places-Benutzeroberfläche und in den Adobe-Datenerfassungs-Tag-Regeln definiert.
AEP Messaging
Die AEP Messaging-Erweiterung (AEPMessaging) ermöglicht das Senden von Push-Benachrichtigungstoken und Push-Benachrichtigungs-Clickthrough-Feedback an die Adobe Experience Platform.
AEP Optimize
Die AEP Optimize-Erweiterung (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.
AEP Assurance
Assurance (alias Projekt Griffon) ist eine neue, innovative Erweiterung (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.

  1. Ersetzen Sie die @AppStorage value YOUR_ENVIRONMENT_ID_GOES_HERE für environmentFileId 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"
    
  2. 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:

  1. Registriert die erforderlichen Erweiterungen.
  2. Konfiguriert MobileCore und andere Erweiterungen für die Verwendung Ihrer Tag-Eigenschaftenkonfiguration.
  3. Aktiviert die Debug-Protokollierung. Weitere Informationen und Optionen finden Sie im Dokumentation zum Adobe Experience Platform Mobile SDK.
  4. Startet die Lebenszyklusüberwachung. Siehe Lebenszyklus im Tutorial für weitere Details.
  5. Legt die Standardzustimmung auf unbekannt fest. Siehe Einverständnis im Tutorial für weitere Details.
IMPORTANT
Stellen Sie sicher, dass Sie 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).
SUCCESS
Sie haben jetzt die erforderlichen Pakete installiert und Ihr Projekt aktualisiert, um die erforderlichen Adobe Experience Platform Mobile SDK-Erweiterungen, die Sie für den Rest des Tutorials verwenden werden, ordnungsgemäß zu registrieren.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, ein allgemeines Feedback oder Vorschläge zu künftigen Inhalten teilen möchten, teilen Sie diese hier mit. Experience League Community-Diskussionsbeitrag

Weiter: Einrichten der Sicherheit

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