Integración · plataforma de e-commerce
Shopware 6
App de Shopware con script de storefront y webhooks de pedido firmados.
Cómo llegan los eventos a Shopware
Los webhooks de la propia tienda son la fuente autorizada para compras y reembolsos. Track verifica la firma, empareja el pedido con la compra del navegador por ID de pedido y solo entonces lo enruta; el consentimiento se hereda, nunca se presupone.
- Navegador: el script de la tienda envía los eventos estándar con el estado del consentimiento y los IDs de clic del visitante; la compra lleva el ID de pedido para el emparejamiento.
- Servidor: los webhooks firmados de la tienda entregan los pedidos pagados y los reembolsos con importes y líneas de pedido; Track verifica cada firma antes de aceptar un registro.
Qué recibe Track
Dos rutas complementarias, emparejadas por ID de pedido en la fase de ingesta.
- Pedidos pagados y reembolsos desde los webhooks firmados de la tienda: ID de pedido, importes, moneda, líneas de pedido y los datos de matching del cliente, convertidos en hash en la ingesta.
- Eventos estándar de navegador desde la tienda (vista, añadir al carrito, checkout, compra) con el registro de consentimiento del visitante y los IDs de clic capturados.
- El ID de pedido en ambas rutas, de modo que el registro verificado de la tienda sustituye a la compra del navegador sin contar dos veces.
Nunca se presupone
- El consentimiento de marketing: un webhook de tienda no lleva consentimiento propio. Sin una compra de navegador emparejada, el registro se queda como registro operativo y solo llega a destinos que no necesitan consentimiento.
- Datos de clientes en claro en plataformas publicitarias: los datos de matching se convierten en hash antes de almacenarse.
- Webhooks sin firma o no verificables: una comprobación de firma fallida se registra y se descarta.
Datos técnicos
- Clave de emparejamiento
order_id— order id- Finalidad del consentimiento
- Necesaria
- Estado de implementación
- Implementada · probada con payloads de webhook firmados y grabados
- Documentación del proveedor
- Documentación de Track
Qué necesitas
Los identificadores públicos se pueden escribir en el chat o en el asistente paso a paso; los secretos pasan por la tarjeta segura de credenciales o por OAuth y se guardan cifrados.
Identificadores públicos
- shop_domain
- Dominio de la tienda
- default_currency
- Moneda de reserva
- purchase_on
- Momento de la compra (pagado o realizado) (opcional)
Credenciales
- Secreto del webhook
webhook_secret— guardado en el almacén cifrado
Consentimiento
Los webhooks de tienda no llevan consentimiento propio. Un pedido verificado hereda el registro de consentimiento de la compra de navegador emparejada; sin ella se guarda como registro operativo y nunca llega a una plataforma publicitaria.
Configuración en pocos pasos
El asistente ejecuta las comprobaciones detalladas. Tú ves los hitos que necesitan una decisión tuya.
Conecta la tienda
Introduce el dominio de la tienda y la moneda por defecto. Track genera la URL del webhook y el secreto una sola vez.
Instala la parte de la tienda
Instala la extensión de píxel, el plugin o la app y registra los webhooks con el secreto generado.
Verifica con un pedido de prueba
El primer webhook firmado pasa la conexión a conectada; los topics observados y el último webhook se muestran en directo.
De Tracking Knowledge
Guías escritas por el equipo que construye este conector.
Tracking en Shopware 6 bien hecho: una app con webhooks firmados, la transacción pagada como compra y el snippet del storefront
Cómo se registra la app de Track para Shopware, qué eventos de pedido se mapean a purchase y refund, cómo se verifica la shopware-shop-signature, por qué el estado de transacción pagada supera al pedido realizado y dónde va el snippet en el tema.
Tutorial · 4 min de lectura
Preguntas
¿Sigo necesitando la compra del navegador?
Es opcional, pero valiosa: lleva el registro de consentimiento y los IDs de clic del visitante, que el servidor no puede conocer. El registro verificado de la tienda la sustituye en valor y artículos.
¿Se cuenta el mismo pedido dos veces?
No. La compra del navegador, la API de servidor y el webhook de la tienda comparten el ID de evento derivado del pedido, y el registro de conversión mantiene una sola fila por pedido.
¿Qué ocurre si la plataforma reintenta un webhook?
Las reentregas producen IDs de evento deterministas y chocan con la protección de deduplicación a nivel de evento; nada se cuenta de nuevo.
Conecta Shopware
Configúralo con el asistente paso a paso o deja que el asistente de IA lo haga en el chat.