Depuración GTM: guía práctica para analistas y CRO

Depuración GTM

Depuración GTM: El modo de vista previa de Google Tag Manager permite probar un contenedor completo sin publicar ningún cambio. Para iniciar una sesión de depuración basta con tres pasos: abrir el contenedor en tagmanager.google.com, pulsar «Vista previa», introducir la URL del sitio y hacer clic en «Conectar». Tag Assistant abre entonces una consola con el flujo de eventos del dataLayer, las etiquetas activadas (Tags Fired), las que no se dispararon (Tags Not Fired) y los valores de todas las variables, todo ello visible únicamente durante esa sesión.

Los tres resultados inmediatos que obtienes al conectar:

  • Flujo de eventos: cada interacción del usuario aparece en la columna izquierda en tiempo real.
  • Tags Fired / Not Fired: confirma qué etiquetas se activaron y cuáles fallaron en cada evento.
  • Variables y dataLayer: muestra los valores exactos que GTM leyó en el momento del disparo.

Puntos clave

La depuración efectiva en GTM requiere validar el disparo en la consola de Tag Assistant, confirmar la petición en Network y verificar la recepción en DebugView de GA4, los tres pasos son necesarios y ninguno sustituye a los otros.

PuntoDetalles
Flujo de validación completoPreview GTM → Network → DebugView GA4; omitir cualquier paso deja puntos ciegos.
dataLayer sensible a mayúsculasUna clave mal escrita devuelve undefined; verifica siempre con console.log(dataLayer).
Entornos de stagingEjecuta el checklist completo en staging antes de publicar para evitar regresiones en producción.
Sesiones compartidasComparte la URL de depuración de Tag Assistant para que el equipo reproduzca el fallo exacto.
LG DataOneAutomatiza auditorías y monitorización continua de GTM/GA4 para detectar regresiones sin revisión manual.

👉 Si necesitas descargarte infografías sobre Depuración GTM, descuentos en cursos y herramientas y mucho más puedes hacerlo aquí: descargar infografías y recursos

 
 
Depuración GTM: guía práctica para analistas y CRO

Prueba GRATIS 3 MESES LG DataOne

Analiza mejor, decide antes y haz crecer tu negocio con LG DataOne. Empieza gratis con el cupón de descuento 3MESESGRATIS y obtén 3 meses gratis.

 

Tabla de contenidos depuración GTM

Resumen de la guía de depuración GTM

Esta guía cubre el ciclo completo de depuración en Google Tag Manager: desde iniciar la sesión de vista previa hasta validar eventos en DebugView de GA4, resolver los fallos más frecuentes y aplicar buenas prácticas de privacidad para entornos de Central Europe.

ApartadoQué encontrarás
Checklist de inicioPasos numerados para arrancar una sesión en menos de 5 minutos
Interfaz de depuraciónCómo leer Tags Fired, variables y el flujo de eventos
GTM vs. DebugView GA4Diferencias, complementariedad y flujo recomendado
Problemas habitualesTabla de causa → solución para los fallos más frecuentes
Casos de pruebaChecklist por tipo de evento: pageview, clics, formularios, ecommerce
Consejos avanzadosSesiones compartidas, cross-domain y Block & Swap
Privacidad y Consent ModeImplicaciones regulatorias y prácticas operativas
ConclusionesAcciones inmediatas y siguiente paso recomendado

Autoría: Juan, equipo LG DataOne (Lester Grow).


