Integración con Google Tag Manager
Añade tu ID de contenedor GTM a docs.json para cargar Google Tag Manager en cada página. Gestiona etiquetas de analítica y seguimiento desde GTM.
Añade tu ID de contenedor GTM a docs.json para cargar Google Tag Manager en cada página de tu sitio de documentación. Desde allí, tu equipo de marketing puede configurar analítica, píxeles de conversión y seguimiento de eventos completamente dentro de GTM.
Los IDs de contenedor GTM comienzan con GTM-. Si solo necesitas Google Analytics, consulta la Integración con Google Analytics para una configuración más sencilla.
Cuándo usar GTM
Usa Google Tag Manager cuando necesites:
- Múltiples herramientas de seguimiento - GA4, Facebook Pixel, LinkedIn, etc.
- Control del equipo de marketing - Permite a los marketers añadir etiquetas sin ayuda de desarrolladores
- Disparadores avanzados - Rastrea clics en botones, envíos de formularios, reproducciones de vídeo
- Integración de pruebas A/B - Conecta herramientas como Google Optimize
Para analítica básica únicamente, añadir GA4 directamente es más sencillo.
Cómo obtener tu ID de contenedor
- Ve a Google Tag Manager
- Selecciona tu cuenta y contenedor (o crea nuevos)
- Copia el ID de contenedor de la parte superior de la página (comienza con
GTM-)
Añadir GTM a tu documentación
Añade el ID de contenedor a tu docs.json:
{
"name": "My Docs",
"integrations": {
"gtm": {
"tagId": "GTM-XXXXXXX"
}
}
}
Reemplaza GTM-XXXXXXX con tu ID de contenedor real.
Configurar GA4 a través de GTM
Si quieres usar GA4 a través de GTM en lugar de añadirlo directamente:
- En GTM, ve a Tags → New
- Elige Google Analytics: GA4 Configuration
- Introduce tu ID de medición de GA4 (comienza con
G-) - Establece el disparador en All Pages
- Publica tu contenedor
Si configuras GA4 a través de GTM, no lo añadas también directamente en docs.json. Esto provoca un seguimiento duplicado.
Verificar la instalación
Usando el modo preview de GTM
- En GTM, haz clic en Preview en la esquina superior derecha
- Introduce la URL de tu sitio de documentación
- Una ventana de depuración muestra qué etiquetas se activan en cada página
Usando las herramientas de desarrollador del navegador
- Abre tu sitio con las Herramientas de desarrollador (F12)
- Ve a la pestaña Network
- Filtra por
gtm.jsogoogletagmanager - Deberías ver solicitudes siendo realizadas
Etiquetas GTM comunes para documentación
Rastrear enlaces salientes
Crea una etiqueta para rastrear cuando los usuarios hacen clic en enlaces externos:
- Tag: Google Analytics: GA4 Event
- Event Name:
click - Trigger: Click - Just Links, donde Click URL no contiene tu dominio
Rastrear uso de búsqueda
Rastrea cuando los usuarios interactúan con la función de búsqueda:
- Tag: Google Analytics: GA4 Event
- Event Name:
search - Trigger: Evento personalizado que coincida con tu interacción de búsqueda
Rastrear tiempo en página
Comprende cuánto tiempo pasan los usuarios leyendo:
- Tag: Google Analytics: GA4 Event
- Event Name:
timing - Trigger: Disparador de temporizador (por ejemplo, cada 30 segundos)
Solución de problemas
- Verifica el ID de contenedor - Debe comenzar con
GTM- - Publica tu contenedor - Los cambios sin publicar no aparecerán en tu sitio
- Usa el modo preview - El preview de GTM muestra qué etiquetas se activan en cada página
Si tienes GA4 configurado tanto:
- Directamente en
docs.json(integrations.ga4) - A través de GTM como una etiqueta GA4
Obtendrás vistas de página duplicadas. Elimina una de ellas.
