Integración con Google Tag Manager
Agrega tu ID de contenedor de GTM a docs.json para cargar Google Tag Manager en cada página. Gestiona etiquetas de analítica desde GTM.
Agrega tu ID de contenedor de GTM a docs.json para cargar Google Tag Manager en cada página de tu sitio de documentación. A partir de ahí, tu equipo de marketing puede configurar analítica, píxeles de conversión y seguimiento de eventos completamente desde GTM.
Los ID de contenedor de GTM comienzan con GTM-. Si solo necesitas Google Analytics, consulta Integración con Google Analytics para una configuración más simple.
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 - Deja que el equipo de marketing agregue etiquetas sin ayuda de desarrollo
- Triggers avanzados - Rastrear clics en botones, envíos de formularios, visualizaciones de video
- Integración con pruebas A/B - Conectar herramientas como Google Optimize
Para analítica básica únicamente, agregar GA4 directamente es más simple.
Obtener tu ID de contenedor
- Ve a Google Tag Manager
- Selecciona tu cuenta y contenedor (o crea unos nuevos)
- Copia el Container ID (ID de contenedor) en la parte superior de la página (comienza con
GTM-)
Agregar GTM a tus documentos
Agrega 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.
Consentimiento de cookies
Eres responsable de configurar los banners de consentimiento de cookies si los necesitas. Jamdesk carga tu contenedor de GTM en cada página, así que cualquier etiqueta que configures se activa para todos los visitantes. Si tus lectores están sujetos a GDPR, CCPA o regulaciones similares, configura el modo de consentimiento en GTM o usa una plataforma de gestión de consentimiento. Jamdesk también puede restringir GTM mismo detrás del consentimiento. Consulta Consentimiento de cookies.
Configurar GA4 a través de GTM
Si deseas usar GA4 a través de GTM en lugar de agregarlo directamente:
- En GTM, ve a Tags → New
- Elige Google Analytics: GA4 Configuration
- Ingresa tu ID de medición de GA4 (comienza con
G-) - Configura el trigger en All Pages
- Publica tu contenedor
Si configuras GA4 a través de GTM, no lo agregues también directamente en docs.json. Esto causa seguimiento duplicado.
Verificar la instalación
Usando el modo Preview de GTM
- En GTM, haz clic en Preview en la esquina superior derecha
- Ingresa 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 realizándose
Etiquetas comunes de GTM 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 el uso de la búsqueda
Rastrea cuando los usuarios interactúan con la función de búsqueda:
- Tag: Google Analytics: GA4 Event
- Event Name:
search - Trigger: Custom event que coincida con tu interacción de búsqueda
Rastrear el tiempo en la página
Comprende cuánto tiempo pasan los usuarios leyendo:
- Tag: Google Analytics: GA4 Event
- Event Name:
timing - Trigger: Timer trigger (por ejemplo, cada 30 segundos)
Solución de problemas
- Verifica el Container ID - 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 en ambos:
- Directamente en
docs.json(integrations.ga4) - A través de GTM como una etiqueta GA4
Obtendrás vistas de página duplicadas. Elimina uno de ellos.
