Integración con Google Analytics
Añade Google Analytics 4 a tu sitio de documentación con un ID de medición para rastrear visitantes y entender el engagement con el contenido.
Añade Google Analytics 4 a tu sitio de documentación para entender cómo interactúan los usuarios con tu contenido.
La integración con Google Analytics funciona con IDs de medición de GA4 (Google Analytics 4) que empiezan con G-.
Obtener tu ID de medición
- Ve a Google Analytics
- Selecciona tu propiedad (o crea una)
- Ve a Admin → Data Streams
- Selecciona tu flujo web (o crea uno)
- Copia el Measurement ID (empieza con
G-)
Añadir GA4 a tus docs
Añade el ID de medición a tu docs.json:
{
"name": "My Docs",
"integrations": {
"ga4": {
"measurementId": "G-XXXXXXXXXX"
}
}
}Reemplaza G-XXXXXXXXXX con tu ID de medición real.
Ver tus datos
Después de añadir la integración:
- Activa un rebuild de tus docs
- Visita tu sitio de documentación en vivo
- En Google Analytics, ve a Reports → Real-time
- Deberías ver tu visita aparecer en menos de 30 segundos
Puede tardar entre 24 y 48 horas en que los datos aparezcan en los informes estándar. Usa los informes en tiempo real para una verificación inmediata.
Uso con Google Tag Manager
Si ya usas Google Tag Manager, puedes configurar GA4 a través de GTM en lugar de añadirlo directamente. Consulta Integración con Google Tag Manager para más detalles.
Eres responsable de configurar los banners de consentimiento de cookies para cualquier etiqueta que cargues a través de Google Tag Manager si los necesitas. Jamdesk carga tu contenedor de GTM para todos los visitantes sin una puerta de consentimiento. Consulta Consentimiento de cookies para restringir la analítica hasta que los visitantes acepten.
No añadas la misma propiedad de GA4 tanto directamente en docs.json como a través de Google Tag Manager, ya que esto causará un seguimiento duplicado.
Consideraciones de privacidad
Google Analytics recopila datos de los visitantes. Considera:
- Añadir un banner de consentimiento de cookies si aplica el RGPD/CCPA. Jamdesk carga GA4 para todos los visitantes por defecto, así que usa Consentimiento de cookies para restringirlo hasta que acepten.
- Actualizar tu política de privacidad para mencionar la analítica
- Usar anonimización de IP si es necesario
Solución de problemas
- Verifica tu ID de medición - Debe empezar con
G- - Comprueba si hay bloqueadores de anuncios - Pueden bloquear los scripts de analítica
- Espera al rebuild - Los cambios requieren un nuevo build para surtir efecto
- Usa los informes en tiempo real - Los informes estándar tienen un retraso de 24-48 horas
El ID debe:
- Empezar con
G- - Contener solo letras y números después de
G- - Copiarse exactamente desde Google Analytics (sin espacios adicionales)
