El dataLayer es la capa de datos con la que tu web le cuenta a Google Tag Manager qué está pasando: un clic, una compra, el tipo de página. Si lo entiendes, puedes medir en GA4 cualquier interacción sin depender de que el desarrollo toque cada etiqueta. Esta guía explica cómo funciona, cómo enviar eventos y los errores que más hacen fallar la medición.
- Qué es el dataLayer
- Declararlo
- Enviar variables y eventos con push
- Leer los datos en Tag Manager
- Mandar el evento a GA4
- Ecommerce
- Depurar
- Errores frecuentes
- Checklist
- Recursos
- Preguntas y respuestas
Qué es el dataLayer
Según la documentación de Google, el dataLayer es un objeto de JavaScript que Google Tag Manager y gtag.js usan para pasar información a las etiquetas. Tiene estructura JSON y los activadores pueden basarse en sus valores: por ejemplo, disparar una etiqueta cuando llega un evento concreto.
La idea práctica: tu web empuja datos al dataLayer y Tag Manager los lee. Así, el código de la web solo informa de lo que ocurre, y Tag Manager decide qué etiquetas se disparan.
Declararlo
Crea el array antes del código del contenedor de Tag Manager, para que los valores estén disponibles cuando este se cargue:
window.dataLayer = window.dataLayer || [];
Los datos que deban estar disponibles al cargar la página se empujan por encima del fragmento de Tag Manager. Google recomienda instanciarlo lo más arriba posible en el código fuente.
Enviar variables y eventos con push
Añades o actualizas valores con dataLayer.push():
dataLayer.push({
'tipo_pagina': 'guia',
'event': 'guia_vista'
});
- La clave
eventle indica a Tag Manager que ha ocurrido un evento. Su valor es el nombre con el que lo identifican los activadores de tipo “Evento personalizado”. - Las variables que envías duran solo mientras el visitante sigue en la página actual. Para usarlas en otra página, vuelve a enviarlas en cada una.
Ejemplo de un clic en un botón:
<button onclick="dataLayer.push({'event': 'clic_boton_newsletter'});">Recibir la newsletter</button>
El orden importa
Tag Manager procesa los mensajes en cola, el primero que entra es el primero que sale. Si metes datos y después un evento por separado, los valores pueden no estar listos. La solución de Google: envía el nombre del evento junto con los datos en el mismo push y escucha ese evento con un activador de evento personalizado.
Leer los datos en Tag Manager
Las etiquetas leen el dataLayer con variables de capa de datos. En Tag Manager, según la ayuda de Google:
- Ve a Variables y pulsa Nueva en Variables definidas por el usuario.
- Elige el tipo Variable de capa de datos e indica el nombre de la clave.
- Ponle un nombre claro, por ejemplo “DLV - tipo_pagina”, y guarda.
Versión 1 y versión 2: en la versión 1 un punto en el nombre de una clave se lee como parte de la clave. En la versión 2 se lee como anidación, de modo que a.b.c se interpreta como {a: {b: {c: ...}}}. Para leer datos anidados, como los de ecommerce, usa la versión 2.
Mandar el evento a GA4
El patrón habitual:
- Activador: de tipo Evento personalizado, con el mismo nombre que pusiste en
event(por ejemploclic_boton_newsletter). - Etiqueta: de tipo Evento de Google Analytics: GA4, con el nombre de evento que quieras ver en GA4 y los parámetros que necesites, tomados de tus variables de capa de datos.
- Dimensión personalizada en GA4: si quieres ver un parámetro en los informes, créalo como dimensión personalizada con ámbito de evento. Google indica que puede tardar de 24 a 48 horas en estar disponible. Las propiedades estándar admiten 50 de este tipo.
Evita nombres de evento y parámetros que cambien según la página. Elige una convención y úsala siempre: Google avisa de que usar visitor_type en una página y visitorType en otra impide que las etiquetas se disparen de forma coherente.
Ecommerce
Los eventos de ecommerce de GA4 llevan un array items. Según la guía de Google para GA4:
- Cada producto necesita
item_idoitem_name, y se recomienda enviar ambos. - El array admite hasta 200 elementos.
- Si envías
value, indicacurrencyen el evento. - En
purchase,transaction_ides obligatorio.
Ejemplo de la estructura de una compra enviada al dataLayer:
dataLayer.push({ ecommerce: null }); // limpia el objeto anterior
dataLayer.push({
event: 'purchase',
ecommerce: {
transaction_id: 'T-1001',
value: 49.90,
currency: 'EUR',
items: [{ item_id: 'SKU-1', item_name: 'Producto', price: 49.90, quantity: 1 }]
}
});
El dataLayer.push({ ecommerce: null }) previo es una práctica muy extendida: Tag Manager fusiona los datos y puede arrastrar claves del evento anterior. No he podido comprobar esa recomendación en la documentación de Google que consulté, así que contrástala con la guía de ecommerce de Tag Manager antes de implementarla.
Depurar
En Tag Manager, pulsa Vista previa en el espacio de trabajo. Se abre Tag Assistant: escribe la URL de tu web y conecta. Mientras navegas puedes ver qué etiquetas se han disparado, en qué orden y qué activador las provocó. Si una no se dispara, mira si el evento llegó y con qué nombre exacto.
Para comprobar que el dato llega a GA4, usa DebugView. Google indica que los informes estándar, las exploraciones y la API tardan alrededor de 24 horas en mostrar los datos.
Errores frecuentes
La documentación de Google recoge estos:
- Sobrescribir el array.
dataLayer = [{...}]reemplaza los valores existentes. Declara una vez conwindow.dataLayer = window.dataLayer || [];y usapush. Reasignarlo después de cargar Tag Manager puede impedir que las etiquetas se disparen. - Escribir
datalayer. El nombre distingue mayúsculas: debe serdataLayer. - Claves sin comillas.
{new-variable: 'valor'}no es válido. Usa{'new-variable': 'valor'}. - Nombres inconsistentes entre páginas.
- Varios dataLayer. Solo se admite un array por página.
- Esperar que el valor persista en la página siguiente.
Checklist
- El dataLayer se declara antes del código de Tag Manager.
- Cada evento lleva
eventy sus datos en el mismo push. - Convención de nombres escrita y compartida con el equipo.
- Variables de capa de datos creadas en Tag Manager (versión 2 si hay anidación).
- Evento personalizado y etiqueta GA4 configurados.
- Parámetros registrados como dimensiones personalizadas.
- Probado con la vista previa y DebugView antes de publicar.
Recursos
- El dataLayer (documentación de Google)
- Variable de capa de datos en Tag Manager
- Vista previa y depuración de contenedores
- Dimensiones y métricas personalizadas de GA4
- Eventos de ecommerce de GA4
- Google Analytics 4: guía
- Medir el tráfico de IA en GA4
- Herramientas SEO