Commerce Services Connector

Algunas características de Adobe Commerce y Magento Open Source utilizan Commerce Services y se implementan como SaaS (software como servicio). Para utilizar estos servicios, debe conectar su instancia de Commerce mediante las claves de API de producción y de zona protegida, y especificar el espacio de datos en la configuración. Solo es necesario configurar la conexión una vez para cada instancia.

Servicios disponibles availableservices

A continuación se enumeran las características de Commerce a las que puede tener acceso a través de Commerce Services Connector:

Servicio
Disponibilidad
Product Recommendations con tecnología de Adobe Sensei
Adobe Commerce
Live Search con tecnología de Adobe Sensei
Adobe Commerce
Payment Services
ADOBE COMMERCE y MAGENTO OPEN SOURCE
Site-Wide Analysis Tool
Adobe Commerce
Catalog Service
Adobe Commerce
Data Connection
Adobe Commerce

Arquitectura

En un nivel superior, Commerce Services Connector se compone de los siguientes elementos principales:

Arquitectura del conector de servicios de Commerce

En las secciones siguientes se analiza cada uno de estos elementos con más detalle.

Credenciales apikey

Las claves API de producción y de zona protegida se generan a partir de la cuenta Commerce del propietario de la licencia. La cuenta de Commerce está identificada por un ID único de Commerce (MageID). El propietario de la licencia de la organización del comerciante puede generar claves de API para servicios como Product Recommendations o Live Search, siempre y cuando la cuenta esté al día.

Las claves se pueden compartir según sea necesario con el integrador de sistemas o el equipo de desarrollo que gestiona los proyectos y entornos en nombre del titular de la licencia. Los desarrolladores a los que el propietario de la licencia ha concedido Shared Access no pueden generar las claves en su nombre aunque la organización del comerciante esté presente en el menú desplegable Switch Accounts de su cuenta.

Además, los integradores de soluciones también tienen derecho a utilizar Commerce Services. Si usted es un integrador de soluciones, el firmante del contrato del socio Commerce debe generar las claves de API.

NOTE
Los identificadores de clave Production y Sandbox no hacen referencia a su entorno. Utilice el mismo conjunto de claves API para para cada uno de los entornos, por ejemplo, los entornos local, de desarrollo, de ensayo o de producción.
El propietario de la licencia suele ser el contacto principal de la cuenta de Adobe Commerce y no siempre es el mismo que el propietario del proyecto de Adobe Commerce en el proyecto de infraestructura en la nube.

Generar las claves API de producción y de zona protegida genapikey

  1. Inicie sesión en su cuenta de Commerce en https://account.magento.com.

  2. En la ficha Magento, seleccione Portal de API en la barra lateral.

  3. En el menú Entorno, seleccione Producción o Espacio aislado.

  4. Escriba un nombre en la sección Claves de API y haga clic en Agregar nueva para abrir el cuadro de diálogo y descargar la clave nueva.

    Descargar clave privada

    note warning
    WARNING
    Este cuadro de diálogo proporciona la única oportunidad que tiene para copiar o descargar las claves.
  5. Haz clic en Descargar y luego en Cancelar.

  6. Repita los pasos anteriores para cada entorno (producción y zona protegida).

    La sección Claves de API ahora muestra sus claves de API (públicas). Necesita las cuatro claves (tanto la de producción como la de zona protegida, Pública+Privada) al seleccionar o crear un proyecto SaaS en cualquiera de los entornos/instalaciones asociados con la licencia.

Configuración de SaaS saasenv

Las instancias de Commerce deben configurarse con un proyecto SaaS y un espacio de datos SaaS para que Commerce Services pueda enviar datos a la ubicación correcta. Un proyecto SaaS agrupa todos los espacios de datos SaaS. Los espacios de datos SaaS se utilizan para recopilar y almacenar datos que permiten que Commerce Services funcione. Algunos de estos datos pueden exportarse desde la instancia Commerce y otros pueden recopilarse a partir del comportamiento del comprador en la tienda. Estos datos se conservan para proteger el almacenamiento en la nube.

Para Product Recommendations, el espacio de datos de SaaS contiene datos de catálogo y de comportamiento. Puede apuntar una instancia de Commerce a un espacio de datos SaaS seleccionándola en la configuración de Commerce.

WARNING
Use su espacio de datos SaaS de producción solo en su instalación de producción Commerce para evitar conflictos de datos. De lo contrario, se corre el riesgo de contaminar los datos del sitio de producción con datos de prueba, lo que provoca retrasos en la implementación. Por ejemplo, los datos del producto de producción se podrían sobrescribir por error a partir de los datos de ensayo, como las direcciones URL de ensayo.
Si esto sucede, envíe una solicitud de soporte técnico para solicitar la limpieza de datos.

Aprovisionamiento de espacio de datos SaaS

