DocumentaciónCommerceOptimizer Connector

[Solo PaaS]{class="badge informative" title="Se aplica solo a proyectos de Adobe Commerce en la nube (infraestructura PaaS administrada por Adobe) y a proyectos locales."}

Introducción

Última actualización: 1 de junio de 2026

Creado para:

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

Instala y configura Adobe Commerce Optimizer Connector para que sincronice los datos del catálogo Adobe Commerce con Adobe Commerce Optimizer y, a continuación, supervisa el estado de sincronización de datos para asegurarte de que la tienda esté actualizada.

IMPORTANT
Conecte siempre las instancias de sandbox Optimizer a entornos que no sean de producción y las instancias de producción a entornos de producción. Los entornos no coincidentes producen incoherencias en los datos del catálogo, los resultados de búsqueda y las recomendaciones.

Requisitos para utilizar la integración requirements-to-use-the-integration

El usuario Adobe Commerce que configuró la integración debe tener:

Eliminar extensiones en conflicto remove-conflicting-extensions

Si tiene instaladas cualquiera de las siguientes extensiones, desinstálelas antes de instalar 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)

Los datos asociados con estas extensiones siguen estando disponibles en la base de datos de Commerce. Sin embargo, no se exporta a Commerce Optimizer cuando el conector está habilitado. Para implementar las funcionalidades de búsqueda y comercialización proporcionadas por estas extensiones después de habilitar el conector, configúrelas desde la Commerce Optimizer IU de administración.

IMPORTANT
Si estas extensiones no se quitan antes de habilitar el conector, es posible que vea pantallas de configuración rotas, datos duplicados en Commerce Optimizer porque los mismos datos se exportan desde el conector y las extensiones existentes, y errores 401 o 403 en los registros debido a conflictos en la forma en que las extensiones y el conector se autentican con los servicios conectados.
style
shade-box

Pasos de configuración configuration-steps

Siga estos pasos para habilitar Adobe Commerce Optimizer Connector y comenzar a sincronizar datos de Adobe Commerce con su instancia de Commerce Optimizer.

  1. Instale el Adobe Commerce Optimizer Connector paquete mediante Compositor para conectar su instancia de Adobe Commerce a Commerce Optimizer.

  2. Personalizar la configuración de exportación de los ámbitos de Commerce desde el administrador.

  3. Habilitar la Commerce Optimizer integración.

  4. Compruebe que la sincronización de datos funciona.

Instalar el paquete Adobe Commerce Optimizer Connector install-the-adobe-commerce-optimizer-connector-package

Adobe Commerce Optimizer Connector se entrega como un metapaquete de Compositor disponible para todos los comerciantes de Commerce con una licencia activa para Commerce Optimizer.

Pasos de instalación

  1. Agregar el módulo adobe-commerce/commerce-data-export-aco-adapter mediante Composer:

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

  2. Implementar los cambios en el entorno de ensayo Adobe Commerce.

    Una vez finalizada la implementación, la opción Commerce Optimizer está disponible en el menú Administrador de Commerce. Seleccione Commerce Optimizer para abrir su instancia de Commerce Optimizer directamente desde el administrador de Commerce.

NOTE
Para obtener instrucciones detalladas sobre la instalación de extensiones, consulte las siguientes guías:
Instalar extensión en Adobe Commerce en la infraestructura de nube
Instalar extensión en Adobe Commerce local

Personalizar la configuración de exportación de los ámbitos de Commerce customize-the-commerce-scopes-export-configuration

De forma predeterminada, la sincronización de datos del catálogo está habilitada para todos los ámbitos de Commerce (sitios web, grupos de clientes y vistas de tiendas). Puede personalizar la configuración de exportación para sincronizar datos solo para ámbitos específicos según sus necesidades empresariales. Por ejemplo, si tiene varias vistas de tienda que comparten el mismo idioma, puede optar por exportar los datos solo para una de las vistas de tienda y utilizarlos como el origen de catálogo para varias vistas de catálogo en Commerce Optimizer.

IMPORTANT
El cambio de la configuración de exportación déclencheur una reindexación completa, que puede tardar un tiempo considerable en función del tamaño del catálogo. Adobe recomienda configurar los ámbitos de Commerce para que se sincronicen con Commerce Optimizer antes de habilitar la integración e iniciar la sincronización de datos inicial.

En la tabla siguiente se describen los datos que se exportan en cada nivel de ámbito:

Ámbito
Datos exportados
Notas
Sitio web y grupo de clientes
Precios y libros de precios
Cada conjunto de precios se exporta como un libro de precios utilizando la convención de nomenclatura <website>::<SHA1 of customer group ID>. Se incluyen todos los grupos de clientes del sitio web.
Vista de tienda
Productos y atributos del producto
Cada vista de tienda crea un origen de catálogo independiente en Commerce Optimizer.

Almacenar cuadrícula con configuración de sincronización de Commerce Optimizer {width="600" modal="regular"}

Para cambiar la configuración de exportación del ámbito

  1. En el Administrador de Commerce, vaya a Stores > Settings > All Stores.

  2. Seleccione el sitio web o la vista de tienda que desee configurar.

  3. En la configuración del exportador Commerce Optimizer, utilice la casilla de verificación para habilitar o deshabilitar la sincronización de datos según sea necesario.

    Actualizar configuración de sincronización de datos {width="500" modal="regular"}

  4. Guarde los cambios.

