Integración de Google Analytics

Añade Google Analytics 4 a tu sitio de documentación para comprender cómo los usuarios interactúan con tu contenido.

La integración de Google Analytics funciona con IDs de medición de GA4 (Google Analytics 4) que comienzan con G-.

Obtener tu ID de medición

Ve a Google Analytics
Selecciona tu propiedad (o crea una)
Ve a Administrar → Flujos de datos
Selecciona tu flujo web (o crea uno)
Copia el ID de medición (comienza 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 producción
En Google Analytics, ve a Informes → Tiempo real
Deberías ver tu visita aparecer en menos de 30 segundos

Los datos pueden tardar entre 24 y 48 horas en aparecer en los informes estándar. Usa los informes en tiempo real para 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 de Google Tag Manager para más detalles.

No añadas la misma propiedad de 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 así lo requiere el RGPD/CCPA
Actualizar tu política de privacidad para mencionar el uso de analítica
Usar la anonimización de IP si es necesario

Solución de problemas

Verifica tu ID de medición — debe comenzar con G-
Comprueba si hay bloqueadores de anuncios — pueden bloquear los scripts de analítica
Espera el 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:

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