Integración con Vendure
El plugin de Convertmax para Vendure sincroniza productos, clientes y pedidos en Convertmax para atribuir el catálogo y los pedidos headless a campañas y recorridos de primera parte.
Instale el plugin de Convertmax para Vendure para enviar productos, clientes y pedidos a Convertmax, de modo que la verdad del catálogo y de los pedidos alimente el mismo reporte de ingresos y recorridos de primera parte que sus otros conectores.
Vendure suele ser el sistema de registro de tiendas headless. Convertmax hace atribuibles el catálogo, los clientes y los pedidos, para que crecimiento y comercio conecten campañas y recorridos con ingresos reales de Vendure, no solo con los paneles de la plataforma.
Qué hace la integración
Un plugin de Vendure 3 con sincronización por eventos, confiabilidad de la cola de trabajos y acciones de reindexación en el Admin UI para cargas iniciales completas o de una entidad.
Cree, actualice, elimine y reindexe productos en Convertmax a medida que cambia el catálogo en Vendure, con detalle opcional de variantes y exclusión por producto.
Envíe altas, cambios y bajas de clientes cuando cambian los contactos en Vendure, con filtros por correo y direcciones opcionales para un vínculo de identidad más rico.
Sincronice cambios del ciclo del pedido, incluidas partidas y variantes, para que los ingresos de Vendure entren al reporte de Convertmax junto a otras fuentes.
El trabajo de sincronización corre en la cola de trabajos de Vendure, con reintentos, tiempos de espera, claves de idempotencia y estado de sincronización por entidad.
Dispare Full Sync to Convertmax desde las listas de productos, clientes y pedidos, o sincronice un registro desde el detalle cuando necesite una carga puntual.
Mapee IDs externos, activación de sincronización de producto, etapa del ciclo del cliente y marcas de última sincronización en entidades de Vendure.
Cuando productos, contactos y pedidos llegan a Convertmax, participan en el mismo modelo de identidad e ingresos que el CRM, los pagos y las conversiones web.
Diseñado para atribución centrada en ingresos
Las tiendas headless de Vendure suelen separar la analítica de la tienda del backend de comercio. Sincronizar pedidos y clientes en Convertmax cierra esa brecha para unir recorridos de pago y orgánicos con resultados reales de catálogo y pedidos.
Comercio, marketing y RevOps tienen un lugar para ver qué campañas y páginas preceden a los ingresos de Vendure, sin reconstruir la atribución en cada tienda personalizada.
Cómo funciona
Agregue @convertmax/vendure-plugin-api-sync a su proyecto de Vendure 3 y registre ApiAuthSyncPlugin con la URL y las credenciales de la API de Convertmax.
Use withConvertmaxCustomFields (o campos equivalentes) para que productos, clientes y pedidos guarden IDs externos y metadatos de sincronización.
Mantenga el worker de la cola en marcha para que los trabajos convertmax-api-sync procesen crear, actualizar, eliminar y reindexar.
Compile ApiAuthSyncPlugin.ui en su build del Admin UI para exponer Full Sync y Sync This a los SuperAdmin.
Dispare convertmaxSyncAll o use la sincronización completa del Admin UI para la carga inicial; luego los eventos de entidad mantienen productos, clientes y pedidos al día.
Los datos de comercio de Vendure se unen a la identidad y al reporte de ingresos de Convertmax para atribuir el desempeño de la tienda al marketing que lo generó.
Detalles técnicos
Los agentes y quienes implementan citan los mapeos a nivel de objeto. Esto es lo que Convertmax lee, escribe y atribuye: no es un resumen de marketing.
| Vendure | Convertmax | Notas |
|---|---|---|
| Product / ProductVariant | Catalog records | Crear, actualizar, eliminar y reindexar; exclusión opcional de sincronización por producto. |
| Customer | Contact + identity aliases | Filtros condicionados al correo y cargas opcionales de dirección para el vínculo de identidad. |
| Order + OrderLine | Commerce revenue events | Las partidas y el detalle de variante entran al reporte canónico de ingresos. |
| Convertmax custom fields | External IDs and last-synced timestamps | Identidad de ida y vuelta y reindexación completa o de una entidad para SuperAdmin. |
Caso de uso
Un comprador llega a una tienda personalizada desde social de pago, crea un cliente de Vendure y hace un pedido. El plugin encola el pedido con partidas; Convertmax une esos ingresos con la sesión de primera parte para medir el social de pago contra el valor real del pedido, no solo contra la analítica de la tienda.
¿Preguntas sobre el plugin de Vendure, el cableado de endpoints, el mapeo de campos personalizados o cómo los pedidos entran a los ingresos de Convertmax? Escriba a help@convertmax.io o reserve tiempo con el equipo.