Installation des SDK Adobe Experience Platform Mobile
Découvrez comment mettre en oeuvre le SDK Mobile Adobe Experience Platform dans une application mobile.
Conditions préalables
- Création réussie d’une bibliothèque de balises avec les extensions décrites dans la leçon précédente.
- Identifiant du fichier d’environnement de développement à partir des instructions d’installation mobile.
- Téléchargez l’ exemple d’application vide.
- Expérience avec Xcode.
Objectifs d'apprentissage
Dans cette leçon, vous allez :
- Ajoutez les SDK requis à votre projet à l’aide du gestionnaire de modules Swift.
- Enregistrez les extensions.
Swift Package Manager
Au lieu d’utiliser CocoaPods et un fichier Pod (comme indiqué dans la section Générer les instructions d’installation du SDK), vous ajoutez des modules individuels à l’aide du gestionnaire de modules Swift natif de Xcode. Toutes les dépendances de packages sont déjà ajoutées pour le projet Xcode. L'écran Xcode Dépendances de module doit se présenter comme suit :
Dans Xcode, vous pouvez utiliser File > Add Packages… pour ajouter des packages. Le tableau ci-dessous fournit des liens vers les URL que vous utiliseriez pour ajouter des packages. Les liens vous dirigent également vers des informations supplémentaires sur chaque package spécifique.
Les extensions AEPCore, AEPServices et AEPIdentity représentent la base du SDK Adobe Experience Platform ; chaque application utilisant le SDK doit les inclure. Ces modules contiennent un ensemble commun de fonctionnalités et de services requis par toutes les extensions SDK.
AEPCorecontient l’implémentation de Event Hub. Event Hub est le mécanisme utilisé pour diffuser des événements entre l’application et le SDK. Event Hub est également utilisé pour le partage de données entre les extensions.AEPServicesfournit plusieurs implémentations réutilisables nécessaires à la prise en charge de la plateforme, notamment la mise en réseau, l’accès au disque et la gestion de base de données.AEPIdentitymet en oeuvre l’intégration avec les services Adobe Experience Platform Identity.AEPSignalreprésente l’extension Signal des SDK Adobe Experience Platform qui permet aux marketeurs d’envoyer un "signal" à leurs applications pour envoyer des données à des destinations externes ou ouvrir des URL.AEPLifecyclereprésente l’extension du cycle de vie des SDK Adobe Experience Platform qui permet de collecter des mesures de cycle de vie des applications, telles que les informations d’installation ou de mise à niveau de l’application, les informations de lancement et de session de l’application, les informations sur l’appareil et toute donnée contextuelle supplémentaire fournie par le développeur de l’application.
AEPEdge) vous permet d’envoyer des données au réseau Adobe Edge à partir d’une application mobile. Cette extension vous permet d’implémenter les fonctionnalités de Adobe Experience Cloud de manière plus robuste, de servir plusieurs solutions d’Adobe par le biais d’un seul appel réseau et de transférer simultanément ces informations à Adobe Experience Platform.L’extension mobile Edge Network est une extension du SDK Adobe Experience Platform et requiert les extensions
AEPCore et AEPServices pour la gestion des événements, ainsi que l’extension AEPEdgeIdentity pour la récupération des identités, comme ECID.AEPEdgeIdentity) permet la gestion des données d’identité utilisateur d’une application mobile lors de l’utilisation du SDK Adobe Experience Platform et de l’extension Edge Network.AEPConsent) permet la collecte des préférences de consentement à partir de l’application mobile lors de l’utilisation du SDK Adobe Experience Platform et de l’extension Edge Network.AEPUserProfile) est une extension permettant de gérer les profils utilisateur pour le SDK Adobe Experience Platform.AEPPlaces) vous permet de suivre les événements de géolocalisation tels que définis dans l’interface Adobe Places et dans les règles Adobe Data Collection Tag.AEPMessaging) vous permet d’envoyer des jetons de notification push et des commentaires de clic publicitaire de notification push à Adobe Experience Platform.AEPOptimize) fournit des API pour activer les workflows de personnalisation en temps réel dans les SDK mobiles Adobe Experience Platform à l’aide d’Adobe Target ou de l’Offer decisioning Adobe Journey Optimizer. Il nécessite des extensions AEPCore et AEPEdge pour envoyer des événements de requête de personnalisation au réseau Experience Edge.AEPAssurance) qui vous permet d’inspecter, de tester, de simuler et de valider la manière dont vous collectez des données ou diffusez des expériences dans votre application mobile. Cette extension active votre application pour l’assurance.Importation d’extensions
Dans Xcode, accédez à Luma > Luma > AppDelegate et assurez-vous que les importations suivantes font partie de ce fichier source.
// 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
Faites de même pour Luma > Luma > Utils > MobileSDK.
Mettre à jour AppDelegate
Accédez à Luma > Luma > AppDelegate dans le navigateur de projet Xcode.
-
Remplacez la valeur
@AppStorageYOUR_ENVIRONMENT_ID_GOES_HEREdeenvironmentFileIdpar la valeur d’identifiant de fichier d’environnement de développement que vous avez récupérée à partir des balises dans les instructions d’installation du SDK Generate.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
Ajoutez le code suivant à la fonction
application(_, didFinishLaunchingWithOptions).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) })
Le code ci-dessus effectue les opérations suivantes :
- Enregistre les extensions requises.
- Configure MobileCore et d’autres extensions pour utiliser la configuration de la propriété de balise.
- Active la journalisation de débogage. Vous trouverez plus de détails et d’options dans la documentation du SDK Mobile Adobe Experience Platform.
- Commence la surveillance du cycle de vie. Pour plus d’informations, voir l’étape Cycle de vie du tutoriel.
- Définit le consentement par défaut sur inconnu. Pour plus d’informations, voir l’étape Consentement du tutoriel.
MobileCore.configureWith(appId: self.environmentFileId) avec le appId en fonction de l’ environmentFileId de l’environnement de balises pour lequel vous créez (développement, évaluation ou production).Suivant : Configuration de l’assurance