Installation des SDK mobiles Adobe Experience Platform tutorial_install_mobile_sdks
Découvrez comment mettre en œuvre Adobe Experience Platform Mobile SDK dans une application mobile.
Conditions préalables
- Bibliothèque de balises créée 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échargé 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 packages Swift.
- Enregistrez les extensions.
Gestionnaire de packages Swift
Au lieu d’utiliser des CocoaPods et un fichier Pod (comme indiqué dans Instructions d’installation de Generate SDK), vous pouvez ajouter des packages individuels à l’aide du gestionnaire de packages Swift natif de Xcode. Toutes les dépendances de packages ont déjà été ajoutées pour vous dans le projet Xcode. L’écran Xcode Dépendances de packages doit se présenter comme suit :
Dans Xcode, vous pouvez utiliser Fichier > Ajouter des packages… pour ajouter des packages. Le tableau ci-dessous fournit des liens vers les URL que vous pouvez utiliser pour ajouter des packages. Les liens vous redirigent é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 de SDK.
AEPCorecontient l’implémentation du hub d’événements. Event Hub est le mécanisme utilisé pour diffuser des événements entre l’application et le SDK. Event Hub est également utilisé pour partager des données entre les extensions.AEPServicesfournit plusieurs implémentations réutilisables nécessaires à la prise en charge de Platform, notamment la mise en réseau, l’accès au disque et la gestion des bases de données.AEPIdentityimplémente l’intégration avec les services Adobe Experience Platform Identity.AEPSignalreprésente l’extension Signal des SDK Adobe Experience Platform qui permet aux spécialistes marketing d’envoyer un « signal » à leurs applications pour envoyer des données à des destinations externes ou ouvrir des URL.AEPLifecyclereprésente l’extension de cycle de vie des SDK Adobe Experience Platform qui permet de collecter des mesures de cycle de vie des applications, telles que des informations d’installation ou de mise à niveau des applications, des informations de lancement et de session des applications, des informations sur les appareils et toute donnée contextuelle supplémentaire fournie par le développeur ou la développeuse 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 diffuser plusieurs solutions d’Adobe par le biais d’un appel réseau et de transférer simultanément ces informations au Adobe Experience Platform.L’extension mobile Edge Network est une extension de Adobe Experience Platform SDK qui nécessite les extensions
AEPCore et AEPServices pour la gestion des événements, ainsi que l’extension AEPEdgeIdentity pour la récupération des identités, telles que l’ECID.AEPEdgeIdentity) permet de gérer les données d’identité utilisateur d’une application mobile lors de l’utilisation de Adobe Experience Platform SDK et de l’extension Edge Network.AEPConsent) permet la collecte de préférences de consentement à partir de l’application mobile lors de l’utilisation du SDK Adobe Experience Platform et de l’extension de l’Edge Network.AEPUserProfile) est une extension permettant de gérer les profils utilisateur pour Adobe Experience Platform SDK.AEPPlaces) vous permet d’effectuer le suivi des événements de géolocalisation tels que définis dans l’interface d’Adobe Places et dans les règles de balise de collecte de données d’Adobe.AEPMessaging) vous permet d’envoyer des jetons de notification push et des commentaires relatifs aux clics publicitaires de notification push au 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. Elle 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 les données ou dont les expériences sont diffusées dans votre application mobile. Cette extension active votre application pour Assurance.Importer des 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_HEREpourenvironmentFileIdà la valeur de l’identifiant du fichier d’environnement de développement que vous avez récupérée à partir des balises dans Générer les instructions d’installation de SDK.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 propriété de balise.
- Active la journalisation du débogage. Vous trouverez plus d’informations et d’options dans la documentation de Adobe Experience Platform Mobile SDK 🔗.
- Démarre la surveillance du cycle de vie. Voir l’étape Cycle de vie du tutoriel pour plus d’informations.
- Définit le consentement par défaut sur inconnu. Voir l’étape Consentement du tutoriel pour plus d’informations.
MobileCore.configureWith(appId: self.environmentFileId) avec le appId en fonction des environmentFileId de l’environnement de balises pour lequel vous créez des ressources (développement, évaluation ou production).Suivant : Configuration d’Assurance