¿Qué son los Customer Events de Shopify (web pixels)?
Los Customer Events de Shopify son los eventos de comportamiento estandarizados —como product_viewed, product_added_to_cart y checkout_completed— que una tienda Shopify publica en su propia capa de datos, a la que se suscriben los web pixels para reenviarlos a la analítica o a endpoints de marketing.
Un web pixel es JavaScript registrado en la tienda que se ejecuta dentro de un sandbox gestionado por Shopify, no en el contexto JavaScript de la propia página. Shopify expone el mismo flujo de eventos en el storefront, el checkout y las superficies de post-compra, de modo que un pixel puede recibir eventos de checkout que el código del tema nunca ve.
- eventos estándar
- product_viewedproduct_added_to_cartcheckout_completed
Daniil Maximkin Publicado Revisado
- En la práctica
¿Cómo funcionan Customer Events y los web pixels?
Shopify publica los customer events en su propia capa de datos a medida que un visitante avanza por la tienda, y un web pixel se suscribe a los eventos que necesita. El pixel recibe el nombre del evento y el payload por la Web Pixels API y reenvía lo que necesita, en el storefront, el checkout y la post-compra.
Los app pixels son extensiones de app de tipo web pixel que instalan las apps y se ejecutan en un sandbox estricto basado en un web worker. Los pixels personalizados los añade el comercio y se ejecutan en un sandbox laxo: un iframe con permisos de script y de formularios, para que los snippets heredados sigan funcionando.
- En la práctica
¿A qué eventos estándar puede suscribirse un pixel?
Shopify define un conjunto fijo de eventos estándar, que cubre el recorrido de compra desde page_viewed y product_viewed hasta cart_viewed, product_added_to_cart y search_submitted, y después los pasos del checkout.
Los eventos de checkout incluyen checkout_started, checkout_contact_info_submitted, checkout_shipping_info_submitted, payment_info_submitted y checkout_completed. La superficie de post-compra pone el pedido completado a disposición de los pixels suscritos, y por eso Customer Events es la fuente soportada para un evento purchase.
- En la práctica
¿A qué no puede acceder un web pixel?
Un web pixel no puede leer ni escribir el DOM de la página, y no puede alcanzar el frame superior. Los app pixels se ejecutan en un web worker donde solo está garantizado un conjunto documentado de globales; document y window no están disponibles.
Los pixels personalizados se ejecutan en un iframe con sandbox que no puede acceder al frame superior, así que una propiedad como la URL de la página se resuelve a la URL del sandbox en lugar de a la URL de la tienda. Ninguno de los dos tipos puede extraer datos del pedido del marcado del checkout; el payload del evento es la fuente de verdad.
- No confundir con
No confundir con No es Es el dataLayer de Google Tag Manager la capa de eventos propia de Shopify Los Customer Events no son el dataLayer de Google Tag Manager, y un web pixel no es una etiqueta de GTM: son la capa de eventos propia de Shopify, y añadir una etiqueta script al tema no es la forma de instalar un pixel.
Un pixel personalizado tampoco es un script del tema. Se ejecuta bajo las reglas de Shopify, incluido el consentimiento: los web pixels respetan la Customer Privacy API y, en las regiones donde se exige consentimiento, los callbacks de los pixels solo se ejecutan después de que el cliente dé su consentimiento.
- Dónde comprobarlo
¿Cómo compruebo qué pixels están recibiendo eventos?
En el admin de Shopify, Ajustes y luego Customer events lista todos los pixels de la tienda y es donde se añaden los pixels personalizados. Registrar logs dentro de una suscripción a un evento en una tienda de desarrollo confirma que el evento llega y muestra su payload; la documentación de Shopify advierte contra hacer logs en producción.
