Datos de GA4 y Yandex Metrika

Lee las vistas de página y el tráfico de GA4 y Yandex Metrika, y cruza esos datos con las incidencias del rastreo para arreglar las páginas que la gente realmente visita. Las dos conexiones son de solo lectura.

Qué hace

Yandex Metrika

metrika-counters encuentra el ID del contador. metrika-setup muestra sus objetivos, filtros y operaciones de datos, que conviene leer antes de sacar conclusiones. Después, metrika-report extrae las métricas y dimensiones que pidas, con paginación automática.

  • El acceso es un token OAuth de Yandex en YANDEX_METRIKA_TOKEN o en su archivo de token.
  • metrika-traffic-pdf genera un informe de tráfico A4 en HTML y PDF. El PDF requiere Chrome, Edge o Chromium locales.
  • Los logs sin procesar se excluyen a propósito, porque contienen identificadores de visitantes.

Google Analytics 4

GA4 no tiene un comando de CLI propio. Se recoge con provider-collect, usando la operación page_views para las páginas visitadas o landing_pages para las páginas de aterrizaje. page_views cuenta screenPageViews por fecha, host y ruta para la propiedad que indiques.

  • El acceso es un token de acceso de GA4 (GA4_ACCESS_TOKEN) o una cuenta de servicio de Google con el ámbito analytics.readonly.
  • La cuenta necesita acceso de lectura a la propiedad.
  • Las filas sin procesar van a una carpeta privada de artefactos locales, no a la respuesta de la herramienta.

Cruce con el rastreo

crawl-enrich cruza un CSV de tráfico con URL como clave con las URL rastreadas y añade hallazgos de analítica, usando las columnas de visitas y de tasa de rebote que indiques. Con un proyecto, sources-sync guarda el histórico diario en un archivo SQLite local, y sf run lo cruza con las páginas de la auditoría sin conexión.

  • Los hallazgos de páginas huérfanas, sin datos y no indexables con tráfico salen del cruce.
  • Las URL coincidentes, las que solo están en el rastreo y las que solo están fuera se mantienen como poblaciones separadas.
  • Nunca se suman las cifras de GA4 y Metrika.

Tres pasos, un análisis guardado

  1. Comprueba antes la configuración de contadores

    Ejecuta metrika-counters para encontrar el ID del contador y luego metrika-setup para ver sus objetivos, filtros y operaciones de datos.

  2. Extrae visitas y vistas de página

    metrika-report lee Yandex Metrika con las métricas y dimensiones que quieras. Las vistas de página de GA4 llegan desde provider-collect con la operación page_views de ga4.

  3. Cruza las cifras con el rastreo

    crawl-enrich cruza el CSV de tráfico con las URL rastreadas por URL y añade hallazgos de analítica, incluidas las columnas de visitas y de tasa de rebote.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
GA_ORPHAN_URLLos datos de analítica citan una URL del mismo origen que el rastreo no encontróImportantLista de URL del cruce. No se muestra en un rastreo parcial
NON_INDEXABLE_WITH_GA_DATAUna página no indexable sigue recibiendo visitas por encima de ceroImportantURL y número de visitas de --visits-column
NO_GA_DATAUna página rastreada e indexable no tiene ninguna fila de analíticaTipLista de URL. Revisa el periodo medido y el etiquetado de analítica antes de actuar
BOUNCE_RATE_ABOVE_70La tasa de rebote de la página supera el 70 %TipURL y tasa de rebote de --bounce-column

Un solo comando

bash
seohead metrika-report --counter 12345678 --date1 2026-09-01 --date2 2026-09-30

Primero, instala SpiderHead: guía de instalación. Cada comando también funciona como herramienta MCP para agentes de IA.

Qué necesitas

  • Yandex Metrika: un ID de contador y un token OAuth
  • GA4: un ID de propiedad y un token de acceso o una cuenta de servicio con analytics.readonly
  • Un intervalo de fechas
  • Un rastreo o una auditoría, más un CSV de tráfico si usas crawl-enrich

Límites

  • Las vistas de página de GA4 no son sesiones, usuarios ni sesiones de páginas de aterrizaje, y no son prueba de que un cambio causara el tráfico.
  • La recogida de GA4 devuelve como máximo 100 000 filas por ejecución. Los datos con umbral o muestreados se marcan.
  • Las visitas a cero pueden venir del etiquetado o de los filtros, así que revisa antes metrika-setup.
  • Las filas que faltan no son ceros medidos. Un hallazgo negativo requiere un rastreo completo y una cobertura completa del proveedor.

Preguntas

¿Cambia mi sitio o mis ajustes de analítica?
No. Cada llamada es de solo lectura. metrika-setup solo muestra cómo está configurado un contador. Las evidencias guardadas se quedan en una carpeta local.
¿Qué acceso necesito?
Para Metrika, un token OAuth de Yandex en el ajuste YANDEX_METRIKA_TOKEN o en su archivo de token. Para GA4, un GA4_ACCESS_TOKEN o una cuenta de servicio con el ámbito analytics.readonly y acceso de lectura a la propiedad.
¿Por qué una página con cero visitas no siempre es un problema?
El cero puede venir de la configuración. Sin objetivos ni filtros configurados, las cifras pueden estar incompletas. Revisa metrika-setup antes de sacar conclusiones del tráfico.
¿Lee logs de visitantes sin procesar?
No. Los logs sin procesar de Metrika se excluyen por diseño porque contienen identificadores de visitantes. La herramienta usa solo informes agregados.
¿Cuánto cuesta?
SpiderHead no cobra nada por estos comandos. Las llamadas cuentan contra las cuotas de API de tu propia cuenta de Metrika y de GA4.
¿Qué se guarda en mi equipo?
Las filas sin procesar de GA4 van a una carpeta privada de artefactos que eliges tú. sources-sync escribe el histórico diario en un archivo SQLite del proyecto sin guardar tokens. metrika-report muestra su resultado; guárdalo tú si lo necesitas.

Pruébalo en tu propio sitio