Habilitar y deshabilitar el comportamiento

Acción
Resultado
Deshabilitar una vista de tienda
Al deshabilitar la sincronización, se quitan los datos del catálogo de la tienda. El origen del catálogo permanece en Commerce Optimizer, pero todos los datos sincronizados se eliminan en la siguiente ejecución de cron.
Deshabilitar y volver a habilitar una vista de tienda
El mismo origen de catálogo se vuelve a rellenar con una resincronización de datos completa.

Habilitar la integración Commerce Optimizer enable-the-adobe-commerce-optimizer-integration

Habilite la integración e inicie la sincronización de datos ejecutando el comando CLI aco:config:init. Este comando completa los siguientes pasos:

  1. Obtiene un token de acceso de IMS utilizando las credenciales proporcionadas como argumentos de línea de comandos.
  2. Llama al servicio Commerce Cloud Manager (CCM) en https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId} para validar el inquilino y extraer la URL de ingesta y la URL de estudio Commerce Optimizer.
  3. Guarda toda la configuración (secreto de cliente cifrado) en core_config_data.
  4. Programa la sincronización completa inicial invalidando todos los indizadores de fuentes Commerce Optimizer.
IMPORTANT
El procesamiento de la sincronización de datos se inicia en segundo plano en cuanto se completa la configuración. Según el tamaño del catálogo, el proceso de sincronización de datos puede tardar entre unos minutos y varias horas.

Obtener los detalles de conexión necesarios

Desde Adobe Developer Console, cree un nuevo proyecto habilitado para el servicio de ingesta Commerce Optimizer y genere las credenciales de servidor a servidor de OAuth. Para obtener instrucciones detalladas, consulte Obtener credenciales de IMS en la Guía para desarrolladores de comercialización.

Guarde los siguientes valores desde la página de credenciales:

  • ID. de organización (org_id)
  • ID de cliente (client_id)
  • Secreto de cliente (client_secret)

Obtener detalles de credenciales de la página del proyecto Adobe Developer Console {width="500" modal="regular"}

Obtener detalles de instancia de Commerce Optimizer

Obtenga el id. de inquilino del campo Instance Id​en la instancia Commerce Optimizer Instance details página, o de la URL utilizada para acceder a la instancia. Por ejemplo, en https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home.

  1. En el Administrador de Commerce, seleccione Adobe Commerce Optimizer para mostrar la página de configuración con instrucciones.

    Commerce Optimizer página de configuración {width="500" modal="regular"}

  2. Desde la línea de comandos, use SSH para conectarse al entorno de ensayo Adobe Commerce.

  3. Ejecute el siguiente comando CLI Adobe Commerce para configurar la integración y reemplace los valores de marcador de posición por los valores de su proyecto 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. Compruebe la conexión volviendo al administrador de Commerce y seleccionando la opción Adobe Commerce Optimizer.

    Al seleccionar la opción, se abre la interfaz de usuario de Commerce Optimizer en una nueva pestaña.

Compruebe que la sincronización de datos funciona verify-that-the-data-sync-is-working

Confirme que los datos exportados correctamente desde el administrador de Commerce y que los datos se entregaron correctamente a Commerce Optimizer. Comience con la exportación en el administrador de Commerce y confirme la entrega en Commerce Optimizer.

  1. Comprobar el estado de sincronización en el administrador de Commerce:

    Vaya a System > Data Transfer > Data Feed Sync Status.

    Página de estado de sincronización de fuente de datos con informes de estado de elemento de fuente {width="700" modal="regular"}

    Cuando se está ejecutando la sincronización, los datos de la fuente muestran los registros enviados correctamente. Seleccione una fuente para ver los detalles o solucionar problemas de sincronización.

  2. Confirmar datos entregados a Commerce Optimizer:

    En el menú Commerce Optimizer, seleccione Data Sync.

    Página de sincronización de datos en Adobe Commerce Optimizer que muestra datos de catálogo sincronizados {width="700" modal="regular"}

    Compruebe que aparecen los productos, precios y atributos esperados.

Cuando la sincronización funciona según lo esperado:

  • Data Feed Sync Status muestra los registros enviados correctamente para las fuentes de conectores, sin errores de nivel de elemento sin resolver.
  • Data Sync en Commerce Optimizer enumera los orígenes de catálogo, los productos, los precios y los atributos esperados.
TIP
Si tiene algún problema con la sincronización de datos, consulte la guía Solución de problemas.

Pasos siguientes

  1. Configurar Commerce Optimizer vistas de catálogo y directivas

    Crear vistas de catálogo y directivas en la interfaz de usuario de Commerce Optimizer. Tenga en cuenta que los libros de precios se crean automáticamente a partir de Adobe Commerce grupos de clientes. Para obtener instrucciones, consulte la documentación de Vistas de catálogo y Directivas en la Guía del usuario de Commerce Optimizer.

  2. Configurar una tienda Commerce enEdge Delivery Services

    Siga la documentación de configuración de tienda para conectar su tienda a la instancia Commerce Optimizer y comenzar a ofrecer experiencias de comercio personalizadas.

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