Connexion des données Commerce à Adobe Experience Platform
- Rubriques :
- Personnalisation
- Configuration
Créé pour :
- Administration
Lorsque vous installez l’extension Data Connection, deux nouvelles pages de configuration apparaissent dans le menu Système sous Services dans Commerce Admin.
- Commerce Services Connector
- Data Connection
Pour connecter votre instance Adobe Commerce au Adobe Experience Platform, vous devez configurer les deux connecteurs, en commençant par le connecteur Commerce Services, puis en terminant par 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 API de production et sandbox.
- Sélectionnez un espace de données SaaS.
- Connectez-vous à votre compte Adobe pour récupérer votre ID d’organisation.
Une fois que vous avez configuré le connecteur Commerce Services, vous devez configurer l’extension Data Connection.
Configuration de l’extension Data Connection
Dans cette section, vous apprendrez à configurer l’extension Data Connection.
Ajout des détails du compte de service et des 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 des détails de compte de service et d’informations d’identification. En outre, si vous configurez l’extension Audience Activation, vous devez effectuer les étapes suivantes.
Si vous collectez et envoyez uniquement des données de storefront ou de back-office, vous pouvez passer à la section général.
Étape 1 : créer un projet dans Adobe Developer Console
Créez un projet dans le 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.
Au fur et à mesure que vous parcourez le tutoriel, assurez-vous que votre projet dispose des éléments suivants :
- Accédez aux profils de produit suivants : Tous les accès de production par défaut et Tous les accès par défaut d’AEP.
- Les rôles et autorisations appropriés sont configurés.
- Si vous avez décidé d’utiliser les jetons web JSON (JWT) comme méthode d’authentification serveur à serveur, vous devez également charger une clé privée.
Le résultat de cette étape crée un fichier de configuration que vous utiliserez à l’étape suivante.
Étape 2 : télécharger le fichier de configuration
Téléchargez le fichier de configuration de l’espace de travail. Copiez et collez le contenu de ce fichier sur la page Compte de service/Informations d’identification de l’administration Commerce.
-
Dans Commerce Admin, 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. Le jeton JWT a été abandonné. En savoir plus.
-
(JWT uniquement) Copiez et collez le contenu de votre fichier
private.keydans le champ Secret client. Utilisez la commande suivante pour copier le contenu.cat config/private.key | pbcopyVoir Authentification du compte de service (JWT) pour plus d’informations sur le fichier
private.key. -
Copiez le contenu du fichier
<workspace-name>.jsondans le champ Compte de service/Informations d’identification.Configuration d’
-
Cliquez sur Enregistrer la configuration.
-
Cliquez sur le bouton Test connection pour vous assurer que le compte de service et les informations d’identification que vous avez saisis sont corrects.
Général
-
Dans Admin, accédez à Système > Services > Data Connection.
-
Dans l’onglet Paramètres sous Général, vérifiez l’identifiant associé à votre compte Adobe Experience Platform, tel que configuré dans le Connecteur de services Commerce. L’ID d’organisation est global. Un seul identifiant d’organisation peut être associé par instance Adobe Commerce.
-
Dans le menu déroulant Portée, définissez le contexte sur Site Web.
-
(Facultatif) Si vous avez déjà déployé un AEP Web SDK (alliage) sur votre site, cochez la case et ajoutez le nom de votre AEP Web SDK. Sinon, laissez ces champs vides et l’extension Data Connection en déploie un pour vous.
NOTESi vous spécifiez votre propre SDK Web AEP, l’extension Data Connection utilise l’identifiant du flux de données associé à ce SDK et non l’identifiant du 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 à Experience Platform Edge. Il existe trois types de données :
-
Les données comportementales (données côté client) sont des données capturées sur le storefront. Cela inclut les interactions d’acheteurs, telles que
View Page,View Product,Add to Cartet liste de demandes d’approvisionnement (pour les commerçants B2B). -
Le Back Office (données côté serveur) correspond aux données capturées sur les serveurs Commerce. Cela inclut des informations sur le statut d’une commande, comme si une commande a été passée, annulée, remboursée, expédiée ou terminée. Il comprend également des données d’ordre historiques.
-
Profil correspond aux données liées aux informations de profil de votre acheteur. En savoir plus.
Pour vous assurer que votre instance Adobe Commerce peut commencer la collecte de données, consultez les conditions préalables.
Consultez la rubrique sur les événements pour en savoir plus sur les événements storefront, back office et profile.
NOTE-
Sélectionnez Événements Storefront si vous souhaitez envoyer des données comportementales de storefront.
-
Sélectionnez Événements back-office si vous souhaitez envoyer des informations sur le statut de la commande, par exemple si une commande a été passée, annulée, remboursée ou expédiée.
NOTESi vous sélectionnez Événements de back-office, toutes les données de back-office sont envoyées à Experience Platform Edge. Si un acheteur choisit de se désabonner de la collecte de données, vous devez définir explicitement sa préférence de confidentialité dans Experience Platform. Cela diffère des événements de storefront où le collecteur gère déjà le consentement en fonction des préférences de l’acheteur. En savoir plus sur la définition des préférences de confidentialité d’un acheteur dans 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 Identifiant du flux de données.
-
Saisissez l’identifiant du jeu de données qui doit contenir vos données Commerce. Pour trouver l’identifiant du jeu de données :
- Ouvrez l’interface utilisateur d’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 le statut 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 garantir des mises à jour des données d’événement de back-office basées sur un planning en fonction d’une tâche cron, vous devez remplacer l’index
Sales Orders FeedparUpdate by Schedule.-
Dans la barre latérale Admin, accédez à System > Tools>Index Management.
-
Cochez la case de l’indexeur de
Sales Orders Feed. -
Définissez Actions sur
Update by Schedule. -
Si vous activez les données de back-office pour la première fois, exécutez les commandes suivantes pour réindexer et déclencher une resynchronisation. Les resynchronisations suivantes se produisent automatiquement si la tâche cron est configurée correctement.
bin/magento index:reindex sales_order_data_exporter_v2bin/magento saas:resync --feed orders
-
Descriptions des champs
Après l’intégration, les données du storefront commencent à circuler vers Experience Platform Edge. Les données de back-office mettent environ cinq minutes à apparaître à la périphérie. Les mises à jour suivantes sont visibles au niveau du serveur Edge selon le planning cron.
Envoyer des données de profil client
Vous pouvez envoyer deux types de données de profil à Experience Platform : les enregistrements de profil et les événements de profil de série temporelle.
Un enregistrement de profil contient des données qui sont 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é à 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, par exemple s’ils créent, modifient ou suppriment un compte sur votre site. Lorsque les données d’événement de profil sont envoyées à Experience Platform, elles résident dans un jeu de données où elles peuvent être utilisées par d’autres produits DX.
-
Vérifiez que vous avez fourni le compte de service et les informations d’identification.
-
Assurez-vous de disposer d’un schéma et d’un jeu de données spécifiés pour ingestion des données d’enregistrement de profil et ingestion des 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 à 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 comportementales et d’événement 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 que vous utilisez pour les données comportementales et de back-office, supprimez la coche de la case Diffuser des profils client par le biais du même identifiant de flux de données et saisissez l’identifiant du flux de données que vous souhaitez utiliser à la place.
La disponibilité d’un enregistrement de profil dans Real-Time CDP peut prendre environ 10 minutes. Les événements de profil commencent immédiatement à diffuser.
TIPDescriptions des champs
Envoyer les données de commande historiques
Adobe Commerce collecte jusqu’à cinq ans de données et statut d’ordre historique. Vous pouvez utiliser l’extension Data Connection pour envoyer ces données historiques à 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 au sein d’Experience Platform.
Bien que Commerce collecte déjà les données de commande historiques, vous devez suivre plusieurs étapes pour envoyer ces données à Experience Platform.
Regardez cette vidéo pour en savoir plus sur les ordres historiques, puis effectuez les étapes suivantes pour implémenter la collecte des ordres historiques.
Configurer le service de synchronisation des commandes
Le service de synchronisation des commandes utilise Message Queue Framework et RabbitMQ. Une fois ces étapes terminées, les données de statut de la commande peuvent être synchronisées avec SaaS, ce qui est obligatoire avant leur envoi à Experience Platform.
-
Vérifiez que vous avez fourni le compte de service et les informations d’identification.
-
Activer RabbitMQ.
NOTERabbitMQ est déjà configuré pour les versions 2.4.7 et ultérieures de Commerce, mais vous devez activer les consommateurs. -
Activez les consommateurs de file d’attente de messages par tâche cron dans
.magento.env.yamlà l’aide deCRON_CONSUMERS_RUNNERvariable d’environnement .stage: deploy: CRON_CONSUMERS_RUNNER: cron_run: trueNOTEConsultez la documentation sur le déploiement des variables pour en savoir plus sur toutes les options de configuration disponibles.
Lorsque le service de synchronisation des commandes est activé, vous pouvez spécifier la période de commande historique dans la page Data Connection.
Spécifier la période de l’historique des commandes
Indiquez la période des commandes historiques que vous souhaitez envoyer à Experience Platform.
-
Dans 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’ID du jeu de données à partir des paramètres est déjà activée. Vous utilisez ainsi le même jeu de données que celui spécifié dans l’onglet Paramètres.
-
Dans les champs De et À, indiquez la période pour les données de commande historiques que vous souhaitez envoyer. Vous ne pouvez pas sélectionner une période de plus de cinq ans.
-
Sélectionnez Start Sync pour déclencher la synchronisation pour commencer. Les données de commande historiques sont des données par lots, par opposition aux données de storefront et de back-office qui sont des données en flux continu. Les données par lots arrivent dans Experience Platform en 45 minutes environ.
Descriptions des champs
Personnalisation des données
Dans l’onglet Personnalisation des données, vous pouvez afficher tous les attributs personnalisés configurés dans Commerce et envoyés à Experience Platform.
Personnalisation
IMPORTANTLors de la création d’attributs personnalisés pour les commandes et de leur envoi à Experience Platform, les noms des attributs dans Commerce doivent correspondre à ceux du schéma Commerce dans Experience Platform. S’ils ne correspondent pas, il peut être difficile d’identifier les différences. Si des noms ne correspondent pas, le tableau Attributs de commande personnalisés peut vous aider à résoudre le problème.
Le tableau Attributs de commande personnalisés offre une visibilité sur la configuration et le mappage des attributs de commande personnalisés entre le back-office Commerce et le schéma Commerce dans Experience Platform. Ce tableau vous permet de consulter les attributs personnalisés au niveau des commandes et des articles de commande dans différentes sources, ce qui facilite l'identification des attributs manquants ou non alignés. Elle affiche également les identifiants des jeux de données pour aider à différencier les jeux de données actifs et historiques, car chacun peut avoir ses propres attributs personnalisés.
Si vous ne voyez pas de coche verte en regard d’un nom d’attribut personnalisé dans le tableau, cela indique une incohérence entre les noms d’attribut dans les sources. Corrigez le nom de l’attribut dans une source et une coche verte s’affichera, indiquant que les noms correspondent désormais.
- Si le nom de l’attribut est mis à jour dans le schéma d’Experience Platform, vous devez enregistrer la configuration dans l’onglet Personnalisation des données pour déclencher la modification du schéma d’Experience Platform. Cette modification sera répercutée dans le tableau Attributs de commande personnalisés lorsque vous cliquerez sur le bouton Refresh.
- Si le nom de l’attribut est mis à jour dans Commerce, un événement de commande doit être généré pour mettre à jour le nom dans le tableau Attributs de commande personnalisés. Le changement se reflétera dans environ 60 minutes.
En savoir plus sur la configuration d’attributs personnalisés.
Descriptions des champs
Confirmer que les données d’événement sont collectées
Pour confirmer que les données sont collectées à partir de votre magasin Commerce, utilisez le débogueur Adobe Experience Platform pour examiner votre site Commerce. Une fois que vous avez confirmé que les données sont collectées, vous pouvez vérifier que vos données d’événement storefront et back office s’affichent à la 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 d’Experience Platform, puis cliquez sur Create Query.
-
Lorsque Query Editor s’ouvre, saisissez une requête qui sélectionne les données du jeu de données.
Par exemple, votre requête peut ressembler à ce qui suit :
SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC -
Une fois la requête exécutée, les résultats sont affichés 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 verrez des données d’événement provenant des commerce.productListAdds, commerce.productViews, web.webpagedetails.pageViews, etc. Cette vue vous permet de vérifier que vos données Commerce sont arrivées à l’edge.
Si les résultats ne sont pas ceux attendus, ouvrez votre jeu de données et recherchez tous les lots d’importation ayant échoué. En savoir plus sur la résolution des problèmes d’imports par lots.
Vérifier que les données de profil apparaissent dans Experience Platform
Si vous ne voyez pas les données de profil dans Experience Platform, consultez la Base de connaissances Commerce pour obtenir des suggestions de dépannage.
Étapes suivantes
Lorsque des données Commerce sont envoyées à Experience Platform Edge, d’autres produits Adobe Experience Cloud, tels que Adobe Journey Optimizer, peuvent utiliser ces données. Par exemple, vous pouvez configurer Journey Optimizer pour qu’il écoute certains événements. En fonction des données de ces événements, déclenchez un e-mail pour un premier utilisateur ou une première utilisatrice ou s’il existe un panier abandonné. Découvrez comment étendre votre plateforme Commerce en créant des parcours client dans Journey Optimizer.