Connexion des données Commerce à Adobe Experience Platform
Lors de l’installation de l’extension Data Connection, deux nouvelles pages de configuration s’affichent dans le menu System sous Services dans Commerce Admin.
- Connecteur Commerce Services
- Data Connection
Pour connecter votre instance Adobe Commerce à Adobe Experience Platform, vous devez configurer les deux connecteurs, en commençant par le connecteur Commerce Services , puis en finissant avec l’extension Data Connection.
Configuration du connecteur Commerce Services
Si vous avez précédemment installé un service Adobe Commerce, vous avez probablement déjà configuré le connecteur Commerce Services. Dans le cas contraire, vous devez effectuer les tâches suivantes sur la page Connecteur Commerce Services :
- Connectez-vous à votre compte Commerce pour récupérer vos clés d’API de production et d’environnement de test.
- Sélectionnez un espace de données SaaS.
- Connectez-vous à votre compte d’Adobe pour récupérer votre ID d’organisation.
Après avoir configuré le connecteur Commerce Services, vous pouvez configurer l’extension Data Connection.
Configuration de l’extension Data Connection
Dans cette section, vous apprendrez comment configurer l’extension Data Connection.
Ajout de détails sur le compte de service et les informations d’identification
Si vous prévoyez de collecter et d'envoyer des données de commande historiques ou des données de profil client, vous devez ajouter les détails de compte de service et d'identification. En outre, si vous configurez l’extension Audience Activation, vous devez effectuer ces étapes.
Si vous collectez et envoyez uniquement des données de storefront ou back-office, vous pouvez passer à la section general .
Étape 1 : création d’un projet dans Adobe Developer Console
Créez un projet dans Adobe Developer Console qui authentifie Commerce afin qu’il puisse effectuer des appels API Experience Platform.
Pour créer le projet, suivez les étapes décrites dans le tutoriel Authentification et accès aux API Experience Platform .
Lorsque vous passez en revue le tutoriel, assurez-vous que votre projet comporte les éléments suivants :
- Accès aux profils de produitsuivants : Production par défaut tous les accès et AEP Tous les accès par défaut.
- Les rôles et autorisations corrects sont configurés.
- Si vous avez décidé d’utiliser des jetons Web JSON (JWT) comme méthode d’authentification serveur à serveur, vous devez également télécharger une clé privée.
Le résultat de cette étape crée un fichier de configuration que vous utilisez à l’étape suivante.
Étape 2 : téléchargement du fichier de configuration
Téléchargez le fichier de configuration de l'espace de travail. Copiez et collez le contenu de ce fichier dans la page Informations d’identification/compte de service de l’administrateur Commerce.
-
Dans l’administrateur Commerce, accédez à Magasins > Paramètres > Configuration > Services > Data Connection.
-
Sélectionnez la méthode d’autorisation serveur à serveur que vous avez implémentée dans le menu Type d’autorisation Adobe Developer . Adobe recommande d’utiliser OAuth. JWT a été abandonné. En savoir plus.
-
(JWT uniquement) Copiez et collez le contenu de votre fichier
private.key
dans le champ Client Secret . Utilisez la commande suivante pour copier le contenu.code language-bash cat config/private.key | pbcopy
Voir Authentification du compte de service (JWT) pour plus d’informations sur le fichier
private.key
. -
Copiez le contenu du fichier
<workspace-name>.json
dans le champ Service Account/Credential details.{width="700" modal="regular"}
-
Cliquez sur Enregistrer la configuration.
Général
-
Dans l’Admin, accédez à Système > Services > Data Connection.
-
Dans l’onglet Paramètres sous Général, vérifiez l’ID associé à votre compte Adobe Experience Platform, tel que configuré dans le Connecteur de services Commerce. L’ID d’organisation est global. Un seul ID d’organisation peut être associé par instance Adobe Commerce.
-
Dans la liste déroulante Scope, définissez le contexte sur Website.
-
(Facultatif) Si un SDK Web AEP (alliage) a déjà été déployé sur votre site, cochez la case et ajoutez le nom de votre SDK Web AEP. Sinon, laissez ces champs vides et l’extension Data Connection en déploie un pour vous.
note note NOTE Si vous spécifiez votre propre SDK Web AEP, l’extension Data Connection utilise l’identifiant de flux de données associé à ce SDK et non l’identifiant de flux de données spécifié sur cette page (le cas échéant).
Collecte de données
Dans cette section, vous indiquez le type de données à collecter et à envoyer à l’Experience Platform Edge. Il existe trois types de données :
-
Comportement (données côté client) : les données sont capturées sur le storefront. Cela inclut les interactions des acheteurs, telles que
View Page
,View Product
,Add to Cart
et les informations liste de demandes (pour les commerçants B2B). -
Retour au bureau (données côté serveur) : les données sont capturées dans les serveurs Commerce. Cela inclut des informations sur l’état d’une commande, par exemple si une commande a été passée, annulée, remboursée, expédiée ou terminée. Il comprend également les données de commande historiques.
-
Profil (Beta) est une donnée liée aux informations de profil de votre acheteur. Découvrez more.
Pour vous assurer que votre instance Adobe Commerce peut commencer la collecte de données, passez en revue les conditions préalables.
Pour en savoir plus sur les événements storefront, back office et profile, consultez la rubrique événements.
-
Sélectionnez Événements Storefront si vous souhaitez envoyer des données comportementales storefront.
-
Sélectionnez Evénements administratifs si vous souhaitez envoyer des informations sur l'état de la commande, par exemple si une commande a été passée, annulée, remboursée ou expédiée.
note note NOTE Si vous sélectionnez Evénements de back-office, toutes les données de back-office sont envoyées à l’Experience Platform Edge. Si un acheteur choisit de se désabonner de la collecte de données, vous devez définir explicitement la préférence de confidentialité de l’acheteur dans l’Experience Platform. Cela diffère des événements storefront où le collecteur gère déjà le consentement en fonction des préférences de l’acheteur. Découvrez plus sur la définition des préférences de confidentialité d’un acheteur dans l’Experience Platform. -
(Ignorez cette étape si vous utilisez votre propre SDK Web AEP.) Créez un flux de données dans Adobe Experience Platform ou sélectionnez un flux de données existant à utiliser pour la collecte. Saisissez cet identifiant de flux de données dans le champ ID de flux de données.
-
Saisissez l’ identifiant du jeu de données que vous souhaitez contenir vos données Commerce. Pour trouver l’identifiant du jeu de données :
- Ouvrez l’interface utilisateur de l’Experience Platform et sélectionnez Jeux de données dans le volet de navigation de gauche pour ouvrir le tableau de bord Jeux de données. Le tableau de bord répertorie tous les jeux de données disponibles pour votre organisation. Des détails s’affichent pour chaque jeu de données répertorié, notamment son nom, le schéma auquel le jeu de données adhère et l’état de l’exécution d’ingestion la plus récente.
- Ouvrez le jeu de données associé à votre flux de données.
- Dans le volet de droite, affichez les détails du jeu de données. Copiez l’identifiant du jeu de données.
-
Pour assurer les mises à jour des données d’événement de back-office en fonction d’un planning conformément à une tâche cron, vous devez remplacer l’index
Sales Orders Feed
parUpdate by Schedule
.-
Sur la barre latérale Admin, accédez à System > Tools>Index Management.
-
Cochez la case correspondant à l’indexeur
Sales Orders Feed
. -
Définissez Actions sur
Update by Schedule
. -
Si vous activez les données du back-office pour la première fois, exécutez les commandes suivantes pour réindexer et déclencher une nouvelle synchronisation. Les resynchronisations suivantes se produisent automatiquement tant que la tâche cron est configurée correctement.
code language-bash bin/magento index:reindex sales_order_data_exporter_v2
code language-bash bin/magento saas:resync --feed orders
-
Descriptions des champs
Une fois l’intégration effectuée, les données du storefront commencent à s’écouler vers le bord Experience Platform. Les données du back-office prennent environ cinq minutes pour s’afficher à la périphérie. Les mises à jour suivantes sont visibles à la périphérie en fonction de la planification cron.
Envoi des données de profil client
Vous pouvez envoyer à l’Experience Platform deux types de données de profil : les enregistrements de profil et les événements de profil de série temporelle.
Un enregistrement de profil contient des données enregistrées lorsqu’un acheteur crée un profil dans votre instance Commerce, tel que le nom de l’acheteur. Lorsque votre schéma et votre jeu de données sont correctement configurés, un enregistrement de profil est envoyé à l’Experience Platform et transféré au service de gestion des profils et de segmentation d’Adobe : Real-Time CDP.
Les événements de profil de série temporelle contiennent des données sur les informations de profil de votre acheteur, telles que la création, la modification ou la suppression d’un compte sur votre site. Lorsque des données d’événement de profil sont envoyées à l’Experience Platform, elles se trouvent dans un jeu de données où elles peuvent être utilisées par d’autres produits DX.
-
Vérifiez que vous disposez du compte de service fourni et des informations d’identification.
-
Assurez-vous qu’un schéma et un jeu de données sont spécifiés pour l’ ingestion de données d’enregistrement de profil et l’ ingestion de données d’événement de profil de série temporelle.
-
Cochez la case Profils client si vous souhaitez envoyer des données de profil à l’Experience Platform.
-
Saisissez l’ identifiant du jeu de données de profil.
Les données d’enregistrement de profil doivent utiliser un jeu de données différent de celui que vous utilisez actuellement pour les données d’événement comportemental et back-office.
-
Si vous ne souhaitez pas diffuser des événements de profil par le biais du même identifiant de flux de données que celui utilisé pour les données comportementales et de back-office, supprimez la coche des profils client de flux via le même identifiant de flux de données et saisissez l’identifiant de flux de données que vous souhaitez utiliser à la place.
Il peut s’écouler environ 10 minutes avant qu’un enregistrement de profil soit disponible dans Real-Time CDP. Les événements de profil commencent immédiatement à être diffusés en continu.
Descriptions des champs
Envoi de données de commande historiques
Adobe Commerce collecte jusqu’à cinq années de données de commande historiques et état. Vous pouvez utiliser l’extension Data Connection pour envoyer ces données historiques à l’Experience Platform afin d’enrichir vos profils client et de personnaliser les expériences client en fonction de ces commandes passées. Les données sont stockées dans un jeu de données dans Experience Platform.
Bien que Commerce collecte déjà les données de commande historiques, vous devez effectuer plusieurs étapes pour envoyer ces données à l’Experience Platform.
Regardez cette vidéo pour en savoir plus sur les commandes historiques, puis effectuez les étapes suivantes pour mettre en oeuvre la collecte des commandes historiques.
Configuration du service de synchronisation des commandes
Le service de synchronisation des commandes utilise le Message Queue Framework et RabbitMQ. Une fois ces étapes terminées, les données d’état de la commande peuvent être synchronisées avec SaaS, ce qui est nécessaire avant d’être envoyées à l’Experience Platform.
-
Vérifiez que vous disposez du compte de service fourni et des informations d’identification.
-
Activer RabbitMQ.
note note NOTE RabbitMQ est déjà configuré pour Commerce versions 2.4.7 et ultérieures, mais vous devez activer les consommateurs. -
Activez les consommateurs de la file d’attente de messages par tâche cron dans
.magento.env.yaml
à l’aide de la variable d’environnementCRON_CONSUMERS_RUNNER
.code language-yaml stage: deploy: CRON_CONSUMERS_RUNNER: cron_run: true
note note NOTE Pour en savoir plus sur toutes les options de configuration disponibles, consultez la documentation sur le déploiement des variables .
Une fois le service de synchronisation des commandes activé, vous pouvez spécifier la période de commande historique dans la page Data Connection.
Définition de la période d’historique des commandes
Indiquez la période des commandes historiques à envoyer à l’Experience Platform.
-
Dans l’Admin, accédez à Système > Services > Data Connection.
-
Sélectionnez l’onglet Historique des commandes .
-
Sous Synchronisation de l’historique des commandes, la case à cocher Copier l’identifiant du jeu de données de Paramètres est déjà activée. Vous avez ainsi la garantie d’utiliser le même jeu de données que celui spécifié dans l’onglet Paramètres.
-
Dans les champs De et À , spécifiez la plage de dates pour les données de l’ordre historique que vous souhaitez envoyer. Vous ne pouvez pas sélectionner de période supérieure à cinq ans.
-
Sélectionnez Start Sync pour déclencher la synchronisation. Les données d’ordre historique sont des données par lots, contrairement aux données de vitrine et de back-office qui diffusent des données en continu. Les données mises en cache prennent environ 45 minutes pour arriver en Experience Platform.
Descriptions des champs
Confirmation que les données d’événement sont collectées
Pour confirmer que les données sont collectées à partir de votre boutique Commerce, utilisez le débogueur Adobe Experience Platform pour examiner votre site Commerce. Une fois que vous avez confirmé que les données sont en cours de collecte, vous pouvez vérifier que vos données d’événement storefront et back-office apparaissent en périphérie en exécutant une requête qui renvoie les données du jeu de données que vous avez créé.
-
Sélectionnez Requêtes dans le volet de navigation de gauche de l’Experience Platform et cliquez sur Create Query.
-
À l’ouverture de Query Editor, saisissez une requête qui sélectionne les données du jeu de données.
Par exemple, votre requête peut se présenter comme suit :
code language-sql SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
-
Une fois la requête exécutée, les résultats s’affichent dans l’onglet Résultats, en regard de l’onglet Console. Cette vue affiche la sortie tabulaire de votre requête.
Dans cet exemple, vous voyez les données d’événement de commerce.productListAdds
, commerce.productViews
, web.webpagedetails.pageViews
, etc. Cette vue vous permet de vérifier que vos données Commerce sont arrivées à la périphérie.
Si les résultats ne correspondent pas à vos attentes, ouvrez votre jeu de données et recherchez les importations de lots ayant échoué. En savoir plus sur la résolution des problèmes d’importation de lots.
Vérifier que les données de profil s’affichent dans l’Experience Platform
Si vous ne voyez pas les données de profil dans l’Experience Platform, reportez-vous à la base de connaissances Commerce pour obtenir des suggestions en matière de dépannage.
Étapes suivantes
Lorsque des données Commerce sont envoyées à l’Experience Platform Edge, d’autres produits Adobe Experience Cloud, tels que Adobe Journey Optimizer, peuvent utiliser ces données. Vous pouvez, par exemple, configurer Journey Optimizer pour écouter certains événements. En fonction de ces données d’événement, déclencher un courrier électronique pour un nouvel utilisateur ou si un panier est abandonné. Découvrez comment étendre votre plateforme Commerce en créant des parcours client dans Journey Optimizer.