Conectar Google Analytics 4 o Matomo

Cómo conectar GA4 (OAuth de Google) o Matomo (URL + token de autenticación) a un proyecto y leer el dashboard de analytics — interruptores de las tarjetas de métricas, KPI secundarios, interruptor Orgánico/Todo, pestañas Diario/Landing/Conversiones y desglose por Canal/País/Dispositivo/Navegador.

Conectar un proveedor de analytics es opcional pero muy útil: aporta tráfico real (sesiones, usuarios, engagement, conversiones) junto a los datos de ranking. Puedes conectar Google Analytics 4 o Matomo — o ambos: cada uno tiene su propio dashboard dedicado en el grupo Analytics del menú lateral.

Ambas conexiones se gestionan desde Configuración → General, en la fila 2 de la rejilla (las tarjetas 📊 Google Analytics 4 y 📈 Matomo).

Conectar Google Analytics 4

  1. Abre el proyecto → Configuración → General.

  2. En la tarjeta 📊 Google Analytics 4 haz clic en Conectar Google Analytics 4.

    La tarjeta Google Analytics 4 en Configuración → General, antes de conectar, con el botón Conectar Google Analytics 4 resaltado

  3. Se te redirige a Google: elige la cuenta con acceso a la propiedad GA4 y concede los permisos (solo lectura: Miraqo no escribe nada en Analytics).

  4. Vuelves a Miraqo. Si tu propiedad GA4 coincide de forma única con el dominio del proyecto, se selecciona automáticamente. En caso contrario aparece el estado ⚠️ “GA4 autenticado — selecciona una propiedad” con el desplegable Propiedad GA4 utilizada para elegirla manualmente: selecciónala y haz clic en Guardar.

    Las tarjetas Google Analytics 4 y Matomo tras la autenticación, a la espera de la elección: el desplegable Propiedad GA4 utilizada con el botón Guardar está resaltado

  5. Con la conexión completada, la tarjeta muestra ✅ GA4 conectado con el nombre de la propiedad, la fecha de la última sincronización y los botones Configuración avanzada y Desconectar.

    La tarjeta GA4 conectada: estado verde con el nombre de la propiedad, botones Configuración avanzada y Desconectar, desplegable de la propiedad y fecha de la última sincronización

  6. Haz clic en Configuración avanzada en la tarjeta para abrir la página de ajuste fino (opcional):

    • Conversiones — no hay que configurar nada: Miraqo lee los Eventos clave nativos de la propiedad, la misma métrica de la columna “Conversiones” de GA4. Decides qué eventos cuentan directamente en GA4 (Administración → Eventos clave).
    • Filtros de nombre de host / prefijo de ruta — útiles cuando la misma propiedad GA4 rastrea varios sitios o secciones y quieres aislar solo las páginas de este proyecto.

    La página Configuración de Google Analytics 4: el recuadro Conversiones explica que se usan los Eventos clave nativos, debajo los Filtros opcionales Nombre de host y Prefijo de ruta con los botones Cancelar y Guardar

Cambiar de propiedad tras conectar. Desde la tarjeta GA4 en Configuración, si tienes varias propiedades disponibles en la cuenta, puedes cambiar la propiedad desde el desplegable sin volver a conectar.

