Activación y configuración de eventos de catálogo con Adobe I/O
Los eventos de catálogo son notificaciones generadas por el equipo que describen los cambios de catálogo admitidos disponibles mediante Catalog Service. Permiten flujos de trabajo impulsados por eventos como:
- Mantener las cachés o los servicios externos sincronizados con las actualizaciones del catálogo.
- Activar procesos descendentes cuando cambian productos, variantes, precios o categorías.
- Encendido de Experience Edge y Edge Delivery Services casos de uso que requieren actualizaciones de catálogo casi en tiempo real.
Para ver la ruta de extremo a extremo de Adobe Commerce a los consumidores de eventos, consulte Envío de eventos mediante Adobe I/O Events.
Tipos de eventos admitidos supported-event-types
Los eventos de catálogo se centran en cambios relevantes para la tienda expuestos a través de Adobe Developer Console. Actualmente se admiten las siguientes suscripciones.
Cada evento incluye:
- Identificador de evento que describe el tipo de cambio.
- Contexto de entidad y entorno, como ID de instancia y SKU.
- Una carga útil que describe la entidad modificada y la información de ámbito relevante.
Ejemplo de cargas útiles de eventos
Evento ProductUpdated
{
"imsOrgId": "aaa-0",
"instanceId": "instance-9",
"eventCode": "productUpdated",
"sku": "1234",
"links": [
{"type": "variantOf", "sku": "5678"}
],
"scope": [
{ "storeViewCode": "US-us" },
{ "storeViewCode": "FR-fr" },
{ "storeViewCode": "DE-de" }
]
}
Evento PriceUpdated
{
"imsOrgId": "aaa-0",
"instanceId": "instance-9",
"eventCode": "priceUpdated",
"sku": "1234",
"scope": [
{
"websiteCode": "website1",
"customerGroupCode": "customer-group-code1"
},
{
"websiteCode": "website2",
"customerGroupCode": "customer-group-code2"
}
]
}
Envío de evento mediante Adobe I/O Events event-delivery-through-adobe-io-events
Adobe I/O Events entrega eventos de catálogo a sus integraciones. El diagrama siguiente muestra el flujo de alto nivel de los cambios de catálogo de Adobe Commerce a Catalog Service y Adobe I/O Events para los consumidores suscritos:
Los siguientes pasos explican cada entrega con más detalle:
- Servicio de catálogo → Adobe Commerce
Adobe Commerce exporta datos de catálogo a Catalog Service mediante las extensiones de exportación de datos SaaS admitidas.
-
Procesamiento del servicio de catálogo
- Catalog Service procesa los cambios de catálogo admitidos y los prepara para la entrega de eventos.
-
Servicio de catálogo → Adobe I/O Events
- Los eventos de catálogo se han publicado en Adobe I/O Events.
- Los consumidores se suscriben mediante Diarios, webhooks, Adobe I/O Runtime, Amazon EventBridge u otros mecanismos de envío admitidos.
Adobe I/O Events proporciona:
- Envío de al menos una vez por suscriptor (es posible realizar eventos duplicados).
- No hay garantías de pedidos entre envíos.
Los consumidores deben gestionar eventos duplicados y envíos desordenados. Consulte Idempotencia para obtener instrucciones de implementación.
Casos de uso use-cases
Puede utilizar eventos de catálogo en varios escenarios.
Envío estático de sitios y perímetros
- Regenerar o invalidar páginas de catálogo y fragmentos de tienda cuando cambien los datos del catálogo.
- Evite sondear con frecuencia las API Catalog Service.
Indexación de búsquedas y almacenamiento en caché
- Almacenar en déclencheur actualizaciones incrementales en índices de búsqueda descendentes.
- Actualice las capas de la caché o las vistas externas del catálogo cuando cambien los datos del producto o la categoría.
Integración con sistemas externos
- Reenviar cambios de catálogo a sistemas externos como PIM, motores de precios u otros sistemas de línea de negocios.
- Mantener las aplicaciones descendentes sincronizadas sin acceso directo a la base de datos.
Monitorización y observabilidad
Combine eventos de catálogo con la supervisión existente (por ejemplo, Grafana y Prometheus) para:
- Monitorice el rendimiento del evento.
- Detectar anomalías en el volumen de actualización del catálogo.
Habilitar eventos de catálogo enable-catalog-events
Para habilitar los eventos de catálogo de principio a fin, siga estos pasos.
- Un entorno de Adobe Commerce compatible con Catalog Service habilitado.
- La conexión Adobe I/O está configurada para Adobe Commerce.
- Acceso a Adobe Developer Console en la misma organización de IMS donde se aprovisiona el entorno de Commerce.
- Para comprobar la sincronización con los servicios SaaS de Commerce, use Data Management Dashboard en el Administrador.
- Se requiere Product Recommendations v6.0, Live Search v4.1.0+ o Catalog Service v1.17+ para la verificación del panel. Adobe recomienda actualizar el proyecto de Commerce a las últimas versiones compatibles de estos servicios. Para versiones de servicio anteriores, usa Catalog Sync para la verificación de sincronización.
Verificar datos del catálogo verify-catalog-data
Antes de configurar, compruebe que Catalog Service tenga los datos actuales del catálogo de su instancia Commerce. Los eventos de catálogo dependen de que SaaS Data Export complete dos fases: confirmar ambas:
-
Confirmar la exportación correcta de la fuente desde Commerce.
Desde el administrador de Adobe Commerce, abra la página Estado de sincronización de fuentes de datos (System > Data Transfer > Data Feed Sync Status) y confirme que el último estado de exportación es correcto para cada fuente de Catalog Service.
-
Confirmar la sincronización correcta con los servicios conectados de Commerce del administrador de Adobe Commerce.
Desde el administrador de Adobe Commerce, abra el tablero de administración de datos (System > Data Transfer > Data Management Dashboard) y compruebe que los datos de los productos sincronizados incluyan los productos esperados.
Registrar y suscribirse a Adobe I/O Events register-events
Defina a qué eventos de Commerce suscribirse y, a continuación, regístrelos en el proyecto.
Si la instancia no está en la lista de selección, no está conectada a Adobe I/O. Para obtener instrucciones para solucionar el problema, consulte Configuración de la Adobe I/O conexión en la documentación de Adobe Commerce Developer.
-
Desde Adobe Developer Console, inicie sesión en la misma organización de IMS utilizada para el proyecto de Commerce.
-
Cree un proyecto para eventos de catálogo de Commerce o agregue la API de eventos a un proyecto existente.
-
Seleccione APIs and services en la barra de navegación superior.
-
En la página Browse APIs and services, seleccione la ficha Events.
-
Encuentre rápidamente las API de eventos de catálogo de Commerce. Escriba Catalog en el cuadro de búsqueda o filtre por el producto Commerce.
-
En la tarjeta Commerce Catalog Events, seleccione Project.
-
-
Configure el registro de eventos.
Seleccione la instancia de Commerce desde la que desea recibir notificaciones de eventos. A continuación, seleccione Next.
-
Elija los eventos a los que desee suscribirse.
Seleccione las suscripciones de evento admitidas que desee recibir, como Product Update o Price Update. A continuación, seleccione Next.
-
Agregue las credenciales de servidor a servidor OAuth.
Escriba un Credential name. A continuación, seleccione Next.
-
Escriba Event registration name y Event registration description. A continuación, seleccione Next.
-
En la pantalla de registro final, acepte el consumidor predeterminado, la API de diario.
El consumidor predeterminado de la API de asientos le permite probar el registro de eventos y confirmar que se entregan los eventos. Si ya configuró un webhook o un consumidor de acción Adobe I/O Runtime, selecciónelo aquí. De lo contrario, edite el registro del evento más adelante cuando el consumidor esté listo.
-
Seleccione Complete registration.
Configurar consumidor de eventos configure-consumer
-
Configure un consumidor, como:
- Punto final de un gancho web
- Una acción Adobe I/O Runtime
- Otro destino admitido
-
Si no ha seleccionado ningún consumidor durante el registro, edite el registro del evento para añadir los detalles del consumidor.
-
Desde Adobe Developer Console, edite el proyecto. A continuación, seleccione el registro de evento que ha creado.
-
En la página de detalles de registro del evento, seleccione Edit Events Registration.
-
Seleccione Next hasta que llegue a la pantalla de selección de consumidores. A continuación, seleccione el consumidor que ha configurado.
-
Actualice el consumidor al destino configurado. A continuación, seleccione Save configured events.
-
Validación del flujo de eventos validate-event-flow
Los eventos de catálogo están habilitados para su entorno. Cuando los datos del catálogo cambian en Commerce, las actualizaciones fluyen por Catalog Service hasta Adobe I/O Events y el consumidor suscrito recibe el evento de catálogo correspondiente. Revise Límites y prácticas recomendadas antes de generar integraciones de producción.
-
Realice un cambio de catálogo sencillo y compatible, como actualizar el nombre de un producto o cambiar un precio.
-
Confirme los siguientes resultados:
- El cambio es visible a través de las API Catalog Service.
- El consumidor Adobe I/O Events recibe el evento de producto o precio correspondiente.
Límites y prácticas recomendadas limits-and-best-practices
Cuando genere eventos de catálogo, siga estas prácticas recomendadas.
Idempotencia idempotency
Adobe I/O Events puede entregar el mismo evento de catálogo más de una vez y los eventos de un solo producto pueden llegar sin orden. Diseñar consumidores idempotentes mediante:
- Uso de ID de entidad con un campo de versión o marca de tiempo.
- Ignorar de forma segura las notificaciones duplicadas para el mismo cambio.
Rendimiento y contrapresión
Los catálogos grandes con altas tasas de actualización pueden generar un volumen de evento significativo. Asegúrese de que:
- Los consumidores pueden procesar eventos con un rendimiento máximo.
- Utilice el almacenamiento en búfer, el agrupamiento o las colas donde sea necesario.
Seguridad y aislamiento
- Adobe I/O Events aplica aislamiento de inquilinos.
- Su organización recibe eventos solo para sus propios entornos y autorizaciones.
Evolución del esquema
Las cargas de eventos de catálogo siguen el mismo modelo conceptual que las API Catalog Service. Para seguir siendo compatible con versiones anteriores:
- Evite la aplicación estricta del esquema siempre que sea posible.
- Omitir campos desconocidos en lugar de errores.
Solucionar problemas de eventos de catálogo troubleshoot-catalog-events
Si faltan o se retrasan los eventos de catálogo, siga estos pasos.
-
Comprobar datos del servicio de catálogo
Use la Catalog Service API para confirmar que el cambio de catálogo se almacene correctamente.
-
VerificarSaaS Data Export
Los eventos de catálogo requieren datos actuales en Catalog Service. Confirme ambas fases de la ruta de exportación:
-
Exportación de fuente desde Commerce: en la página Estado de sincronización de fuente de datos o en
var/log/saas-export.log, confirme que Catalog Service fuentes se exportaron correctamente desde Commerce. -
Sincronizar con los servicios SaaS de Commerce conectados: en el panel de administración de datos, sincronización de catálogos o en los registros de exportación, confirme que los datos se sincronizaron correctamente con Catalog Service.
Para solucionar problemas con los trabajos de exportación y sincronización, consulte Sincronizar datos con la exportación de datos SaaS y Registro y solución de problemas.
-
-
Validar configuración de Adobe I/O Events
Confirme que:
- Ha iniciado sesión en la organización IMS correcta en Adobe Developer Console.
- El proveedor Commerce Catalog Events está habilitado.
- El proveedor Commerce Catalog Events y el entorno esperados son visibles.
- La suscripción está activa.
- El extremo, la acción o el consumidor del diario pueden recibir y procesar eventos de prueba.
-
Póngase en contacto con el Soporte técnico de Adobe
Al abrir un ticket de asistencia, seleccione el motivo del problema que corresponde a aplicación de Adobe Commerce e incluya la siguiente información:
- Detalles del servicio de catálogo (entorno, región).
- Adobe I/O Events detalles de suscripción.
- Hora aproximada y descripción de los eventos que faltan.
Para obtener ayuda adicional, consulte tickets de asistencia.