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 section leçon précédente.
- Identifiant du fichier d’environnement de développement du Instructions d’installation mobile.
- Téléchargé le vide exemple d’application.
- 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 Instructions d’installation du SDK Generate), 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. Xcode Dépendances de modules L’écran 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 utiliseriez pour ajouter des packages. Les liens vous dirigent également vers des informations supplémentaires sur chaque package spécifique.
La variable AEPCore, AEPServices, et AEPIdentity Les extensions 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 du 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 afin d’envoyer des données à des destinations externes ou d’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 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 à Adobe Edge Network à 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 qui requiert le
AEPCore et AEPServices les extensions pour la gestion des événements, ainsi que la variable AEPEdgeIdentity pour récupérer les identités, telles qu’ECID.AEPEdgeIdentity) permet de gérer les 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) active 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. Cela nécessite AEPCore et AEPEdge extensions pour envoyer des événements de requête de personnalisation au réseau Experience Edge.AEPAssurance) pour vous aider à inspecter, tester, simuler et 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 imports suivants 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 variable
@AppStoragevalueYOUR_ENVIRONMENT_ID_GOES_HEREpourenvironmentFileIdà la valeur d’identifiant de fichier d’environnement de développement que vous avez récupérée à partir des balises dans Instructions d’installation du SDK Generate.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
Ajoutez le code suivant au
application(_, didFinishLaunchingWithOptions)de la fonctioncode 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 section Documentation du SDK Mobile Adobe Experience Platform.
- Commence la surveillance du cycle de vie. Voir Cycle de vie pour plus d’informations, consultez le tutoriel .
- Définit le consentement par défaut sur inconnu. Voir Consentement pour plus d’informations, consultez le tutoriel .
MobileCore.configureWith(appId: self.environmentFileId) avec la propriété appId en fonction de la variable environmentFileId à partir de l’environnement de balises pour lequel vous créez (développement, évaluation ou production).Suivant : Configuration d’Assurance