Pixel App implementacion
User documentation
2026-02-11
Proyecto: VTEX Pixel App - Tracking GA4 Server-Side Entorno: catycanrnl1¶
1. Objetivo del MVP
Desarrollar una Pixel App que actúe como puente entre el pixel-manager de VTEX y el contenedor Server-Side de Stape.io. El propósito es capturar eventos transaccionales y de comportamiento para enviarlos a GA4, optimizando la performance y la integridad de los datos.
+1
2. Alcance Funcional (Mapping de Eventos)
Se deben implementar y mapear los siguientes eventos críticos siguiendo el esquema de Stape/GA4:
+2
Navegación: PageViewData (page_view) y HomePageInfo.
+2
Usuario: UserData para resolución de identidad (email/userId).
E-commerce (Funnel):
ProductViewData (view_item).
+1
ProductImpressionData y ProductClickData (select_item).
+2
AddToCartData (add_to_cart) y RemoveFromCartData.
+1
Transaccional (Crítico): OrderPlacedData (purchase) incluyendo orderId, value, y array de productos.
+1
3. Requerimientos Técnicos
Lenguaje: JavaScript (ES6+) exclusivo.
Transporte: Uso de fetch con keepalive: true para eventos de compra.
+1
Performance: Inyección asíncrona de scripts para no afectar el LCP.
Seguridad: Control de duplicados en la página de agradecimiento.