Inicio › dataLayer de Google Tag Manager y GA4 - Qué es, cómo usarlo y errores comunes

dataLayer de Google Tag Manager y GA4 - Qué es, cómo usarlo y errores comunes

Qué es el dataLayer, cómo enviar eventos con dataLayer.push, leerlos con variables de Tag Manager, mandarlos a GA4, depurarlos y los errores que impiden que se disparen las etiquetas.

9 min de lectura Por Emilio Rodríguez Publicado 19/11/2026

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.

Recibir la newsletter

  1. Qué es el dataLayer
  2. Declararlo
  3. Enviar variables y eventos con push
    1. El orden importa
  4. Leer los datos en Tag Manager
  5. Mandar el evento a GA4
  6. Ecommerce
  7. Depurar
  8. Errores frecuentes
  9. Checklist
  10. Recursos
  11. 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'
});

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:

  1. Ve a Variables y pulsa Nueva en Variables definidas por el usuario.
  2. Elige el tipo Variable de capa de datos e indica el nombre de la clave.
  3. 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:

  1. Activador: de tipo Evento personalizado, con el mismo nombre que pusiste en event (por ejemplo clic_boton_newsletter).
  2. 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.
  3. 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:

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:

Checklist

Recursos

Preguntas y respuestas

Un objeto de JavaScript, estructurado como JSON, que Google Tag Manager y gtag.js usan para pasar información a las etiquetas. Los activadores pueden basarse en sus valores.
Las causas más comunes que recoge Google: escribir datalayer en minúsculas (debe ser dataLayer), sobrescribir el array con dataLayer = [...] en lugar de usar push, claves sin comillas o con nombres distintos entre páginas, o que el valor no esté listo cuando se dispara la etiqueta. Revisa la pestaña de datos en el modo de vista previa.
No. Según Google, las variables solo duran mientras el visitante permanece en la página actual. Si quieres usarlas en otra, tienes que volver a enviarlas en cada página.
Sí, si quieres verlos en informes. Los parámetros de evento se analizan creando una dimensión personalizada con ámbito de evento. Google indica que puede tardar de 24 a 48 horas en estar disponible, y que las propiedades estándar admiten 50 dimensiones de ese tipo.
Sí. gtag.js también usa el dataLayer. Con Tag Manager separas el código de la web de la configuración de etiquetas, que puede cambiar quien gestiona la medición sin tocar el código.

Dashboard SEO gratuito Newsletter en LinkedIn

Biblioteca gratuita

Sigue explorando la chuleta.

Guías, herramientas y recursos SEO ordenados por tema.