Commerce Services Connector
Creado para:
- Administrador
- Usuario
Some Adobe Commerce and Magento Open Source features are powered by Commerce Services and deployed as SaaS (software as a service). To use these services, you must connect your Commerce instance using production and sandbox API keys, and specify the data space in the configuration. You only need to configure the connection one time for each instance.
Available services
The following lists the Commerce features you can access through the Commerce Services Connector:
Arquitectura
En un nivel superior, Commerce Services Connector se compone de los siguientes elementos principales:
En las secciones siguientes se analiza cada uno de estos elementos con más detalle.
Credenciales
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.
Generar las claves API de producción y de zona protegida
-
Inicie sesión en su cuenta de Commerce en https://account.magento.com.
-
En la ficha Magento, seleccione Portal de API en la barra lateral.
-
En el menú Entorno, seleccione Producción o Espacio aislado.
NOTE
Production and Sandbox refer to the data space environments where data is stored in Adobe SaaS backend systems. No se refiere a entornos comerciales en los que vaya a utilizar las claves. -
Enter a name in the API Keys section, and click Add New to open the dialog to download the new key.
WARNING
Este cuadro de diálogo proporciona la única oportunidad que tiene para copiar o descargar las claves. -
Haz clic en Descargar y luego en Cancelar.
-
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 o instalaciones asociados con la licencia.
Configuración de SaaS
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.
Si esto sucede, envíe una solicitud de soporte técnico para solicitar la limpieza de datos.
Aprovisionamiento de espacio de datos SaaS
All Adobe Commerce merchants can access one production data space and two testing data spaces per SaaS project.
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 asistencia. 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.
- Envíe una solicitud de soporte técnico para solicitar el espacio de datos de prueba adicional e indicar la justificación comercial del espacio de datos adicional. Esta solicitud está sujeta a aprobación.
Magento Open Source customers using Adobe Payment Services may also request an additional data space. Contact the Payments team for prior approval of the additional data spaces before submitting a Support request to request the testing data space.
Customers who own multiple Cloud projects or on-premises (live/production) installations can also request additional production and testing data spaces for each project or instance by submitting a Support request.
Select or create a SaaS project
To select or create a SaaS project, request the Commerce API key from the Commerce license owner for your store:
-
On the Admin sidebar, go to System > Services > Commerce Services Connector.
If you do not see the Commerce Services Connector section in the Commerce configuration, install the Commerce modules for your desired Commerce service. Also, make sure that the
magento/module-services-id
package is installed. -
In the Sandbox API Keys and Production API Keys sections, paste your key values.
- Private keys must include
----BEGIN PRIVATE KEY---
at the beginning of the key and----END PRIVATE KEY----
at the end of the key. - If you do not have a copy of the actual keys, ask the Account Owner for them, then plug the values into the configuration.
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. - Private keys must include
-
Haga clic en Guardar.
Cualquier proyecto SaaS asociado con sus claves aparecerá en el campo Proyecto de la sección Identificador SaaS.
- Si no existen proyectos SaaS, haga clic en Crear proyecto. A continuación, en el campo Proyecto, escriba un nombre para su proyecto SaaS.
- Seleccione el espacio de datos que se usará para la configuración actual de su almacén de Commerce.
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)
Para conectar la instancia de Adobe Commerce a 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.