Integración con Google Analytics

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 por G-.

Obtén 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 ID de medición (empieza por G-)

Añadir GA4 a tu documentación

Añade el ID de medición a tu docs.json:

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 tu documentación
Visita tu sitio de documentación en producción
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 estás usando Google Tag Manager, puedes configurar GA4 a través de GTM en lugar de añadirlo directamente. Consulta la integración con Google Tag Manager para más detalles.

No añadas la misma propiedad GA4 directamente en docs.json y también a través de Google Tag Manager — esto causará un seguimiento duplicado.

Consideraciones de privacidad

Google Analytics recopila datos de los visitantes. Ten en cuenta:

Añadir un banner de consentimiento de cookies si lo exige GDPR/CCPA
Actualizar tu política de privacidad para mencionar el análisis de datos
Usar la anonimización de IP si es necesario

Solución de problemas

Verifica tu ID de medición - Debe empezar por G-
Comprueba los bloqueadores de anuncios - Pueden bloquear los scripts de análisis
Espera al rebuild - Los cambios requieren un nuevo build para tener efecto
Usa los informes en tiempo real - Los informes estándar tienen un retraso de 24 a 48 horas

El ID debe:

Empezar por G-
Contener solo letras y números después de G-
Ser copiado exactamente desde Google Analytics (sin espacios adicionales)