Configuración de la integración de Experience Cloud con el administrador de Commerce

Empiece a utilizar la integración de Experience Cloud con Commerce Admin configurando la aplicación de Commerce para utilizar las extensiones de Commerce Admin Unified Experience y Commerce Events.

Requisitos previos

  • Adobe Commerce debe estar configurado para usar autenticación IMS de Adobe

  • Aprovisionamiento de cuentas y permisos: los administradores deben tener un perfil comercial de Adobe con acceso a los siguientes recursos para configurar la integración de Experience Cloud:

    • Adobe Admin Console: agregue y administre cuentas de usuario y desarrollador de Adobe para la organización
    • Adobe Developer Console: acceso de desarrollador o administrador del sistema para crear proyectos de App Builder y generar las credenciales de conexión y la configuración de proyecto para usar el servicio Eventos de Adobe I/O
    • Proyecto de Commerce en la nube: instale los módulos necesarios y configure el servidor de aplicaciones de Commerce mediante la CLI de Adobe Commerce
    • Administrador de Commerce: actualice la configuración de la tienda y administre las cuentas de usuario de Commerce

Información general de configuración

Habilite la integración realizando las siguientes tareas:

Compruebe el entorno de Commerce y la configuración de la aplicación

Antes de configurar la integración de Experience Cloud, compruebe que su proyecto y la aplicación de Commerce cumplen los requisitos.

  1. En la estación de trabajo local, cambie al directorio del proyecto para su proyecto de Commerce.

  2. Consulte la rama de entorno para que la instancia se integre con el Experience Cloud.

  3. Compruebe que Adobe IMS está activado.

    • Utilice la URL de acceso SSH para que el entorno se conecte al servidor de aplicaciones de Commerce.

    • Desde la línea de comandos, utilice la CLI de Adobe Commerce para comprobar el estado del módulo IMS.

      code language-bash
      bin/magento admin:adobe-ims:status
      

    Si el módulo no está habilitado, actívelo usando la organización y las credenciales para el proyecto de integración de IMS.

  4. Compruebe que el usuario administrador puede iniciar sesión en el administrador de Commerce con su Adobe ID.

    • Vaya a la URL de administración de Commerce.

    • Si ha iniciado sesión, cierre la sesión.

    • Asegúrese de que se redirige al usuario administrador para que inicie sesión con su Adobe ID.

      Adobe Commerce inició sesión con Adobe ID {width="600" modal="regular"}

  5. En el directorio del proyecto en la nube de la estación de trabajo local, compruebe que la extensión Commerce Admin Unified Experience esté instalada.

    code language-bash
    composer show *unified-experience*
    

    Si la extensión está instalada, Composer devuelve el nombre y la descripción de la extensión.

    code language-none
    magento/module-unified-experience <version> Commerce module responsible for integration with Adobe Experience Cloud
    

    Si la extensión no está instalada, utilice Composer para instalarla. A continuación, confirme los cambios y vuelva a implementar el entorno de la nube.

    code language-none
    composer require magento/module-unified-experience
    composer update
    

Habilitar la experiencia unificada de administración de Commerce

Habilite la extensión Commerce Admin Unified Experience y, a continuación, inicie sesión mediante Experience Cloud.

NOTE
Estas instrucciones muestran cómo un Commerce Cloud de proyectos puede activar la extensión utilizando la CLI de Adobe Commerce. Los usuarios administradores de Commerce también pueden habilitar la extensión actualizando las opciones de configuración de la tienda Commerce.
  1. Desde el directorio raíz del entorno de su proyecto en la nube en su estación de trabajo local, use la herramienta CLI de magento en la nube para iniciar sesión en el servidor de aplicaciones de Commerce.

    code language-bash
    magento-cloud ssh
    
  2. Habilite la extensión magento/module-unified-experience mediante la CLI de Adobe Commerce:

    code language-bash
    bin/magento config:set admin/unified_experience/enabled 1
    Admin Unified Experience integration is enabled
    
  3. Borre la caché.

    code language-bash
    bin/magento cache:clean
    

Configuración de eventos de Adobe I/O para Commerce

