DocumentationCommerceOptimizer Connector

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Prise en main

Dernière mise à jour : 1 juin 2026

Créé pour :

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Installez et configurez le Adobe Commerce Optimizer Connector pour synchroniser les données de votre catalogue Adobe Commerce avec Adobe Commerce Optimizer, puis surveillez le statut de synchronisation des données pour vous assurer que votre storefront est à jour.

IMPORTANT
Connectez toujours les instances Sandbox Optimizer aux environnements hors production et les instances de production aux environnements de production. Les environnements incohérents entraînent des incohérences au niveau des données de catalogue, des résultats de recherche et des recommandations.

Conditions requises pour utiliser l’intégration requirements-to-use-the-integration

L’utilisateur Adobe Commerce configurant l’intégration doit disposer des éléments suivants :

Supprimer les extensions en conflit remove-conflicting-extensions

Si l’une des extensions suivantes est installée, désinstallez-la avant d’installer le Adobe Commerce Optimizer Connector :

  • Adobe Commerce Live Search (magento/live-search)
  • Adobe Commerce Product Recommendations (magento/product-recommendations)
  • Adobe Commerce Catalog Service (magento/catalog-service, magento/catalog-service-installer)
  • Data Management Dashboard (magento-catalog-sync-admin)

Les données associées à ces extensions sont toujours disponibles dans la base de données Commerce. Cependant, il n’est pas exporté vers Commerce Optimizer lorsque le connecteur est activé. Pour implémenter les fonctionnalités de recherche et de merchandising fournies par ces extensions après l’activation du connecteur, configurez-les à partir de l’interface utilisateur d’administration Commerce Optimizer Admin.

IMPORTANT
Si ces extensions ne sont pas supprimées avant l’activation du connecteur, vous risquez de voir des écrans de configuration rompus, des données en double dans Commerce Optimizer car les mêmes données sont exportées à partir du connecteur et des extensions existantes, ainsi que des erreurs 401 ou 403 dans les journaux en raison de conflits dans la manière dont les extensions et le connecteur s’authentifient avec les services connectés.
style
shade-box

Étapes de configuration configuration-steps

Pour activer le Adobe Commerce Optimizer Connector et commencer à synchroniser les données de Adobe Commerce vers votre instance Commerce Optimizer, procédez comme suit.

  1. Installez le Adobe Commerce Optimizer Connector package à l’aide du compositeur pour connecter votre instance Adobe Commerce à Commerce Optimizer.

  2. Personnalisez la configuration d’exportation des portées de Commerce depuis l’Administration.

  3. Activez l Commerce Optimizer intégration.

  4. Vérifiez que la synchronisation des données fonctionne.

Installation du package Adobe Commerce Optimizer Connector install-the-adobe-commerce-optimizer-connector-package

Le Adobe Commerce Optimizer Connector est fourni en tant que métapaquet Compositeur disponible pour tous les commerçants Commerce disposant d’une licence active pour Commerce Optimizer.

Etapes d’installation

  1. Ajoutez le module adobe-commerce/commerce-data-export-aco-adapter à l’aide du compositeur :

    code language-shell 
    composer require adobe-commerce/commerce-data-export-aco-adapter

  2. Déployez les modifications dans votre environnement d’évaluation Adobe Commerce.

    Une fois le déploiement terminé, l’option Commerce Optimizer est disponible dans le menu Commerce Admin . Sélectionnez Commerce Optimizer pour ouvrir votre instance Commerce Optimizer directement à partir de l’Administration Commerce.

NOTE
Pour obtenir des instructions d’installation d’extension détaillées, consultez les guides suivants :
Installer l’extension sur Adobe Commerce sur une infrastructure cloud
Installer l’extension sur Adobe Commerce site

Personnalisation de la configuration de l’exportation des étendues de Commerce customize-the-commerce-scopes-export-configuration

Par défaut, la synchronisation des données de catalogue est activée pour toutes les portées de Commerce (sites web, groupes de clients et vues de magasin). Vous pouvez personnaliser les paramètres d’exportation pour synchroniser les données uniquement pour des portées spécifiques en fonction des besoins de votre entreprise. Par exemple, si plusieurs vues de magasin partagent la même langue, vous pouvez choisir d’exporter les données d’une seule vue de magasin et de les utiliser comme source de catalogue pour plusieurs vues de catalogue dans Commerce Optimizer.

IMPORTANT
La modification des paramètres d’exportation déclenche une réindexation complète, ce qui peut prendre beaucoup de temps en fonction de la taille de votre catalogue. Adobe recommande de configurer les étendues de Commerce pour qu’elles soient synchronisées avec Commerce Optimizer avant d’activer l’intégration et de démarrer la synchronisation initiale des données.

Le tableau suivant décrit les données exportées à chaque niveau de l’étendue :

Portée
Données exportées
Remarques
Site web et groupe de clients
Prix et registres des prix
Chaque ensemble de prix est exporté sous la forme d’un catalogue de prix en utilisant la <website>::<SHA1 of customer group ID> de convention d’affectation des noms. Tous les groupes de clients du site web sont inclus.
Affichage de la boutique
Produits et attributs de produit
Chaque vue de magasin crée une source de catalogue distincte dans Commerce Optimizer.

Grille de magasin avec paramètres de synchronisation Commerce Optimizer {width="600" modal="regular"}

Pour modifier les paramètres d’exportation de l’étendue

  1. Dans Commerce Admin, accédez à Stores > Settings > All Stores.

  2. Sélectionnez le site web ou la vue de magasin que vous souhaitez configurer.

  3. Dans les paramètres de l’exportateur de , cochez la case pour activer ou désactiver la synchronisation des données si nécessaire.​Commerce Optimizer

    Mettre à jour la configuration de la synchronisation des données {width="500" modal="regular"}

  4. Enregistrez vos modifications.