Conectar Matomo

  1. Abre el proyecto → Configuración → General.
  2. En la tarjeta 📈 Matomo haz clic en Conectar Matomo →.
  3. Introduce la URL de Matomo — URL base, sin /index.php al final (p. ej. https://analytics.mysite.com).
  4. Introduce el token de autenticación (token_auth). Lo encuentras en Matomo → Personal → Seguridad → Auth tokens; necesitas permisos de solo lectura en el sitio.
  5. Haz clic en Probar conexión: si las credenciales son válidas, aparece la lista de sitios. Selecciona el sitio (idSite) a monitorizar.
  6. Las conversiones se detectan automáticamente: en los sitios con e-commerce de Matomo activo cuentan los pedidos completados, si no todos los objetivos (Goals) configurados. La atribución de conversión por página de aterrizaje individual no está disponible en Matomo (las conversiones totales siguen siendo correctas y visibles en las tarjetas y en la pestaña Conversiones).
  7. (Opcional) Filtros de Nombre de host / Prefijo de ruta como en GA4.
  8. Guardar.

El formulario Configurar Matomo: campos URL Matomo y Auth token, botón Test de conexión resaltado, debajo la elección del sitio y los Filtros opcionales

Desde la tarjeta Matomo en Configuración también puedes hacer clic en Editar URL/token para cambiar las credenciales sin desconectar, y cambiar el sitio desde el desplegable si la instancia expone más de uno.

Las tarjetas Google Analytics 4 y Matomo, ambas conectadas, en Configuración → General: en la tarjeta Matomo el botón Editar URL/token resaltado, debajo el desplegable Sitio Matomo utilizado con Guardar y la fecha de la última sincronización

El dashboard de Analytics (GA4 o Matomo)

GA4 y Matomo usan la misma página de dashboard, con el mismo diseño: solo cambia la etiqueta del proveedor arriba (y algunos datos derivados de las diferencias entre ambas plataformas).

Cabecera y acciones

  • Título “Google Analytics 4” / “Matomo” + dominio del proyecto
  • 🔄 Sincronizar — fuerza una actualización de datos (para roles con permiso de sincronización)
  • Interruptor Orgánico / Todo — filtra las tarjetas de métricas y el gráfico entre tráfico solo orgánico (SEO) y todo el tráfico. La tabla de landing pages siempre muestra tráfico orgánico, independientemente del interruptor.
  • Selector de Periodo (7 / 28 / 90 días)

Estados previos a los datos

  • No conectado — estado vacío con enlace a Configuración
  • Conexión incompleta — falta URL/token (Matomo) o autorización/propiedad (GA4)
  • Backfill en curso — overlay de reloj de arena “Preparando datos…” que bloquea el gráfico hasta que se completa el histórico asíncrono (la página se actualiza sola mediante sondeo, puede tardar 1-2 minutos)

El dashboard de Google Analytics 4 justo después de conectar: arriba a la derecha Sincronizar, el interruptor Orgánico/Todo y los chips 7d, 28d, 90d resaltados; en el centro la superposición con el reloj de arena «Preparando datos…»

Las 4 tarjetas de métricas (interruptores del gráfico)

Encima del gráfico, 4 tarjetas clicables que activan/desactivan la serie correspondiente:

  • Sesiones (✓ activa por defecto) — sesiones en el periodo
  • Usuarios (✓ activa por defecto) — usuarios únicos en el periodo. El símbolo ✦ junto al número indica que el proveedor devuelve el valor ya deduplicado para el periodo (sin aproximación)
  • Conversiones (desactivada) — eventos clave configurados (GA4) o cumplimiento del objetivo vinculado (Matomo)
  • Tasa de engagement (desactivada) — % de sesiones “comprometidas” (con tiempo de permanencia, conversión o más páginas vistas). La variación se expresa en pp (puntos porcentuales)

Cada tarjeta muestra el valor total + la variación respecto al periodo anterior de igual duración.

Las cuatro tarjetas de métricas resaltadas encima del gráfico: Sesiones y Usuarios activadas, Conversiones y Tasa de engagement desactivadas; debajo, el gráfico diario con el eje de las sesiones a la izquierda y el de los usuarios a la derecha

KPI secundarios (7 tarjetas)

Debajo del gráfico, una rejilla de tarjetas de estadísticas:

  • Vistas — páginas vistas totales
  • Usuarios nuevos
  • Usuarios recurrentes
  • Tasa de rebote — % de sesiones no comprometidas (inverso del engagement)
  • Tasa de conversión — conversiones / sesiones
  • Tiempo medio de engagement — segundos
  • Valor de conversión — valor monetario en la moneda de la propiedad (ingresos totales en GA4, valor del objetivo en Matomo)

La rejilla de los siete KPI secundarios resaltada: Visualizaciones, Nuevos usuarios, Usuarios recurrentes, Tasa de rebote, Tasa de conversión, Tiempo medio de engagement y Valor de conversiones

Pestañas

Debajo de los KPI, pestañas para explorar los datos. Tablas ordenables al hacer clic en el encabezado.

La barra de pestañas resaltada: Tendencia diaria, Landing page, Conversiones, Canal, País, Dispositivo y Navegador; debajo, la tabla de la tendencia con Fecha, Sesiones, Usuarios, Conversiones y Engagement

📈 Tendencia diaria

Una fila por día: Sesiones · Usuarios · Conversiones · Engagement %.

📄 Landing page

Las páginas de entrada más visitadas desde tráfico orgánico (la pestaña no respeta el interruptor Todo/Orgánico). Ordenable por Sesiones / Usuarios / Engagement % / Conversiones.

🎯 Conversiones

Conversiones totales, valor económico y tasa de conversión del periodo.

Desglose — Canal / País / Dispositivo / Navegador

Pestañas adicionales (iconos arriba), una por dimensión. El histórico del desglose se rellena a partir de la primera sincronización diaria tras la conexión: no hay backfill retroactivo para estas dimensiones, así que los datos empiezan desde la fecha de conexión (es normal que estén vacías el primer día).

Sincronización

  • Backfill inicial automático — nada más conectar, Miraqo importa los últimos 90 días en segundo plano. En proyectos grandes puede tardar unos minutos. Durante el backfill, el dashboard muestra el overlay de reloj de arena descrito arriba.
  • Sincronización diaria — automática, se actualiza con una ventana que recupera los datos que los proveedores consolidan con retraso.
  • Sincronizar — botón manual en la cabecera para forzar una actualización.

Desconexión

Configuración → General → botón Desconectar en la tarjeta GA4 o Matomo (con confirmación). El histórico ya importado sigue visible en el dashboard, pero no recibirás nuevas actualizaciones hasta que vuelvas a conectar.

Para GA4 también puedes revocar el acceso desde el lado de Google: Cuenta de Google → Seguridad → Apps de terceros. Tras la revocación, la próxima sincronización fallará con un error de autorización: vuelve a Configuración y reconecta.

Errores habituales

  • “GA4 autenticado — selecciona una propiedad” no se completa — concediste acceso pero aún no has elegido la propiedad en el desplegable. Vuelve a Configuración y selecciónala.
  • Matomo: “Probar conexión” falla — comprueba que la URL sea la base (sin /index.php) y que el token de autenticación tenga permisos de lectura en el sitio.
  • No aparece ninguna propiedad/sitio en la lista — la cuenta de Google o el token de autenticación usados no tienen acceso a ninguna propiedad GA4 / sitio Matomo. Usa credenciales con los permisos correctos.
  • Conversiones en cero — en GA4 la propiedad no tiene Eventos clave configurados (se configuran en GA4, Administración → Eventos clave); en Matomo no hay Goals ni e-commerce activo.
  • Desgloses vacíos justo después de conectar — normal, se rellenan a partir de la próxima sincronización diaria (sin backfill retroactivo para las dimensiones).
  • Dashboard atascado en “Preparando datos…” durante más de 5 minutos — falló una sincronización de backfill. Desconecta y reconecta, o contacta con soporte.

Qué cambia en otros sitios tras conectar

  • Resumen del proyecto — el widget de Analytics muestra una tarjeta resumen para cada proveedor conectado, con un gráfico de sesiones/día
  • Keywords del proyecto — las columnas Sesiones y Tasa de conv. aparecen en la tabla de Detalle de keyword, asociadas a la landing page principal de cada keyword
  • Dashboard de triage — la tendencia de clics de GSC sigue siendo la principal, pero los datos de analytics enriquecen los informes

Próximos pasos:

Última actualización: 5 de septiembre de 2026