DocumentationCommerceData Connection extension pour Adobe Commerce

Connexion des données Commerce à Adobe Experience Platform

Last update: Mon Oct 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration

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 :

  1. Connectez-vous à votre compte Commerce pour récupérer vos clés d’API de production et d’environnement de test.
  2. Sélectionnez un espace de données SaaS.
  3. 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.

  1. Dans l’administrateur Commerce, accédez à Magasins > Paramètres > Configuration > Services > Data Connection.

  2. 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.

  3. (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.

  4. Copiez le contenu du fichier <workspace-name>.json dans le champ Service Account/Credential details.

    Data Connection Configuration de l’administrateur {width="700" modal="regular"}

  5. Cliquez sur Enregistrer la configuration.

  6. Cliquez sur le bouton Test connection pour vous assurer que le compte de service et les informations d’identification que vous avez saisies sont corrects.

Général

  1. Dans l’Admin, accédez à Système > Services > Data Connection.

    Data Connection Paramètres {width="700" modal="regular"}

  2. 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.

  3. Dans la liste déroulante Scope, définissez le contexte sur Website.

  4. (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.

  • Profile 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.

NOTE
Tous les champs de la section Collecte de données s'appliquent à la portée de Website ou supérieure.

  1. Sélectionnez Événements Storefront si vous souhaitez envoyer des données comportementales storefront.

  2. 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.

  3. (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.

  4. 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 :

    1. 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.
    2. Ouvrez le jeu de données associé à votre flux de données.
    3. Dans le volet de droite, affichez les détails du jeu de données. Copiez l’identifiant du jeu de données.

  5. 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 par Update by Schedule.

    1. Sur la barre latérale Admin, accédez à System > Tools>Index Management.

    2. Cochez la case correspondant à l’indexeur Sales Orders Feed.

    3. Définissez Actions sur Update by Schedule.

    4. 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

Champ
Description
Portée
Site web spécifique sur lequel vous souhaitez appliquer les paramètres de configuration.
ID d’organisation (global)
Identifiant appartenant à l’organisation qui a acheté le produit Adobe DX. Cet identifiant associe votre instance Adobe Commerce à Adobe Experience Platform.
Le SDK Web AEP est-il déjà déployé sur votre site ?
Cochez cette case si vous avez déployé votre propre SDK Web AEP sur votre site.
Nom du SDK Web AEP (global)
Si un SDK Web Experience Platform est déjà déployé sur votre site, indiquez le nom de ce SDK dans ce champ. Cela permet au collecteur d’événements Storefront et au SDK d’événements Storefront d’utiliser votre SDK web Experience Platform plutôt que la version déployée par l’extension Data Connection. Si aucun SDK Web Experience Platform n’est déployé sur votre site, laissez ce champ vide et l’extension Data Connection en déploie un pour vous.
Événements Storefront
Est coché par défaut tant que l’ID d’organisation et l’ID de flux de données sont valides. Les événements Storefront collectent des données comportementales anonymes de vos clients lorsqu’ils naviguent sur votre site.
Événements de back-office
Si cette case est cochée, la payload d’événement contient des informations d’état de commande anonymes, telles qu’une commande passée, annulée, remboursée ou expédiée.
Identifiant de la banque de données (site web)
Identifiant qui permet aux données de passer de Adobe Experience Platform à d’autres produits DX d’Adobe. Cet identifiant doit être associé à un site web spécifique dans votre instance Adobe Commerce spécifique. Si vous spécifiez votre propre SDK Web Experience Platform, ne spécifiez pas d’identifiant de flux de données dans ce champ. L’extension Data Connection utilise l’identifiant de flux de données associé à ce SDK et ignore tout identifiant de flux de données spécifié dans ce champ (le cas échéant).
Identifiant du jeu de données (site web)
Identifiant du jeu de données qui contient vos données Commerce. Ce champ est obligatoire, sauf si vous avez désélectionné les cases à cocher Evénements Storefront ou Evénements Back-office . En outre, si vous utilisez votre propre SDK Web Experience Platform et n’avez donc pas spécifié d’identifiant de flux de données, vous devez toujours ajouter l’identifiant de jeu de données associé à votre flux de données. Sinon, vous ne pouvez pas enregistrer ce formulaire.

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.

  1. Vérifiez que vous disposez du compte de service fourni et des informations d’identification.

  2. 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.

  3. Cochez la case Profils client si vous souhaitez envoyer des données de profil à l’Experience Platform.

  4. 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.

  5. 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.

TIP
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.

Descriptions des champs

Champ
Description
Profils client
Cochez cette case si vous souhaitez collecter et envoyer des enregistrements de profil client.
Identifiant du jeu de données de profil
Un enregistrement de profil doit utiliser un jeu de données différent de celui utilisé pour les événements de comportement et de back-office.
Diffusion en continu des profils client à l’aide du même identifiant de flux de données
Déterminez si vous souhaitez utiliser la même banque de données actuellement utilisée pour vos événements de comportement et back-office ou non.
Flux de données pour les profils client
Spécifiez le flux de données spécifique à l’enregistrement du profil client.

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.

https://video.tv.adobe.com/v/3424672

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.

  1. Vérifiez que vous disposez du compte de service fourni et des informations d’identification.

  2. 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.

  3. Activez les consommateurs de la file d’attente de messages par tâche cron dans .magento.env.yaml à l’aide de la variable d’environnement CRON_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.

  1. Dans l’Admin, accédez à Système > Services > Data Connection.

  2. Sélectionnez l’onglet Historique des commandes .

    Data Connection Historique des commandes {width="700" modal="regular"}

  3. 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.

  4. 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.

  5. 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
Champ
Description
Copier l’identifiant du jeu de données depuis les paramètres
Copie l’identifiant du jeu de données que vous avez saisi dans l’onglet Paramètres .
Identifiant du jeu de données (site web)
Identifiant du jeu de données qui contient vos données Commerce. Ce champ est obligatoire, sauf si vous avez désélectionné les cases à cocher Evénements Storefront ou Evénements Back-office . En outre, si vous utilisez votre propre SDK Web Experience Platform et n’avez donc pas spécifié d’identifiant de flux de données, vous devez toujours ajouter l’identifiant de jeu de données associé à votre flux de données. Sinon, vous ne pouvez pas enregistrer ce formulaire.
De
Date à partir de laquelle vous souhaitez commencer à collecter les données de l’historique des commandes.
À
Date à partir de laquelle vous souhaitez terminer la collecte des données d’historique des commandes.
Démarrer la synchronisation
Démarre le processus de synchronisation des données de l’historique des commandes avec le serveur Experience Platform Edge. Ce bouton est désactivé si le champ Dataset ID est vide ou si l’identifiant du jeu de données n’est pas valide.

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 à l’Experience Platform.

Data Connection Personnalisation des données {width="700" modal="regular"}

IMPORTANT
Assurez-vous que l’identifiant de la banque de données que vous avez spécifié sur l’onglet Collecte de données correspond à l’identifiant lié au schéma pour l’ingestion d’attributs personnalisés.

Lors de la création d’attributs personnalisés pour les commandes et de leur envoi à l’Experience Platform, les noms d’attributs dans Commerce doivent correspondre à ceux du schéma Commerce sur l’Experience Platform. S’ils ne correspondent pas, il peut être difficile d’identifier les différences. Si les noms ne correspondent pas, la table Attributs de commande personnalisés peut vous aider à résoudre le problème.

La table Attributs de commande personnalisés offre une visibilité sur la configuration et le mappage des attributs de commande personnalisés entre le Commerce back office et le schéma Commerce dans Experience Platform. Ce tableau vous permet d’afficher les attributs personnalisés au niveau de la commande et de l’élément de commande de différentes sources, ce qui facilite l’identification des attributs manquants ou mal alignés. Il 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 aucune coche verte ne s’affiche 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. Une coche verte s’affiche, indiquant que les noms correspondent désormais.

  • Si le nom de l’attribut est mis à jour dans le schéma en Experience Platform, vous devez enregistrer la configuration dans l’onglet Personnalisation des données pour déclencher la modification du schéma Experience Platform. Cette modification sera répercutée dans la table 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 la table Attributs de commande personnalisés. Le changement sera reflété dans environ 60 minutes.

Découvrez comment configurer des attributs personnalisés.

Descriptions des champs

Champ
Description
Jeu de données
Affiche les jeux de données qui contiennent les attributs personnalisés. Les jeux de données actifs et historiques peuvent avoir leurs propres attributs personnalisés.
Adobe Commerce
Affiche tous les attributs personnalisés créés dans le Commerce back-office.
Experience Platform
Affiche tous les attributs personnalisés spécifiés dans votre schéma Commerce en Experience Platform.
Actualiser
Récupère tous les noms d’attribut personnalisés du schéma Commerce dans Experience Platform.

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éé.

  1. Sélectionnez Requêtes dans le volet de navigation de gauche de l’Experience Platform et cliquez sur Create Query.

    Éditeur de requête

  2. À l’ouverture de Query Editor, saisissez une requête qui sélectionne les données du jeu de données.

    Créer une requête

    Par exemple, votre requête peut se présenter comme suit :

    code language-sql 
    SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC

  3. 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.

    Éditeur de 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.

recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840