¿Cómo iniciar una sesión de depuración GTM en menos de 5 minutos?

  1. Accede a tagmanager.google.com e inicia sesión con la cuenta que tiene acceso al contenedor.
  2. Abre el contenedor y pulsa el botón Vista previa en la esquina superior derecha del espacio de trabajo.
  3. Introduce la URL completa del sitio (incluyendo https://) y haz clic en Conectar.
  4. Tag Assistant abre una nueva pestaña con la consola de depuración y añade el parámetro _dbg a la URL para identificar la sesión.
  5. Navega por el sitio en la pestaña original; cada acción aparecerá en tiempo real en la consola.

Si el sitio no acepta parámetros adicionales en la URL (por ejemplo, por reglas de redirección o canonicalización), desmarca la opción «Incluir señal de depuración en la URL» antes de conectar. Tag Assistant mantendrá la sesión activa sin modificar la URL visible.

Comprobaciones rápidas cuando la conexión no aparece:

  • Verifica que el ID de contenedor en el código de la página coincide con el contenedor abierto en GTM.
  • Comprueba que las cookies de terceros no están bloqueadas en el navegador; son necesarias para que Tag Assistant mantenga la sesión.
  • Revisa la consola de red del navegador para detectar bloqueos hacia dominios de Google.
  • Confirma que no hay una VPN o proxy corporativo que filtre las peticiones.

Consejo profesional: En entornos con Content Security Policy (CSP) estricta o con múltiples contenedores activos, abre una ventana de incógnito con las extensiones desactivadas para aislar el problema. Si el contenedor no aparece en modo incógnito, el fallo es de instalación, no de depuración.

 
 
Guía de cookies AEPD: obligaciones y cumplimiento

Prueba GRATIS 3 MESES LG DataOne

Analiza mejor, decide antes y haz crecer tu negocio con LG DataOne. Empieza gratis con el cupón de descuento 3MESESGRATIS y obtén 3 meses gratis.

 

¿Qué te dice la interfaz de Tag Assistant sobre tus etiquetas?

La consola de depuración se divide en cuatro áreas que conviene conocer bien.

Timeline de eventos (columna izquierda): lista cada evento del dataLayer en orden cronológico, desde gtm.js hasta los eventos personalizados. Seleccionar uno actualiza el panel derecho con el contexto exacto de ese momento.

Tags Fired y Tags Not Fired: la primera lista confirma qué etiquetas se ejecutaron; la segunda muestra las que tenían un activador configurado pero cuyas condiciones no se cumplieron. Un activador mal configurado aparece siempre en Tags Not Fired con el motivo del fallo visible al expandir la etiqueta.

Panel de Variables: muestra el valor que GTM leyó para cada variable en el instante del evento seleccionado. Si una variable aparece como undefined, el problema suele estar en el nombre de la clave del dataLayer, que es sensible a mayúsculas y minúsculas.

Ejemplo reproducible: si realizas un dataLayer.push({ 'categoria': 'formulario' }) sin incluir la propiedad event, GTM no registrará ese push como un evento en la línea de tiempo. El push existe en el dataLayer, pero ningún activador basado en eventos personalizados lo verá. Para comunicarlo a un desarrollador, captura la consola del navegador con console.log(dataLayer) justo después del push y adjunta la salida al informe de fallo.

Verificar que una etiqueta aparece en Tags Fired no es el paso final. Hay que abrir la pestaña Network del navegador y confirmar que la petición HTTP hacia el endpoint de GA4 (o cualquier otro destino) salió y obtuvo una respuesta 2xx. Un adblocker, un filtro de red o un error de configuración pueden impedir que la solicitud llegue aunque GTM la haya «disparado».

La guía técnica de Analytics Mania detalla este flujo de verificación y describe cada sección de la interfaz con ejemplos reproducibles.


¿Qué te dice la interfaz de Tag Assistant sobre tus etiquetas? — overview diagram

¿En qué se diferencian la vista previa de GTM y DebugView de GA4?

Ambas herramientas son complementarias y cubren capas distintas del proceso de medición.

  • Vista previa de GTM valida la lógica del contenedor: si el activador se cumple, si la variable tiene el valor correcto y si la etiqueta está configurada para dispararse. No confirma que el dato llegó a GA4.
  • DebugView de GA4 valida que los eventos llegaron a la propiedad y se interpretaron correctamente. Solo muestra eventos que incluyen la señal de depuración (debug_mode o el parámetro _dbg que añade Tag Assistant).

El flujo recomendado tiene tres pasos: primero confirmar el disparo en GTM, después verificar en Network que la petición salió del navegador, y por último comprobar en DebugView de GA4 que el evento aparece con los parámetros correctos.

Si DebugView aparece vacío tras confirmar que GTM disparó la etiqueta, comprueba estos puntos:

  • La etiqueta de GA4 en GTM tiene activada la opción de enviar en modo depuración.
  • Estás mirando la propiedad de GA4 correcta (no una propiedad de prueba distinta).
  • El filtro de tiempo en DebugView está configurado para mostrar los últimos 30 minutos.

Consejo profesional: Abre DebugView y la consola de Network en paralelo. Si la petición aparece en Network pero no en DebugView, el problema suele ser la propiedad seleccionada o un retraso de procesamiento. Si no aparece en Network, el fallo está antes: en GTM o en un bloqueador del navegador.


Problemas habituales al depurar GTM y cómo resolverlos

ProblemaCausa probableSolución
Preview no conecta («Waiting for Tag Assistant»)Cookies de terceros bloqueadas, CSP, ID de contenedor incorrectoDesbloquear cookies de terceros, revisar CSP, verificar ID en el código fuente
Contenedor no detectado en la páginaSnippet de GTM no instalado o instalado incorrectamenteRevisar instalación con la guía de instalación de GTM
Etiqueta en Tags Not Fired sin motivo aparenteVariable undefined por clave con mayúsculas incorrectasComprobar el dataLayer en consola del navegador y corregir la clave
Sesión se pierde al cruzar dominiosTag Assistant no sigue la sesión entre dominios distintosActivar vista previa por separado en cada dominio y capturar eventos puente
Interferencia de otro contenedor GTMDos contenedores activos en la misma páginaUsar Block & Swap de dataLayer Inspector+ para aislar el contenedor a probar
Preview no funciona en iframesTag Assistant no accede al contexto del iframe sin extensiónInstalar la extensión de Tag Assistant; la depuración de iframes la requiere

La herramienta dataLayer Inspector+ incluye la función Block & Swap Script, que bloquea el contenedor de producción y carga uno limpio sin modificar el entorno real. Es útil para aislar interferencias sin tocar producción.

Cuando el modo de vista previa de GTM no funciona, las causas más frecuentes son cookies de terceros bloqueadas, una política CSP que impide el framing, un ID de contenedor distinto en la página o bloqueos de red. Verificar estos cuatro puntos resuelve la mayoría de los casos según la documentación de TaggingDocs.

Los parámetros en la URL también pueden alterar el comportamiento del sitio durante las pruebas. Cuando el sitio usa parámetros para personalizar contenido o activar funciones, el parámetro _dbg puede interferir. En ese caso, desactiva «Incluir señal de depuración en la URL» antes de conectar.


Checklist de casos de prueba antes de publicar cambios en GTM

Pageview y navegación básica

  1. Carga la página de inicio y verifica que el evento gtm.js aparece primero en el timeline.
  2. Confirma que la etiqueta de pageview de GA4 está en Tags Fired.
  3. Abre Network y verifica que la petición a google-analytics.com/g/collect obtuvo respuesta 200.

Clics en CTA y elementos interactivos

  • Activa el activador de clic y haz clic en el elemento objetivo.
  • Comprueba en Tags Fired que la etiqueta asociada se disparó con los parámetros correctos.
  • Revisa que la variable de texto del clic no devuelve undefined.

Envíos de formulario

  1. Rellena y envía el formulario en la pestaña del sitio.
  2. Verifica el evento gtm.formSubmit en el timeline (o el evento personalizado configurado).
  3. Confirma en DebugView de GA4 que el evento generate_lead o equivalente aparece con los parámetros esperados.

Flujo de ecommerce

  • Ejecuta add_to_cart, begin_checkout y purchase en orden.
  • Para cada evento, comprueba en Tags Fired que la etiqueta de GA4 ecommerce se disparó.
  • Verifica en Network que el objeto items se envía con los campos item_id, item_name y value correctamente.

Eventos personalizados

  • Dispara el evento desde la consola con dataLayer.push({ event: 'nombre_evento', parametro: 'valor' }).
  • Confirma que aparece en el timeline y que la etiqueta asociada está en Tags Fired.
  • Revisa el panel de Variables para asegurarte de que el parámetro tiene el valor esperado y no undefined.

Técnicas avanzadas para depuración colaborativa y flujos complejos

Consejo profesional: Para compartir una sesión de depuración con un desarrollador, usa la opción de compartir URL de sesión en Tag Assistant. El otro usuario abre esa URL en su navegador y ve exactamente el mismo estado del contenedor, sin necesidad de acceso a GTM.

Pasos para compartir y reproducir una sesión:

  1. Inicia la sesión de depuración normalmente desde GTM.
  2. En la interfaz de Tag Assistant, localiza la opción para compartir la URL de depuración.
  3. Envía esa URL al desarrollador o compañero de equipo.
  4. El receptor abre la URL en su navegador y reproduce los pasos exactos que generaron el fallo.

Para flujos cross-domain, activa la vista previa por separado en cada dominio implicado. Tag Assistant no sigue automáticamente la sesión entre dominios distintos, así que captura los eventos puente (por ejemplo, el evento de salida del primer dominio y el de entrada al segundo) de forma independiente en cada consola.

Para reproducir comportamientos que solo aparecen en producción, prueba con una VPN que simule la geolocalización del usuario afectado, o usa perfiles de Chrome con las mismas cookies y extensiones que el usuario reportó. El Block & Swap de dataLayer Inspector+ permite cargar el contenedor de staging sobre la URL de producción sin modificar el código del sitio.

Manos ajustando la configuración de una VPN desde el teclado


El Consent Mode de Google afecta directamente a qué etiquetas se disparan durante una sesión de depuración. Si el usuario (o el perfil de prueba) no ha dado consentimiento, las etiquetas de medición pueden quedar bloqueadas por diseño, lo que hace que aparezcan en Tags Not Fired aunque la configuración sea correcta.

Recomendaciones operativas para entornos de Central Europe:

  • Usa entornos de staging para pruebas que procesen datos personales reales; nunca expongas el parámetro _dbg a usuarios reales en producción.
  • Controla el acceso al contenedor GTM: solo los usuarios con rol de Editor o superior pueden iniciar sesiones de vista previa.
  • Registra cada cambio en el historial de versiones de GTM antes de publicar, con una descripción que permita revertir si aparece una regresión.
  • Antes de publicar, ejecuta el checklist completo de casos de prueba en staging y comparte la sesión reproducible con al menos otro miembro del equipo.

Las leyes de privacidad vigentes en Central Europe, incluido el RGPD, exigen consentimiento explícito antes de activar etiquetas de medición o publicidad. Depurar con Consent Mode activo y sin consentimiento simulado puede dar resultados que no reflejan el comportamiento real en producción. Valida siempre el flujo con y sin consentimiento para cubrir ambos escenarios. Puedes verificar tu configuración con el check de Consent Mode de LG DataOne.

Esta información es de carácter general. Para casos específicos con implicaciones legales, consulta con un profesional especializado en protección de datos.


Conclusiones y siguientes pasos tras la depuración

Acciones inmediatas que debes ejecutar después de leer esta guía:

  • Inicia una sesión de vista previa en tu contenedor activo y verifica que el evento de pageview aparece en Tags Fired.
  • Abre la consola del navegador y ejecuta console.log(dataLayer) para confirmar que los pushes llegan con las claves correctas.
  • Revisa la pestaña Network para cada etiqueta crítica y confirma respuestas 2xx.
  • Valida en DebugView de GA4 que los eventos llegan con los parámetros esperados.
  • Comparte la sesión de depuración con tu equipo antes de publicar cualquier cambio.

El siguiente paso natural es pasar de la depuración puntual a la monitorización continua. Una auditoría automatizada detecta regresiones tras cada despliegue sin necesidad de repetir el checklist manualmente. LG DataOne ofrece ese nivel de supervisión sobre implementaciones GTM y GA4.


LG DataOne: auditoría y monitorización continua para tu GTM

LG DataOne

Depurar manualmente antes de cada publicación consume tiempo y deja margen para el error humano. LG DataOne automatiza las comprobaciones recurrentes: audita tu configuración de GTM y GA4, detecta etiquetas que dejan de enviar datos tras un despliegue y alerta sobre problemas de Consent Mode antes de que afecten a tus conversiones.

La diferencia concreta frente al proceso manual es la cobertura continua: mientras que una sesión de vista previa valida el estado en un momento dado, LG DataOne monitoriza el contenedor de forma permanente y genera alertas cuando algo cambia sin que lo hayas publicado tú. Para equipos que gestionan múltiples propiedades o trabajan con ciclos de despliegue frecuentes, eso elimina la pérdida silenciosa de datos.

Prueba la plataforma durante 14 días sin coste en Lgdataone y comprueba cuántas incidencias detecta en tu implementación actual.


Lo que la mayoría pasa por alto al depurar GTM

La depuración en GTM se enseña casi siempre como un proceso lineal: activa la vista previa, mira si la etiqueta se disparó, listo. Esa simplificación es el origen de la mayoría de los problemas que llegan a los equipos de analítica semanas después de publicar.

El error más extendido es confundir «Tags Fired» con «dato recibido». Una etiqueta puede aparecer en Tags Fired y aun así no haber enviado nada útil: un adblocker bloquea la petición, el endpoint de GA4 recibe el evento sin los parámetros de ecommerce, o Consent Mode impide el disparo en producción aunque en staging todo parecía correcto. Sin la verificación en Network y en DebugView, esa diferencia es invisible.

El segundo punto que se subestima es el Consent Mode. En Central Europe, donde el RGPD se aplica con rigor, depurar sin simular el estado de consentimiento del usuario real produce resultados que no se corresponden con el comportamiento en producción. Un checklist que no incluya pruebas con y sin consentimiento está incompleto por definición.

Por último, la depuración colaborativa sigue siendo un proceso ad hoc en la mayoría de los equipos. Compartir capturas de pantalla no es lo mismo que compartir una sesión reproducible. Tag Assistant permite hacerlo de forma nativa; usarlo debería ser el estándar, no la excepción.


Fuentes sobre la depuración GTM

Autoría: Juan, equipo LG DataOne (Lester Grow).


Preguntas frecuentes relacionadas con la depuración GTM

¿Cómo se activa el modo de vista previa en GTM?

Abre el contenedor en tagmanager.google.com, pulsa «Vista previa» en el espacio de trabajo, introduce la URL del sitio y haz clic en «Conectar». Tag Assistant abre la consola de depuración sin publicar ningún cambio.

¿Por qué el modo de vista previa de GTM no se conecta?

Las causas más frecuentes son cookies de terceros bloqueadas, una política CSP que impide el framing, un ID de contenedor distinto al instalado en la página o bloqueos de red. Verificar estos cuatro puntos resuelve la mayoría de los casos.

¿Para qué sirve DebugView de GA4 si ya tengo la vista previa de GTM?

GTM valida que la etiqueta se disparó; DebugView confirma que el evento llegó a la propiedad de GA4 con los parámetros correctos. Son complementarios: necesitas ambos para cerrar el ciclo de validación.

¿Qué significa que una variable aparezca como «undefined» en GTM?

Indica que GTM no encontró la clave en el dataLayer en el momento del evento. El dataLayer es sensible a mayúsculas y minúsculas, así que una diferencia entre ecommerce y Ecommerce produce ese resultado. Verifica con console.log(dataLayer) en la consola del navegador.

¿Cómo puedo compartir una sesión de depuración con mi equipo?

Tag Assistant permite generar una URL de sesión que otro usuario puede abrir en su navegador para ver el mismo estado del contenedor. Es la forma más fiable de reproducir un fallo sin necesidad de acceso directo a GTM.

Recomendaciones sobre la depuración GTM