Todos los comerciantes de Adobe Commerce pueden acceder a un espacio de datos de producción y a dos espacios de datos de prueba por proyecto de SaaS.

Puede utilizar los espacios de datos de prueba en cualquier entorno que no sea de producción, siempre que no utilice el mismo espacio de datos en varios entornos al mismo tiempo. Para utilizar el espacio de datos de prueba en un entorno diferente, realice una limpieza de datos antes de seleccionar y configurar el espacio de datos en ese entorno.

Para los proyectos de Adobe Commerce Cloud Pro con varios entornos de ensayo, puede solicitar espacios de datos de prueba adicionales para cada entorno de ensayo enviando una solicitud de soporte técnico. Sin embargo, si solo tiene un entorno de ensayo y necesita espacios de datos de prueba adicionales, tiene las siguientes opciones:

  • Póngase en contacto con el equipo de éxito del cliente o con el administrador de éxito del cliente designado para solicitar un entorno de ensayo adicional. Hay un costo adicional involucrado.
  • Envíe una solicitud de soporte técnico para obtener un espacio de datos de prueba adicional e indique la justificación comercial para el espacio de datos adicional. Esta solicitud está sujeta a aprobación.

Seleccionar o crear un proyecto SaaS createsaasenv

Para seleccionar o crear un proyecto SaaS, solicite la clave de API Commerce al propietario de la licencia Commerce de su tienda:

NOTE
Si no ve la sección Commerce Services Connector en la configuración de Commerce, debe instalar los módulos de Commerce para el Commerce servicio deseado.
  1. En la barra lateral Admin, vaya a Sistema > Servicios > Conector de servicios de Commerce.

    Si no ve la sección Commerce Services Connector en la configuración de Commerce, instale los módulos de Commerce para el Commerce servicio que desee. Además, asegúrese de que el paquete magento/module-services-id está instalado.

  2. En las secciones Sandbox API Keys ​y_Production API Keys_, pegue los valores de clave.

    • Las claves privadas deben incluir ----BEGIN PRIVATE KEY--- al principio de la clave y ----END PRIVATE KEY---- al final de la clave.
    • Si no dispone de una copia de las claves reales, solicítelas al propietario de la cuenta y, a continuación, introduzca los valores en la configuración.
    note warning
    WARNING
    Si agrega valores de clave consultando una copia de seguridad o instantánea de base de datos y pegando los valores en la configuración, se aplica una capa adicional de cifrado y las claves no funcionan.
  3. Haga clic en Guardar.

Cualquier proyecto SaaS asociado con sus claves aparecerá en el campo Proyecto de la sección Identificador SaaS.

  1. Si no existen proyectos SaaS, haga clic en Crear proyecto. A continuación, en el campo Proyecto, escriba un nombre para su proyecto SaaS.
NOTE
Para evitar confusiones, no use un servicio Commerce específico como nombre para el proyecto, por ejemplo Live Search, Product Recommendations o Conexión de datos. A menos que la licencia se haya aprovisionado para varios proyectos SaaS, puede utilizar el mismo proyecto SaaS para varios servicios.
  1. Seleccione el espacio de datos que se usará para la configuración actual de su almacén de Commerce.
NOTE
Si tiene instancias independientes para integrar con los servicios de Commerce, envíe un vale de soporte técnico para solicitar un nuevo proyecto de SaaS para cada instancia adicional. Una vez que el equipo de asistencia haya creado el proyecto de SaaS, configure la integración de servicios de Commerce para la instancia de con la misma clave de API y seleccione el nuevo proyecto de SaaS para el espacio de datos.
WARNING
Si genera claves nuevas en la sección del portal de API de Mi cuenta, actualice inmediatamente las claves de API en la configuración de la administración. Si genera claves nuevas y no las actualiza en el Administrador, las extensiones SaaS dejarán de funcionar y perderá datos valiosos.

Para cambiar los nombres de tu proyecto SaaS o espacio de datos, haz clic en Cambiar nombre junto a uno de ellos. Cambiar el nombre no afecta al servicio porque el nombre es sólo una etiqueta para ayudarle a identificar y diferenciar entre proyectos y espacios de datos.

Organización de IMS (opcional) organizationid

Para conectar la instancia de Adobe Commerce al Adobe Experience Platform, inicie sesión en la cuenta de Adobe con el Adobe ID. Después de iniciar sesión, la organización de IMS asociada a su cuenta de Adobe se muestra en esta sección.

Exportación de datos SaaS

Cuando la instancia de Commerce se conecta correctamente a Commerce Services, el proceso de exportación de datos de SaaS exporta los datos de Commerce del servidor Commerce a Commerce SaaS Services para que se puedan sincronizar con los servicios de Commerce conectados. En el Administrador, puede comprobar el estado de sincronización mediante el panel de administración de datos. Para obtener más información, consulte la Guía de exportación de datos SaaS.

recommendation-more-help
3d5a1200-3287-4b90-a075-6c594f65d80e