Pegaste el código de Google Tag Manager en tu sitio, pero Tag Assistant dice que no encuentra el contenedor. O GTM funciona en unas páginas y en otras no. O GA4 ahora cuenta cada vista de página dos veces. Todo esto sale del mismo lugar: cómo y dónde se instaló el contenedor.
Google Tag Manager (GTM) es un contenedor que carga tus demás etiquetas, como GA4, Google Ads y Meta. Lo instalas una vez, con dos fragmentos cortos, y después administras las etiquetas desde GTM sin tocar el sitio cada vez. Hacer bien esa primera instalación importa, porque todas las etiquetas que agregues después dependen de ella.
Esta guía cubre cómo crear el contenedor, colocar el código en un sitio a la medida, en WordPress, en Shopify y en Squarespace, agregar tu primera etiqueta y verificar todo con Tag Assistant antes y después de publicar.
Respuesta rápida
- Crea un contenedor Web en tagmanager.google.com y copia los dos fragmentos de instalación.
- Pega el primero lo más arriba posible dentro del
<head>y el fragmento<noscript>justo después de la etiqueta de apertura<body>, en todas las páginas. - Quita cualquier otra copia de GTM o etiquetas de GA4 escritas a mano que dupliquen datos.
- Agrega una Etiqueta de Google en GTM con tu ID de GA4, activada en todas las páginas.
- Haz clic en Vista previa, conecta Tag Assistant a tu sitio y confirma que aparecen el contenedor y la etiqueta.
- Haz clic en Enviar > Publicar y revisa otra vez el sitio en vivo con Tag Assistant.
Antes de empezar
Necesitas:
- Una cuenta de Google con permiso para crear una cuenta de GTM, o acceso para Publicar en un contenedor existente.
- Acceso para editar el código, el tema o el área de inyección de código de tu sitio.
- Tu ID de medición de GA4 (empieza con
G-) si vas a agregar GA4 desde ahora. - Chrome y, para que la vista previa conecte sin problemas, la extensión de Tag Assistant.
Revisa dos cosas primero.
¿Ya existe un contenedor? Abre tu sitio, haz clic derecho y elige Ver código fuente de la página. Busca googletagmanager.com/gtm.js. Si encuentras un ID de GTM, averigua de quién es antes de agregar otro. Dos contenedores casi siempre significan medición duplicada.
¿GA4 está escrito a mano en el código? Busca gtag/js?id=G- en el código fuente. Si GA4 ya está instalado directo y lo vas a pasar a GTM, quitarás el código anterior en el paso 3.
Respalda tu tema o copia el código actual del encabezado en un archivo de texto antes de editar.
Paso 1: Crea la cuenta y el contenedor
Entra a tagmanager.google.com y haz clic en Crear cuenta. Completa:
- Nombre de la cuenta: el nombre de tu empresa.
- País.
- Nombre del contenedor: normalmente tu dominio, como
example.com. - Plataforma de destino: elige Web.
Haz clic en Crear y acepta las condiciones. GTM abre el espacio de trabajo del contenedor nuevo y muestra el código de instalación.
- Web es la opción correcta para un sitio normal.
Si la cuenta ya existe, ábrela y haz clic en Crear contenedor.
Paso 2: Copia el código de instalación
El cuadro Instalar Google Tag Manager se abre al crear el contenedor. Para abrirlo después, haz clic en el ID del contenedor (algo como GTM-XXXXXXX) en la parte superior de la pestaña Espacio de trabajo. También está en la pestaña Administrar, en la opción Instalar Google Tag Manager.
- El fragmento principal. Carga el contenedor de forma asíncrona y va arriba en el
<head>. - El fragmento
<noscript>. Solo sirve para visitantes con JavaScript desactivado y va justo después de<body>.
Copia el código desde tu propio cuadro. El ID dentro de ambos fragmentos debe ser el de tu contenedor.
Paso 3: Instala los fragmentos en tu plataforma
La regla es la misma en todas partes: cada página recibe una vez el fragmento del head y una vez el del body. Así se ve en las plataformas más comunes.
Sitios a la medida o programados a mano
Edita la plantilla de encabezado compartida, no páginas sueltas:
<head>
<meta charset="utf-8">
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){ /* tu fragmento de GTM */ })(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
<!-- End Google Tag Manager -->
<title>Ejemplo</title>
...
</head>
<body>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
...
Si usas una plataforma de gestión de consentimiento (CMP) que debe fijar primero los valores predeterminados de Consent Mode, sigue sus instrucciones sobre el orden. Normalmente el script de la CMP o el comando de consentimiento predeterminado va justo antes del fragmento de GTM.
WordPress
Hay tres opciones comunes. Elige una, no varias.
- Un plugin de código para encabezado y pie (por ejemplo WPCode o similar). Pega el fragmento del head en la caja de encabezado y el noscript en la caja de «body».
- Site Kit by Google. Puede conectar Tag Manager y colocar el contenedor por ti.
- Un tema hijo. Agrega los fragmentos con los hooks
wp_headywp_body_openenfunctions.php. No edites elheader.phpdel tema padre, porque las actualizaciones lo sobrescriben.
add_action('wp_head', function () { ?>
<!-- fragmento head de GTM aquí -->
<?php }, 1);
add_action('wp_body_open', function () { ?>
<!-- fragmento noscript de GTM aquí -->
<?php });
Al terminar, limpia la caché de tu plugin de caché y de tu CDN. Las páginas en caché pueden seguir sirviendo el HTML viejo sin GTM.
Shopify
Shopify tiene dos zonas que se comportan distinto.
- Páginas de la tienda (inicio, colecciones, productos, carrito): agrega los fragmentos al archivo
theme.liquidde tu tema. Abre Tienda online > Temas, haz clic en los tres puntos > Editar código y pega el fragmento del head justo después de<head>y el noscript después de<body>. Duplica el tema antes. - Pago y página de agradecimiento: ahí no corre el código del tema. Shopify usa Eventos del cliente (píxeles personalizados) en Configuración para medir el checkout. Un contenedor de GTM cargado dentro de un píxel personalizado corre en un entorno aislado, así que la vista previa y muchos activadores integrados no funcionan como siempre.
Para Google Ads y GA4 en Shopify, muchos especialistas usan la app Google & YouTube para medir compras y dejan GTM para las demás etiquetas. Decídelo antes de instalar para no contar las compras dos veces.
Squarespace
Usa la Inyección de código. En las versiones actuales de Squarespace está en Sitio web > Páginas > Código personalizado > Inyección de código (en menús anteriores estaba en Configuración > Avanzado). No está disponible en todos los planes.
- El fragmento del head de GTM va en Encabezado.
Squarespace no ofrece un espacio justo después de <body>. No pegues el iframe noscript en la caja de Encabezado, porque un iframe dentro del <head> no es válido y puede romper el encabezado de la página. Omitir el noscript solo afecta a visitantes sin JavaScript. Squarespace también tiene un campo integrado para Google Analytics. Si cargas GA4 con GTM, deja ese campo vacío.
Quita los duplicados
Ahora elimina todo lo que pueda duplicar datos:
- Un fragmento viejo de
gtag.jsde GA4 escrito a mano, si GA4 ahora va a correr desde GTM. - Un plugin o ajuste de la plataforma que también agregue GA4 con el mismo ID.
- Un segundo contenedor de GTM que nadie usa.
Paso 4: Agrega tu primera etiqueta (etiqueta de Google para GA4)
En GTM, ve a Etiquetas > Nueva. Haz clic en Configuración de la etiqueta y elige Etiqueta de Google. Pega tu ID de medición de GA4 (G-XXXXXXXXXX) en ID de etiqueta.
En Activación, elige Inicialización - Todas las páginas. Así la etiqueta de Google se activa temprano, antes que casi todas las demás. Ponle un nombre claro, como «Etiqueta de Google - GA4», y haz clic en Guardar.
- Tu ID de medición de GA4, que encuentras en GA4 en Administrar > Flujos de datos.
- El activador integrado Inicialización - Todas las páginas.
Si tu sitio usa un aviso de consentimiento, asegúrate de que los valores predeterminados de Consent Mode se fijen antes de que se active esta etiqueta. Es una configuración aparte, pero pruébala en el siguiente paso.
Paso 5: Usa la vista previa y depura con Tag Assistant
Nada sale en vivo hasta que publiques. La vista previa te deja probar antes.
- En el espacio de trabajo de GTM, haz clic en Vista previa (arriba a la derecha). Tag Assistant se abre en una pestaña nueva.
- Escribe la URL de tu sitio y haz clic en Conectar. Tu sitio se abre en otra ventana.
- Un pequeño aviso en una esquina de tu sitio indica que Tag Assistant está Conectado.
- Regresa a la pestaña de Tag Assistant y haz clic en Continuar.
- Tu etiqueta de Google debe aparecer en Etiquetas activadas desde la primera página.
- Las etiquetas que esperan una acción concreta se quedan en Etiquetas no activadas hasta que esa acción ocurra.
Navega por tu sitio. Cada página y acción agrega eventos a la línea de la izquierda, como Contenedor cargado, DOM listo y Ventana cargada. Haz clic en un evento para ver qué etiquetas se activaron en ese momento.
Revisa la pestaña Consentimiento si usas Consent Mode. Muestra el estado predeterminado y el actualizado de ad_storage, analytics_storage, ad_user_data y ad_personalization.
Si necesitas probar en otro dispositivo o con un colega, usa Compartir en el menú de Tag Assistant para enviar un enlace de vista previa.
Paso 6: Publica y revisa el sitio en vivo
De regreso en GTM, haz clic en Enviar. Agrega un Nombre de la versión, como «Instalación GTM + etiqueta de Google GA4», y una descripción corta. Haz clic en Publicar.
Ahora revisa el sitio en vivo sin vista previa:
- Abre tagassistant.google.com, haz clic en Añadir dominio, escribe tu URL y conecta. Debe encontrar tu contenedor y tu etiqueta de Google.
- Abre el código fuente de la página y confirma que el fragmento de GTM aparece una sola vez.
- En Chrome DevTools, abre Network (Red), recarga y filtra por
gtm.js. Debes ver una sola solicitud con el ID de tu contenedor. - En GA4, abre Informes > Tiempo real y confirma que apareces como usuario activo.
Si GA4 sigue sin mostrar nada, nuestra guía para resolver problemas de GA4 con Tiempo real y DebugView revisa todas las causas.
¿Sigue sin funcionar? Causas comunes
| Síntoma | Causa probable | Solución |
|---|---|---|
| Tag Assistant dice que no encuentra el contenedor | Falta el fragmento, el ID está mal o la página sale de una caché vieja | Revisa el código fuente y el ID; limpia la caché del sitio y de la CDN |
| Tag Assistant no conecta en vista previa | Bloqueador de anuncios, manejo de ventanas o el parámetro de depuración rompe la página | Desactiva bloqueadores, instala la extensión de Tag Assistant o desmarca Incluir señal de depuración en la URL |
| El contenedor solo carga en algunas páginas | El fragmento está en una plantilla y no en el encabezado compartido | Muévelo a la plantilla global o a la inyección de todo el sitio |
| GA4 cuenta las vistas de página dos veces | GA4 escrito a mano y también en GTM, o dos contenedores | Deja una sola fuente de GA4 y quita la otra |
| Funciona en vista previa, no en vivo | Nunca se publicaron los cambios o es otro entorno | Haz clic en Enviar > Publicar; revisa en Versiones cuál está en vivo |
gtm.js bloqueado en la consola |
La Content Security Policy no permite googletagmanager.com | Agrega GTM y los dominios de Google a la lista permitida de la CSP |
| No se miden compras de Shopify con GTM | El checkout no ejecuta el código del tema | Usa la app Google & YouTube o un píxel personalizado en Eventos del cliente |
| La parte superior de la página se ve rota | El iframe noscript se pegó dentro del head | Muévelo después de <body> u omítelo si la plataforma no tiene ese espacio |
| Las etiquetas se activan antes del consentimiento | GTM carga antes de fijar el consentimiento predeterminado | Carga la CMP o los valores predeterminados antes de GTM y prueba en Consentimiento |
| Tag Assistant muestra dos contenedores | Sigue instalado un contenedor viejo de una agencia o un plugin | Confirma de quién es y quita el que no se usa |
Caché y constructores de páginas
Los plugins de caché y las CDN suelen seguir sirviendo el HTML de antes de GTM. Purga todo después de instalar. Algunos constructores de páginas también tienen su propio campo de «scripts del encabezado». Usa un solo lugar para el fragmento.
Configuraciones del lado del servidor y de primera parte
Si alguien configuró etiquetado del lado del servidor, el fragmento puede cargar desde tu propio dominio en lugar de googletagmanager.com. Está bien. Verifícalo igual con Tag Assistant y no agregues un segundo fragmento estándar junto a él.
Cómo confirmar que quedó resuelto
Terminaste cuando todo esto se cumple:
- El código fuente muestra un solo fragmento de GTM con tu ID en cada plantilla que revisaste (inicio, una entrada de blog, una página de producto o servicio, una página con formulario).
- Tag Assistant, conectado sin vista previa, encuentra el contenedor y la etiqueta de Google.
- En Versiones de GTM, tu versión publicada aparece como En vivo.
- Tiempo real de GA4 muestra tu visita en uno o dos minutos.
- No hay eventos de vista de página duplicados en DebugView ni en Tiempo real de GA4.
Vuelve a revisar después de cualquier actualización de tema o rediseño. Los cambios de tema son la forma más común en que GTM desaparece.
Con el contenedor en su lugar, ya puedes agregar más etiquetas. Lo que suele seguir: configurar Consent Mode v2 en GTM y medir envíos de formularios.
Preguntas frecuentes
¿Necesito el fragmento noscript?
Solo funciona para visitantes con JavaScript desactivado, que son pocos. La mayoría de las etiquetas de JavaScript, incluida GA4, no corren ahí de todos modos. Agrégalo donde tu plataforma lo permita y omítelo donde quedaría dentro del <head>.
¿Puedo usar GTM y gtag.js al mismo tiempo?
Sí, pero no envíes los mismos datos de GA4 desde los dos. Elige un solo lugar para cada etiqueta. Los duplicados son la razón más común de vistas de página dobles.
¿GTM hace más lento mi sitio?
El contenedor carga de forma asíncrona, así que por sí solo no bloquea la página. Lo que pongas dentro sí puede hacerlo. Quita las etiquetas que no uses y revisa las Core Web Vitals después de cambios grandes.
¿Quién debe ser dueño de la cuenta de GTM?
El negocio. Créala con una cuenta de Google de la empresa y da acceso de usuario a agencias o freelancers. Así nunca pierdes el acceso cuando cambia el equipo.
¿Todavía necesito Tag Assistant Companion?
Google integró Companion en la extensión principal de Tag Assistant. Instala la extensión actual de Tag Assistant para que la vista previa conecte sin problemas.
¿Te atoraste con esto? Lo resolvemos para clientes cada semana. Agenda una auditoría gratis