Activer et désactiver le comportement

Action
Résultat
Désactivation d’une vue de magasin
La désactivation de la synchronisation supprime les données de catalogue de votre storefront. La source du catalogue reste en Commerce Optimizer, mais toutes les données synchronisées sont supprimées lors de la prochaine exécution cron.
Désactiver puis réactiver une vue de magasin
La même source de catalogue est renseignée à nouveau avec une resynchronisation complète des données.

Activation de l’intégration Commerce Optimizer enable-the-adobe-commerce-optimizer-integration

Activez l’intégration et lancez la synchronisation des données en exécutant la commande de l’interface de ligne de commande aco:config:init. Cette commande effectue les étapes suivantes :

  1. Obtient un jeton d’accès IMS à l’aide des informations d’identification fournies en tant qu’arguments de ligne de commande.
  2. Appelle le service Commerce Cloud Manager (CCM) à l’adresse https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId} pour valider le client et extraire l’URL d’ingestion et l’URL Commerce Optimizer Studio.
  3. Enregistre toute la configuration (secret client chiffré) dans core_config_data.
  4. Planifie la synchronisation complète initiale en invalidant tous les indexeurs de flux Commerce Optimizer.
IMPORTANT
Le traitement de la synchronisation des données démarre en arrière-plan dès que vous avez terminé la configuration. Selon la taille de votre catalogue, le processus de synchronisation des données peut prendre de quelques minutes à plusieurs heures.

Obtenir les détails de connexion requis

À partir de 🔗, créez un projet activé pour le service d’ingestion Commerce Optimizer et générez des informations d’identification de serveur à serveur OAuth. Pour obtenir des instructions détaillées, voir Obtention des informations d’identification IMS dans le Guide du développeur du marchandisage.

Enregistrez les valeurs suivantes à partir de la page des informations d’identification :

  • Identifiant de l’organisation (org_id)
  • Identifiant client (client_id)
  • Secret client (client_secret)

Obtention des informations d’identification à partir de la page du projet Adobe Developer Console {width="500" modal="regular"}

Obtention des détails de l’instance Commerce Optimizer

Récupérez l’identifiant du client à partir du champ Instance Id​de l’instance Commerce Optimizer Instance details page ou à partir de l’URL utilisée pour accéder à l’instance. Par exemple, dans https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home.

  1. Dans l’Administration de Commerce, sélectionnez Adobe Commerce Optimizer pour afficher la page de configuration avec les instructions.

    Commerce Optimizer page de configuration {width="500" modal="regular"}

  2. À partir de la ligne de commande, utilisez SSH pour vous connecter à l’environnement d’évaluation Adobe Commerce.

  3. Exécutez la commande d’interface de ligne de commande Adobe Commerce suivante pour configurer l’intégration et remplacer les valeurs d’espace réservé par les valeurs de votre projet Commerce Optimizer :

    code language-shell 
    bin/magento aco:config:init --org_id=your-org --tenant_id=your-tenant --client_id=your-client-id --client_secret=your-secret

  4. Vérifiez la connexion en revenant à l’administration Commerce et en sélectionnant l’option Adobe Commerce Optimizer .

    Lorsque vous sélectionnez l’option , elle ouvre l’interface utilisateur de Commerce Optimizer dans un nouvel onglet.

Vérifier que la synchronisation des données fonctionne verify-that-the-data-sync-is-working

Vérifiez que les données ont bien été exportées à partir de l’administration Commerce et que les données ont bien été diffusées à Commerce Optimizer. Démarrez avec l’export dans l’administration Commerce, puis confirmez la diffusion en Commerce Optimizer.

  1. Vérification du statut de synchronisation dans l’administration Commerce :

    Accédez à System > Data Transfer > Data Feed Sync Status.

    Page État de synchronisation des flux de données avec rapport sur l’état des éléments de flux {width="700" modal="regular"}

    Lorsque la synchronisation est en cours, les données de flux affichent les enregistrements envoyés avec succès. Sélectionnez un flux pour afficher les détails ou résoudre les problèmes de synchronisation.

  2. Confirmer que les données ont été diffusées à Commerce Optimizer:

    Dans le menu Commerce Optimizer, sélectionnez Data Sync.

    Page de synchronisation des données dans Adobe Commerce Optimizer affichant les données de catalogue synchronisées {width="700" modal="regular"}

    Vérifiez que les produits, prix et attributs attendus s’affichent.

Lorsque la synchronisation fonctionne comme prévu :

  • Data Feed Sync Status affiche les enregistrements envoyés avec succès pour les flux du connecteur, sans erreurs au niveau de l’élément non résolues.
  • Data Sync dans Commerce Optimizer répertorie les sources de catalogue, les produits, les prix et les attributs attendus.
TIP
Si vous rencontrez des problèmes avec la synchronisation des données, consultez le guide Dépannage.

Étapes suivantes

  1. Configurer Commerce Optimizer vues de catalogue et des politiques

    Créez des vues et des politiques de catalogue dans l’interface utilisateur de Commerce Optimizer. Notez que les tarifs sont créés automatiquement à partir de groupes de clients Adobe Commerce. Pour obtenir des instructions détaillées, reportez-vous à la documentation Vues de catalogue et Politiques du Guide de l’utilisateur Commerce Optimizer..

  2. Configuration d’un storefront Commerce surEdge Delivery Services

    Suivez la documentation de configuration de Storefront pour connecter votre storefront à l’instance Commerce Optimizer et commencer à diffuser des expériences commerciales personnalisées.

recommendation-more-help
commerce-help-aco-connector