Elige el camino
- Store Framework (VTEX IO): lo más sencillo es usar la app de Google Tag Manager de VTEX y agregar Albunea como una etiqueta, igual que en la guía de Google Tag Manager.
- CMS Portal (tiendas «legacy»): pega el código en el encabezado de las plantillas HTML de tu tienda desde el CMS de VTEX (Layout › Plantillas), en todas las plantillas públicas.
Pasos con Google Tag Manager
- Instala y configura la app de Google Tag Manager en tu cuenta de VTEX con el contenedor de tu tienda.
- En Google Tag Manager crea la etiqueta de Albunea como explica la guía de Google Tag Manager y publícala.
- Revisa que el dominio de tu tienda esté en Ajustes › Dominios del panel. Albunea solo acepta datos que vienen de esos dominios; «*.tutienda.mx» incluye los subdominios. Agrega también el dominio «.myvtex.com» si lo usas para probar.
- Abre tu tienda en otra pestaña y navega un poco. En el panel, en Instalación, verás «Última señal» con la página que acabas de abrir, normalmente en segundos.
Eventos de comercio
Albunea lee los eventos de comercio con formato de Google Analytics 4 que la tienda publica en dataLayer. Si tu app de Google Tag Manager de VTEX está configurada para GA4, los toma sin más código. Para comprobarlo, agrega un producto al carrito y revisa en Instalación que llegue «add_to_cart».
Si tu tienda publica los eventos en otro formato, tu equipo puede traducirlos con albunea('evento', …) como explica la guía de código a mano.
Compras confiables
Para que cada pedido pagado cuente aunque el navegador falle, un servicio tuyo puede escuchar los cambios de estado de los pedidos de VTEX y mandar la compra a la API de servidor de Albunea (desde Presagio). Ve la guía de identificación y compras desde tu servidor.