Cuando la integración de Experience Cloud está habilitada, el servicio Eventos de Adobe I/O envía datos de evento de Commerce a Experience Cloud para administrar el acceso de administrador a los proyectos de Commerce. La configuración del servicio requiere habilitar los Eventos de Adobe I/O para la extensión de Commerce (magento/commerce-eventing) y configurar el servicio Eventos de Adobe I/O en el Administrador.

Habilitar eventos de Commerce

Habilite la extensión de eventos de Commerce (magento/commerce-eventing) para enviar datos de evento personalizados desde la aplicación de Commerce al servicio de eventos de Adobe I/O.

NOTE
En Commerce 2.4.6 y versiones posteriores, la extensión Eventos de Commerce se instala de forma predeterminada. Para proyectos de Commerce con Commerce 2.4.5, use primero Composer para instalar la extensión y después habilitarla.
  1. Desde el entorno de desarrollo de proyectos de Commerce local, agregue la configuración siguiente al archivo .magento.env.yaml.

    code language-yaml
    stage:
      global:
        ENABLE_EVENTING: true
      deploy:
        CRON_CONSUMERS_RUNNER:
          cron_run: true
          max_messages: 0
          consumers: []
    
  2. Agregue, confirme e implemente el(la) .magento.env.yaml file actualizado(a) en el entorno de nube.

TIP
Para obtener más información sobre la configuración y administración de variables de entorno mediante el archivo .magento.env.yaml, vea Configurar variables de entorno para la implementación.

Configuración de la integración de eventos de Commerce

Configure la integración de eventos de Commerce realizando las siguientes tareas. Para obtener instrucciones detalladas, consulte Eventos de Adobe I/O para desarrolladores de Commerce.

  1. Cree un proyecto App Builder para recibir datos de evento de la instancia Commerce.

    Necesita credenciales y datos de configuración del proyecto de App Builder para configurar la integración en el administrador de Commerce.

  2. Configure Adobe Commerce para que utilice eventos de Adobe I/O.

  3. Actualice el proyecto de App Builder para recibir datos de evento de la instancia de Commerce.

    No registrar ni suscribirse a eventos desde la instancia de Commerce. El registro de eventos se inserta en el proyecto App Builder al configurar el proveedor de eventos para la aplicación Commerce.

    Después de conectar el proveedor de eventos al proyecto de App Builder, suscríbase al evento observer.uex_commerce_instance_update y guarde los cambios.

  4. Para establecer la conexión, envíe un evento al consumidor a través del proveedor de eventos.

    • Desde la línea de comandos del directorio local del proyecto en la nube, use SSH para conectarse al servidor de aplicaciones de Commerce.

      code language-bash
      magento-cloud ssh
      
    • Envíe datos de evento comprobando el estado de la extensión de experiencia unificada del administrador mediante la CLI de Adobe Commerce.

      code language-bash
      bin/magento bin/magento admin:uex:status
      

Prueba de la integración

Compruebe que un administrador de Commerce puede iniciar sesión en Experience Cloud para ver los proyectos de Commerce disponibles y acceder a los administradores y a Storefront de cada proyecto.

  1. Inicie sesión en el Experience Cloud mediante el Adobe ID y la organización asociados con la instancia de Commerce.

    Acceder a proyectos de Commerce desde la página de inicio del Experience Cloud {width="600" modal="regular"}

  2. Ver los proyectos de Commerce disponibles seleccionando Commerce.

    Espacio de trabajo de proyectos de Commerce para Experience Cloud {width="600" modal="regular"}

  3. Abra el Administrador de una instancia seleccionando Open.

    Vista de administrador de Commerce con la integración de Experience Cloud habilitada {width="600" modal="regular"}

  4. Compruebe que puede realizar las tareas de administración según lo esperado.

    Los flujos de trabajo en el administrador de Commerce deben seguir el mismo proceso. Si experimenta cambios o errores en el flujo de trabajo después de habilitar la integración de Experience Cloud, póngase en contacto con el administrador del sistema de Commerce o envíe un ticket de asistencia de Adobe.

Después de configurar la integración de Experience Cloud, compruebe que las cuentas de administrador estén aprovisionadas correctamente para acceder a los proyectos de Commerce a través de Experience Cloud. Consulte Administrar usuarios administradores.

recommendation-more-help
31746fd0-1ead-45b5-9192-1aaf582c5f66