Dati GA4 e Yandex Metrika

Leggi visualizzazioni di pagina e traffico da GA4 e Yandex Metrika, poi uniscili alle segnalazioni della scansione per correggere le pagine che la gente visita davvero. Entrambe le connessioni sono in sola lettura.

Cosa fa

Yandex Metrika

metrika-counters trova l'ID del contatore. metrika-setup mostra i suoi obiettivi, i filtri e le operazioni sui dati, che conviene leggere prima di trarre conclusioni. metrika-report poi scarica le metriche e le dimensioni che chiedi, con paginazione automatica.

  • L'accesso è un token OAuth Yandex in YANDEX_METRIKA_TOKEN o nel suo file di token.
  • metrika-traffic-pdf costruisce un report del traffico in A4 come HTML e PDF. Il PDF richiede una Chrome, Edge o Chromium locale.
  • I log grezzi sono esclusi di proposito, perché contengono identificatori dei visitatori.

Google Analytics 4

GA4 non ha un comando CLI dedicato. Lo raccogli con provider-collect, usando l'operazione page_views per le pagine visitate o landing_pages per le pagine di ingresso. page_views conta screenPageViews per data, host e percorso di una proprietà che nomini.

  • L'accesso è un access token GA4 (GA4_ACCESS_TOKEN) o un service account Google con lo scope analytics.readonly.
  • L'account richiede accesso in lettura alla proprietà.
  • Le righe grezze vanno in una cartella di artefatti locale e privata, non nella risposta dello strumento.

Unione con la scansione

crawl-enrich abbina un CSV del traffico chiave URL alle URL scansionate e aggiunge segnalazioni di analytics, usando le colonne di visite e frequenza di rimbalzo che nomini. Con un progetto, sources-sync conserva lo storico giornaliero in un file SQLite locale, e sf run lo unisce offline alle pagine dell'audit.

  • Le segnalazioni su orfane, assenza di dati e non indicizzabili con traffico nascono dall'unione.
  • URL abbinate, solo scansione e solo esterne restano popolazioni separate.
  • I numeri di GA4 e Metrika non vengono mai sommati insieme.

Tre passaggi, una scansione salvata

  1. Controlla prima il contatore

    Esegui metrika-counters per trovare l'ID del contatore, poi metrika-setup per vederne obiettivi, filtri e operazioni sui dati.

  2. Tira visite e visualizzazioni di pagina

    metrika-report legge Yandex Metrika con qualsiasi metrica e dimensione. Le visualizzazioni GA4 arrivano da provider-collect con l'operazione ga4 page_views.

  3. Unisci i numeri alla scansione

    crawl-enrich abbina il CSV del traffico alle URL scansionate per URL e aggiunge segnalazioni di analytics, incluse le colonne di visite e frequenza di rimbalzo.

Controlli di questa funzionalità

ControlloCosa significaGravitàEvidenza
GA_ORPHAN_URLI dati di analytics nominano una URL same-origin che la scansione non ha trovatoImportantElenco di URL dall'unione. Trattenuto su una scansione parziale
NON_INDEXABLE_WITH_GA_DATAUna pagina non indicizzabile riceve comunque visite sopra zeroImportantURL e conteggio visite da --visits-column
NO_GA_DATAUna pagina scansionata indicizzabile non ha righe di analyticsTipElenco di URL. Rivedi il periodo misurato e il tagging di analytics prima di agire
BOUNCE_RATE_ABOVE_70La frequenza di rimbalzo della pagina supera il 70%TipURL e frequenza di rimbalzo da --bounce-column

Un solo comando

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

Prima installa SpiderHead: guida all'installazione. Ogni comando funziona anche come strumento MCP per agenti AI.

Cosa ti serve

  • Yandex Metrika: un ID contatore e un token OAuth
  • GA4: un ID proprietà e un access token o service account con analytics.readonly
  • Un intervallo di date
  • Una scansione o audit, più un CSV del traffico se usi crawl-enrich

Limiti

  • Le visualizzazioni di pagina GA4 non sono sessioni, utenti o sessioni da landing page, e non provano che una modifica abbia causato traffico.
  • La raccolta GA4 restituisce al massimo 100.000 righe per run. I dati con soglia o campionati sono segnalati.
  • Zero visite possono nascere dal tagging o dai filtri, quindi controlla prima metrika-setup.
  • Le righe mancanti non sono zeri misurati. Una segnalazione negativa richiede una scansione completa e una copertura completa dei provider.

Domande

Modifica il mio sito o le impostazioni di analytics?
No. Ogni chiamata è in sola lettura. metrika-setup mostra solo com'è configurato un contatore. Le evidenze salvate restano in una cartella locale.
Quale accesso serve?
Per Metrika, un token OAuth Yandex nell'impostazione YANDEX_METRIKA_TOKEN o nel suo file di token. Per GA4, un GA4_ACCESS_TOKEN oppure un service account con lo scope analytics.readonly e accesso in lettura alla proprietà.
Perché una pagina con zero visite non sempre è un problema?
Zero può nascere dalla configurazione. Senza obiettivi o filtri configurati, i numeri possono essere incompleti. Controlla metrika-setup prima di trarre conclusioni dal traffico.
Legge i log grezzi dei visitatori?
No. I log grezzi di Metrika sono esclusi per progetto perché contengono identificatori dei visitatori. Lo strumento usa solo report aggregati.
Quanto costa?
SpiderHead non addebita nulla per questi comandi. Le chiamate scalano sulle quote API di Metrika e GA4 del tuo account.
Cosa viene conservato sul mio computer?
Le righe grezze GA4 vanno in una cartella di artefatti privata che scegli tu. sources-sync scrive lo storico giornaliero in un file SQLite di progetto senza conservare token. metrika-report stampa il risultato; salvalo tu se ti serve.