Configuración de Google Analytics 4 por equipo para mostrar en el dashboard un gráfico de visitas y páginas vistas de los últimos 7 días.

1. Qué necesitas tener

• Una propiedad de Google Analytics 4 (GA4) con datos de tu sitio.
• El ID de propiedad (Property ID): número numérico, no el ID de medición G- ni el ID del flujo.
• Un archivo JSON de credenciales de una cuenta de servicio creada en Google Cloud, con la API de Google Analytics Data habilitada.
• El email de esa cuenta de servicio añadido en GA4 con rol Analista.

2. Dónde encontrar el ID de propiedad correcto

En GA4 existen varios identificadores. Para Humano debes usar solo uno:

Nombre en GA4	Formato	¿Usar en Humano?
ID de medición (Measurement ID)	G-XXXXXXXXXX	No — Se usa en el código del sitio para enviar datos.
ID del flujo (Stream ID)	Número (ej. 2396611762)	No — Es del flujo de datos, no de la propiedad.
ID de propiedad (Property ID)	Número (ej. 267096786)	Sí

Cómo obtener el ID de propiedad:

1. En analytics.google.com entra a tu propiedad.
2. Menú inferior izquierdo → Administrar (icono de engranaje).
3. Columna central → Configuración de la propiedad (Property settings).
4. Arriba verás ID de propiedad: un número como 267096786. Ese valor es el que debes pegar en Humano.

3. Crear la cuenta de servicio y obtener el JSON

El JSON no se genera en Google Analytics; se crea en Google Cloud.

1. Ir a Google Cloud
   console.cloud.google.com (misma cuenta de Google que GA4).
2. Proyecto
   Selecciona un proyecto existente o crea uno nuevo (nombre ej. "Humano Analytics").
3. Activar la API
   Menú → API y servicios → Biblioteca → buscar Google Analytics Data API → Habilitar.
4. Crear cuenta de servicio
   Menú → API y servicios → Credenciales → Crear credenciales → Cuenta de servicio. Nombre ej. "Humano Analytics" → Crear y continuar → Listo.
5. Crear clave JSON
   En la tabla, entra en la cuenta de servicio recién creada → pestaña Claves → Añadir clave → Crear clave nueva → tipo JSON → Crear. Se descargará un archivo .json.
6. Pegar el JSON en Humano
   Abre el archivo con un editor de texto, copia todo el contenido (desde { hasta }) y pégalo en Team Settings → Google Analytics → Service account credentials (JSON).

4. Dar acceso a la cuenta de servicio en GA4

Sin este paso, la API no podrá leer los datos de tu propiedad.

1. En GA4 → Administrar → Configuración de la propiedad → Acceso a la propiedad (Property Access Management).
2. Botón + → Añadir usuarios.
3. En "Dirección de correo electrónico" pega el email de la cuenta de servicio. Aparece en el JSON en "client_email" (ej. nombre@proyecto.iam.gserviceaccount.com).
4. En "Roles directos" selecciona Analista (Analyst). Con eso puede leer los datos; no hace falta Administrador ni Editor.
5. Pulsa Añadir.

5. Completar la configuración en Humano

1. Entra en Configuración del equipo (por ejemplo /team/<id>/settings).
2. Tarjeta Google Analytics → Configure.
3. GA4 Property ID: pega solo el número (ej. 267096786).
4. Service account credentials (JSON): pega el contenido completo del archivo JSON descargado.
5. Guardar cambios.

Si todo está correcto, al abrir el dashboard verás el bloque Google Analytics con un gráfico de visitas y páginas vistas de los últimos 7 días. Si no hay configuración válida, el bloque no se muestra.

6. Resolución de problemas

• No aparece el gráfico: Comprueba que usaste el ID de propiedad (Admin → Configuración de la propiedad), no el ID del flujo ni G-. Que el JSON esté completo y pegado sin cortes. Que el email de la cuenta de servicio esté en Acceso a la propiedad con rol Analista.
• Error de credenciales: Verifica que en Google Cloud esté habilitada la Google Analytics Data API y que el JSON corresponda al mismo proyecto.
• Sin datos en el gráfico: La propiedad debe tener tráfico reciente. El gráfico muestra los últimos 7 días; si no hay datos en ese periodo, las barras saldrán a cero.

---

Esta funcionalidad utiliza el paquete spatie/laravel-analytics y la Google Analytics Data API.