Intégration de Adobe Experience Platform Mobile SDK à Commerce
L’intégration de Adobe Experience Platform Mobile SDK à l’application mobile Commerce permet aux commerçants d’envoyer des données Commerce données d’événement à Experience Platform Edge.
Lorsque les données d’événement Commerce sont disponibles en périphérie, elles sont accessibles par d’autres applications Adobe Experience Cloud. Par exemple, vous pouvez utiliser les données pour créer des audiences dans Real-Time CDP, puis utiliser ces audiences pour personnaliser votre application mobile Commerce.
Configuration
Pour commencer à utiliser Adobe Experience Platform Mobile SDK avec Commerce, installez et configurez SDK dans Experience Platform. Ensuite, finalisez votre configuration dans Commerce.
Experience Platform
-
Découvrez les fonctionnalités des applications mobiles en consultant le tutoriel Adobe Experience Cloud dans les applications mobiles.
-
Installation et configuration le SDK dans Experience Platform.
note note NOTE Le schéma que vous créez et configurez dans Experience Platform est identique à celui que vous utilisez dans le code de l’application de votre application mobile Commerce.
Commerce
Une fois la configuration SDK de la plateforme Experience Platform terminée, ajoutez la configuration SDK à Commerce.
-
Pour envoyer des données d’événement Commerce à Experience Platform via SDK, vous devez fournir un schéma XDM dans le code de l’application. Ce schéma doit correspondre au schéma configuré pour le SDK dans Experience Platform.
L’exemple suivant montre comment effectuer le suivi de l’événement
web.webpagedetails.pageViews
et définir laidentityMap
à l’aide du champ d’e-mail.code language-swift let stateName = "luma: content: ios: us: en: home" var xdmData: [String: Any] = [ "eventType": "web.webpagedetails.pageViews", "web": [ "webPageDetails": [ "pageViews": [ "value": 1 ], "name": "Home page" ] ] ] let experienceEvent = ExperienceEvent(xdm: xdmData) Edge.sendEvent(experienceEvent: experienceEvent) // Adobe Experience Platform - Update Identity let emailLabel = "mobileuser@example.com" let identityMap: IdentityMap = IdentityMap() identityMap.add(item: IdentityItem(id: emailLabel), withNamespace: "Email") Identity.updateIdentities(with: identityMap)
-
Connectez-vous à l’environnement Commerce Cloud.
Dans les paramètres de version de votre projet, ajoutez l’URL au point d’entrée Commerce GraphQL. Par exemple :
- Déboguer : http://debug.commercesite.cloud/graphql/
- Version : http://release.commercesite.cloud/graphql/
-
Pour récupérer des données à partir des points d’entrée Commerce GraphQL, générez d’abord les fichiers et répertoires nécessaires dans votre projet à l’aide du Générateur de code Apollo.
-
Dans le répertoire du projet, installez Apollo iOS.
-
Initialisez l’interface de ligne de commande Apollo Codegen.
Cela crée un fichier
apollo-codegen-configuration.json
. -
Générez les fichiers et répertoires GraphQL nécessaires dans votre projet en remplaçant le contenu du fichier
apollo-codegen-configuration.json
par ce qui suit :code language-json { "schemaName" : "MagentoAPI", "input" : { "operationSearchPaths" : [ "**/*.graphql" ], "schemaSearchPaths" : [ "**/*.graphqls" ] }, "output" : { "testMocks" : { "none" : { } }, "schemaTypes" : { "path" : "../MagentoAPI", "moduleType" : { "swiftPackageManager" : { } } }, "operations" : { "inSchemaModule" : { } } }, "schemaDownloadConfiguration": { "downloadMethod": { "introspection": { "endpointURL": "http://magento24.com/graphql/", "httpMethod": { "POST": {} }, "includeDeprecatedInputValues": false, "outputFormat": "SDL" } }, "downloadTimeout": 60, "headers": [], "outputPath": "magento.graphqls" } }
-
Récupérer le schéma Commerce GraphQL.
Assurez-vous que le chemin d’accès se trouve dans le fichier
./apollo-codegen-config.json
, qui contient la référence au schéma Commerce GraphQL. -
Générez le code source.
Assurez-vous que le chemin d’accès se trouve dans le fichier
./apollo-codegen-config.json
, qui contient les informations de configuration pour générer les fichiers et répertoires nécessaires. -
Dans le dossier GraphQLGenerated nouvellement créé, ajoutez ou modifiez des types GraphQL. Par exemple, vous pouvez ajouter un type de
DynamicBlocks.graphql
avec le contenu suivant :code language-graphql query dynamicBlocks($input: DynamicBlocksFilterInput){ dynamicBlocks(input: $input) { items { content { html } } } }
Vous avez maintenant intégré Adobe Experience Platform Mobile SDK à votre application mobile Commerce. Les données d’événement circulent de votre application vers Experience Platform Edge.
-
Comment distinguer les événements Commerce générés à partir d'applications mobiles
Tous les événements contiennent un champ appelé channel
. Le champ channel
contient channel._id
et channel._type
qui, pour un storefront Luma, ont respectivement les valeurs d’espace de noms "https://ns.adobe.com/xdm/channels/web"
et "https://ns.adobe.com/xdm/channel-types/web"
. Toutefois, pour un storefront mobile, les valeurs des espaces de noms sont respectivement "https://ns.adobe.com/xdm/channels/mobile-app"
et "https://ns.adobe.com/xdm/channel-types/mobile"
.
Étapes suivantes
Pour savoir comment récupérer des audiences Real-Time CDP à partir de votre application Commerce mobile afin d’informer les règles de prix de panier, les blocs dynamiques et les règles de produit associées, consultez Audience Activation.