Conexión de datos de Commerce a Adobe Experience Platform
Al instalar la extensión Data Connection, aparecen dos nuevas páginas de configuración en el menú Sistema en Servicios en Commerce Admin.
- Commerce Services Connector
- Data Connection
Para conectar la instancia de Adobe Commerce a Adobe Experience Platform, debe configurar ambos conectores, empezando por el conector de Commerce Services y terminando con la extensión Data Connection.
Configuración del conector de Servicios de Commerce
Si ya ha instalado un servicio de Adobe Commerce, probablemente ya haya configurado el conector de servicios de Commerce. Si no es así, debe completar las tareas siguientes en la página Conector de servicios de Commerce:
- Inicie sesión en su cuenta de Commerce para recuperar las claves de API de producción y de zona protegida.
- Seleccione un espacio de datos SaaS.
- Inicie sesión en su cuenta de Adobe para recuperar su ID de organización.
Después de configurar el conector de Commerce Services, configure la extensión Data Connection.
Configurar la extensión Data Connection
En esta sección, aprenderá a configurar la extensión Data Connection.
Agregar detalles de cuenta de servicio y credenciales
Si planea recopilar y enviar datos históricos de pedidos o datos de perfil del cliente, debe agregar detalles de cuenta de servicio y credenciales. Además, si está configurando la extensión Audience Activation, debe completar estos pasos.
Si solo está recopilando y enviando datos de tienda u oficina, puede saltar a la sección general.
Paso 1: Crear un proyecto en Adobe Developer Console
Cree un proyecto en Adobe Developer Console que autentique Commerce para que pueda realizar llamadas a la API del Experience Platform.
Para crear el proyecto, siga los pasos descritos en el tutorial Autenticar y obtener acceso a las API de Experience Platform.
A medida que avance en el tutorial, asegúrese de que su proyecto tenga lo siguiente:
- Acceso a los siguientes perfiles de producto: Acceso predeterminado para todo tipo de producción y Acceso predeterminado para todo de AEP.
- Se han configurado funciones y permisos correctos.
- Si ha decidido utilizar JSON Web Tokens (JWT) como método de autenticación de servidor a servidor, también debe cargar una clave privada.
El resultado de este paso crea un archivo de configuración que se utiliza en el siguiente paso.
Paso 2: Descargar archivo de configuración
Descargar el archivo de configuración del área de trabajo. Copie y pegue el contenido de este archivo en la página Detalles de cuenta de servicio/credencial del administrador de Commerce.
-
En el Administrador de Commerce, vaya a Tiendas > Configuración > Configuración > Servicios > Data Connection.
-
Seleccione el método de autorización de servidor a servidor que implementó desde el menú Tipo de autorización de Adobe Developer. Adobe recomienda utilizar OAuth. JWT se ha desaprobado. Más información.
-
(Solo JWT) Copie y pegue el contenido del archivo
private.key
en el campo Secreto del cliente. Utilice el siguiente comando para copiar el contenido.code language-bash cat config/private.key | pbcopy
Consulte Autenticación de cuenta de servicio (JWT) para obtener más información sobre el archivo
private.key
. -
Copie el contenido del archivo
<workspace-name>.json
en el campo Detalles de cuenta de servicio/credencial. -
Haga clic en Guardar configuración.
General
-
En el Administrador, vaya a Sistema > Servicios > Data Connection.
-
En la ficha Configuración en General, compruebe el identificador asociado a su cuenta de Adobe Experience Platform, según la configuración de Commerce Services Connector. El ID de organización es global. Solo se puede asociar un ID de organización por cada instancia de Adobe Commerce.
-
En el menú desplegable Ámbito, establezca el contexto en Sitio web.
-
(Opcional) Si ya tiene un SDK web de AEP (alloy) implementado en su sitio, habilite la casilla de verificación y agregue el nombre de su SDK web de AEP. De lo contrario, deje estos campos en blanco y la extensión Data Connection implementará uno por usted.
note note NOTE Si especifica su propio SDK web de AEP, la extensión Data Connection utilizará el ID de conjunto de datos asociado a dicho SDK y no el ID de conjunto de datos especificado en esta página (si corresponde).
Recopilación de datos
En esta sección, especifique el tipo de datos que desea recopilar y enviar al perímetro del Experience Platform. Existen tres tipos de datos:
-
Funcionamiento (datos del lado del cliente) son datos capturados en la tienda. Esto incluye información sobre las interacciones del comprador, como
View Page
,View Product
,Add to Cart
y lista de solicitudes (para comerciantes B2B). -
Back office (datos del lado del servidor) son datos capturados en los servidores de Commerce. Esto incluye información sobre el estado de un pedido, como si se ha realizado, cancelado, reembolsado, enviado o completado. También incluye datos históricos de pedidos.
-
Perfil (Beta) son datos relacionados con la información de perfil del comprador. Más información más.
Para asegurarse de que la instancia de Adobe Commerce pueda iniciar la recopilación de datos, revise los requisitos previos.
Consulte el tema de eventos para obtener más información sobre los eventos de tienda, back office y perfil.
-
Seleccione Eventos de tienda si quiere enviar datos de comportamiento de tienda.
-
Seleccione Eventos de gestiones internas si desea enviar información sobre el estado del pedido, por ejemplo, si se realizó, canceló, reembolsó o envió un pedido.
note note NOTE Si selecciona Eventos de back office, todos los datos de back office se enviarán al perímetro del Experience Platform. Si un comprador decide excluirse de la recopilación de datos, debe establecer explícitamente la preferencia de privacidad del comprador en el Experience Platform. Esto es diferente a los eventos de tienda en los que el coleccionista ya gestiona el consentimiento en función de las preferencias del comprador. Obtenga más información sobre cómo establecer las preferencias de privacidad de un comprador en el Experience Platform. -
(Omita este paso si utiliza su propio SDK web de AEP). Cree un conjunto de datos en Adobe Experience Platform o seleccione un conjunto de datos existente que desee usar para la recopilación. Escriba el id. de secuencia de datos en el campo id. de secuencia de datos.
-
Escriba el ID del conjunto de datos que desea que contenga sus datos de Commerce. Para encontrar la ID del conjunto de datos:
- Abra la interfaz de usuario del Experience Platform y seleccione Conjuntos de datos en el panel de navegación izquierdo para abrir el panel Conjuntos de datos. El panel enumera todos los conjuntos de datos disponibles para su organización. Se muestran los detalles de cada conjunto de datos enumerado, incluido su nombre, el esquema al que se adhiere y el estado de la ejecución de la ingesta más reciente.
- Abra el conjunto de datos asociado al conjunto de datos.
- En el panel derecho, vea los detalles sobre el conjunto de datos. Copie el ID del conjunto de datos.
-
Para garantizar que las actualizaciones de datos de eventos de back office se basen en una programación según un trabajo de cron, debe cambiar el índice de
Sales Orders Feed
aUpdate by Schedule
.-
En la barra lateral Admin, vaya a System > Tools>Index Management.
-
Seleccione la casilla de verificación del indizador
Sales Orders Feed
. -
Establezca Actions en
Update by Schedule
. -
Si está habilitando los datos del back office por primera vez, ejecute los siguientes comandos para reindexar y almacenar en déclencheur una resincronización. Las resincronizaciones posteriores se producen automáticamente siempre y cuando el trabajo de cron esté configurado correctamente.
code language-bash bin/magento index:reindex sales_order_data_exporter_v2
code language-bash bin/magento saas:resync --feed orders
-
Descripciones de campos
Después de la incorporación, los datos de la tienda comienzan a fluir al perímetro del Experience Platform. Los datos del back office tardan unos cinco minutos en aparecer en el perímetro. Las actualizaciones posteriores son visibles en el perímetro en función de la programación de cron.
Envío de datos de perfil de cliente
Existen dos tipos de datos de perfil que puede enviar al Experience Platform: registros de perfil y eventos de perfil de series temporales.
Un registro de perfil contiene datos que se guardan cuando un comprador crea un perfil en su instancia de Commerce, como el nombre del comprador. Cuando el esquema y el conjunto de datos están correctamente configurados, se envía un registro de perfil al Experience Platform y se reenvía al servicio de segmentación y administración de perfiles de Adobe: Real-Time CDP.
Los eventos de perfil de series temporales contienen datos sobre la información de perfil del comprador; por ejemplo, si crean, editan o eliminan una cuenta del sitio. Cuando los datos de evento de perfil se envían al Experience Platform, residen en un conjunto de datos donde otros productos DX pueden utilizarlos.
-
Asegúrese de que ha proporcionado detalles de cuenta de servicio y credenciales.
-
Asegúrese de que ha especificado un esquema y un conjunto de datos para ingesta de datos de registro de perfil y ingesta de datos de evento de perfil de serie temporal.
-
Active la casilla de verificación Perfiles de cliente si desea enviar datos de perfil al Experience Platform.
-
Escriba el ID del conjunto de datos del perfil.
Los datos del registro de perfil deben utilizar un conjunto de datos diferente al que utiliza actualmente para los datos de evento de comportamiento y de back office.
-
Si no desea transmitir eventos de perfil a través del mismo ID de flujo de datos que esté usando para los datos de comportamiento y de back office, quite la marca de verificación de los perfiles de clientes de Stream a través del mismo ID de flujo de datos e introduzca el ID de flujo de datos que desee usar en su lugar.
Un registro de perfil puede tardar unos 10 minutos en estar disponible en Real-Time CDP. Los eventos de perfil comienzan a transmitirse inmediatamente.
Descripciones de campos
Enviar datos de pedidos históricos
Adobe Commerce recopila hasta cinco años de datos y estado de pedidos históricos. Puede utilizar la extensión Data Connection para enviar esos datos históricos al Experience Platform a fin de enriquecer los perfiles de clientes y personalizar las experiencias de los clientes en función de esos pedidos anteriores. Los datos se almacenan en un conjunto de datos dentro de Experience Platform.
Aunque Commerce ya recopila los datos del pedido histórico, debe completar varios pasos para enviarlos a Experience Platform.
Vea este vídeo para obtener más información sobre los pedidos históricos y, a continuación, complete los siguientes pasos para implementar la recopilación de pedidos históricos.
Configuración del servicio de sincronización de pedidos
El servicio de sincronización de pedidos usa Message Queue Framework y RabbitMQ. Después de completar estos pasos, los datos de estado de los pedidos se pueden sincronizar con SaaS, que es necesario antes de enviarlos al Experience Platform.
-
Asegúrese de que ha proporcionado detalles de cuenta de servicio y credenciales.
-
Habilitar RabbitMQ.
note note NOTE RabbitMQ ya está configurado para las versiones 2.4.7 y posteriores de Commerce, pero debe habilitar a los consumidores. -
Habilitar consumidores de cola de mensajes mediante el trabajo cron en
.magento.env.yaml
mediante la variable de entornoCRON_CONSUMERS_RUNNER
.code language-yaml stage: deploy: CRON_CONSUMERS_RUNNER: cron_run: true
note note NOTE Consulte la documentación de variables de implementación para obtener más información sobre todas las opciones de configuración disponibles.
Con el servicio de sincronización de pedidos habilitado, puede especificar el intervalo de fechas de pedidos históricos en la página Data Connection.
Especificar intervalo de fechas del historial de pedidos
Especifique el intervalo de fechas para los pedidos históricos que desea enviar al Experience Platform.
-
En el Administrador, vaya a Sistema > Servicios > Data Connection.
-
Seleccione la ficha Historial de pedidos.
-
En Sincronización del historial de pedidos, la casilla de verificación Copiar ID del conjunto de datos de la configuración ya está habilitada. Esto garantiza que esté usando el mismo conjunto de datos especificado en la ficha Configuración.
-
En los campos Desde y Hasta, especifique el intervalo de fechas para los datos de pedidos históricos que desea enviar. No puede seleccionar un intervalo de fecha que exceda de cinco años.
-
Seleccione Start Sync para almacenar en déclencheur el inicio de la sincronización. Los datos históricos de pedidos son datos por lotes, a diferencia de los datos de la tienda y el back office que transmiten los datos. Los datos por lotes tardan unos 45 minutos en llegar a Experience Platform.
Descripciones de campos
Confirmar que se recopilan los datos del evento
Para confirmar que se están recopilando datos de tu tienda Commerce, usa Adobe Experience Platform Debugger para examinar tu sitio Commerce. Después de confirmar que se están recopilando los datos, puede comprobar que los datos de evento de la tienda y del back office aparecen en el perímetro ejecutando una consulta que devuelva datos del conjunto de datos que creó.
-
Seleccione Consultas en la navegación izquierda del Experience Platform y haga clic en Create Query.
-
Cuando se abra el Editor de consultas, escriba una consulta que seleccione datos del conjunto de datos.
Por ejemplo, la consulta podría tener el aspecto siguiente:
code language-sql SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
-
Una vez ejecutada la consulta, los resultados se muestran en la ficha Resultados, junto a la ficha Consola. Esta vista muestra el resultado tabular de la consulta.
En este ejemplo, verá datos de evento de commerce.productListAdds
, commerce.productViews
, web.webpagedetails.pageViews
, etc. Esta vista le permite comprobar que los datos de Commerce llegaron al perímetro de.
Si los resultados no son los esperados, abra el conjunto de datos y busque las importaciones de lotes fallidas. Obtenga más información sobre solución de problemas con las importaciones por lotes.
Verificar que los datos de perfil aparezcan en el Experience Platform
Si no ve datos de perfil en el Experience Platform, consulte la Base de conocimiento de Commerce para obtener sugerencias sobre solución de problemas.
Pasos siguientes
Cuando los datos de Commerce se envían al perímetro del Experience Platform, otros productos de Adobe Experience Cloud, como Adobe Journey Optimizer, pueden utilizar esos datos. Por ejemplo, puede configurar Journey Optimizer para que escuche ciertos eventos y, en función de esos datos de evento, almacenar en déclencheur un correo electrónico para un usuario primerizo o si hay un carro de compras abandonado. Aprenda a ampliar su plataforma de Commerce creando recorridos de cliente en Journey Optimizer.