DocumentationCommerceData Connection extension pour Adobe Commerce

Installer Data Connection

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Administration
  • Développeur

Avant d’installer l’extension, vérifiez les conditions préalables.

Installation de l’extension

L’extension Data Connection est disponible sur Adobe Marketplace. Lorsque vous installez cette extension à partir de la ligne de commande du serveur, elle se connecte à votre installation Adobe Commerce en tant que service. Une fois le processus terminé, Data Connection et Commerce Services Connector apparaissent dans le menu System sous Services dans Commerce Admin.

Data Connection extension Admin view

IMPORTANT
Bien que le nom de l’extension ait été remplacé par Data Connection depuis le connecteur Experience Platform, le nom du package reste experience-platform-connector pour prendre en charge la compatibilité ascendante.

  1. Pour télécharger le package experience-platform-connector, exécutez le suivant à partir de la ligne de commande :

    code language-bash 
    composer require magento/experience-platform-connector

    Ce métapaquage contient les modules et extensions suivants :

    • module-experience-connector-admin - Met à jour l’interface utilisateur d’administration afin que vous puissiez sélectionner l’identifiant de flux de données pour une instance Adobe Commerce spécifique.
    • module-experience-connector - Définit les Organization ID et datastreamId dans le SDK des événements Storefront.
    • data-services - Fournit un contexte d’attribut pour les événements storefront. Par exemple, lorsqu’un événement de passage en caisse se produit, des informations sur le nombre d’articles figurant dans le panier et les données d’attribut de produit pour ces articles sont incluses.
    • services-id - Connecte votre instance Adobe Commerce à Adobe Commerce SaaS à l’aide des clés d’API de test et de production et à Adobe Experience Platform pour récupérer l’ID d’organisation IMS.
    • orders-connector - Connecte le service d’état de la commande à votre instance Adobe Commerce.

  2. (Facultatif) Pour inclure des données Live Search, qui comprennent des événements de recherche, installez l’extension Live Search.

  3. (Facultatif) Pour inclure des données B2B, qui comprennent événements de demande, installez l’ extension B2B.

Installation des événements d’Adobe I/O

Après avoir installé l’extension experience-platform-connector, vous devez installer les événements Adobe I/O pour Adobe Commerce.

Les étapes suivantes s’appliquent à Adobe Commerce sur l’infrastructure cloud et aux installations sur site.

  1. Si vous exécutez Commerce 2.4.4 ou 2.4.5, utilisez la commande suivante pour charger les modules d’événement :

    code language-bash 
    composer require magento/commerce-eventing=^1.0 --no-update

    Commerce 2.4.6 et versions ultérieures chargent ces modules automatiquement.

  2. Mettez à jour les dépendances du projet.

    code language-bash 
    composer update

  3. Activez les nouveaux modules :

    code language-bash 
    bin/magento module:enable Magento_AdobeCommerceEventsClient Magento_AdobeCommerceEventsGenerator Magento_AdobeIoEventsClient Magento_AdobeCommerceOutOfProcessExtensibility

Finalisez l’installation en fonction du type de déploiement : infrastructure sur site ou Adobe Commerce on Cloud .

Sur site

Dans les environnements locaux, vous devez activer manuellement la génération de code et les événements Adobe Commerce :

bin/magento events:generate:module
bin/magento module:enable Magento_AdobeCommerceEvents
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento config:set adobe_io_events/eventing/enabled 1

Sur l’infrastructure cloud

Dans l’infrastructure Adobe Commerce on Cloud, activez la variable globale ENABLE_EVENTING dans .magento.env.yaml. En savoir plus.

stage:
   global:
      ENABLE_EVENTING: true

Validez et envoyez les fichiers mis à jour dans l’environnement cloud. Lorsque le déploiement est terminé, activez l’envoi d’événements avec la commande suivante :

bin/magento config:set adobe_io_events/eventing/enabled 1

Installation de l’extension B2B

Pour les commerçants B2B, installez l’extension suivante afin d’inclure les données d’événement liste de demandes.

Téléchargez l’extension magento/experience-platform-connector-b2b en exécutant les opérations suivantes à partir de la ligne de commande :

composer require magento/experience-platform-connector-b2b

Mettre à jour l’extension Data Connection update

Pour mettre à jour l’extension Data Connection, exécutez les opérations suivantes à partir de la ligne de commande :

composer update magento/experience-platform-connector --with-dependencies

Ou, pour les marchands B2B :

composer update magento/experience-platform-connector-b2b --with-dependencies

Pour effectuer une mise à jour vers une version majeure, telle que de 2.0.0 à 3.0.0, modifiez le fichier Composer .json racine du projet comme suit :

  1. Ouvrez le fichier racine composer.json et recherchez magento/experience-platform-connector.

  2. Dans la section require , mettez à jour le numéro de version comme suit :

    code language-json 
    "require": {
   ...
   "magento/experience-platform-connector": "^3.0",
   ...
 }

  3. Enregistrer composer.json. Exécutez ensuite la commande suivante à partir de la ligne de commande :

    code language-bash 
    composer update magento/experience-platform-connector –-with-dependencies

    Ou, pour les marchands B2B :

    code language-bash 
    composer update magento/experience-platform-connector-b2b --with-dependencies

Désinstaller l’extension Data Connection uninstall

Pour désinstaller l’extension Data Connection, reportez-vous à la section désinstallation des modules.

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