Google Analytics 4 e Matomo

Come collegare GA4 (OAuth Google) o Matomo (URL + auth token) a un progetto e leggere la dashboard analytics — card metriche toggle, KPI secondari, toggle Organico/Tutto, tab Andamento/Landing/Conversioni e breakdown Canale/Paese/Dispositivo/Browser.

Collegare un provider analytics è opzionale ma molto utile: porta il traffico reale (sessioni, utenti, engagement, conversioni) accanto ai dati di posizionamento. Puoi collegare Google Analytics 4 oppure Matomo — o entrambi: ognuno ha la sua dashboard dedicata sotto il gruppo Analytics in sidebar.

Tutte e due le connessioni si gestiscono da Impostazioni → Generale, nella riga 2 della griglia (card 📊 Google Analytics 4 e 📈 Matomo).

Collegare Google Analytics 4

  1. Apri il progetto → Impostazioni → Generale.
  2. Nella card 📊 Google Analytics 4 clicca Collega Google Analytics 4.
  3. Vieni reindirizzato a Google: scegli l’account con accesso alla property GA4 e concedi i permessi (sola lettura: Miraqo non scrive nulla in Analytics).
  4. Torni su Miraqo. Se la tua property GA4 corrisponde univocamente al dominio del progetto, viene selezionata automaticamente. Altrimenti compare lo stato ⚠️ “GA4 autenticato — seleziona una property” con il dropdown per sceglierla manualmente.
  5. Clicca Impostazioni avanzate sulla card per aprire il form di configurazione fine (opzionale):
    • Evento di conversione — nome esatto dell’evento GA4 da contare (es. purchase, generate_lead). I suggerimenti arrivano dagli eventi conversione già configurati sulla property. Lascia vuoto per non tracciare conversioni.
    • Filtri Hostname / Prefisso path — utili quando la stessa property GA4 traccia più siti o sezioni e vuoi isolare solo le pagine di questo progetto.

Cambio property dopo il collegamento. Dalla card GA4 in Impostazioni, se hai più property disponibili sull’account, puoi cambiare la property dal dropdown senza ridisconnettere.

Collegare Matomo

  1. Apri il progetto → Impostazioni → Generale.
  2. Nella card 📈 Matomo clicca Collega Matomo →.
  3. Inserisci l’URL Matomo — URL base, senza /index.php finale (es. https://analytics.miosito.it).
  4. Inserisci l’Auth token (token_auth). Lo trovi in Matomo → Personal → Security → Auth tokens; servono permessi di sola lettura sul sito.
  5. Clicca Test connessione: se le credenziali sono valide compare l’elenco dei siti. Seleziona il sito (idSite) da monitorare.
  6. (Opzionale) Conversione: formato goal_<id> per un singolo Goal Matomo, oppure ecommerce. In questa release l’attribuzione conversione per singola landing page non è disponibile su Matomo (il totale conversioni resta corretto e visibile nelle card e nel tab Conversioni).
  7. (Opzionale) Filtri Hostname / Prefisso path come per GA4.
  8. Salva.

Dalla card Matomo in Impostazioni puoi anche cliccare Modifica URL/token per cambiare credenziali senza disconnettere, e cambiare sito dal dropdown se l’istanza espone più di un site.

La dashboard Analytics (GA4 o Matomo)

GA4 e Matomo usano la stessa pagina dashboard, con lo stesso layout: cambia solo il provider in alto (e qualche dato derivato dalle differenze tra le due piattaforme).

Header e azioni

  • Titolo “Google Analytics 4” / “Matomo” + dominio
  • 🔄 Sincronizza — forza un refresh dei dati (per ruoli con permesso)
  • Toggle Organico / Tutto — filtra le card metriche e il grafico tra solo traffico organico (SEO) e tutto il traffico. La tabella Landing page resta sempre sul traffico organico, indipendentemente dal toggle.
  • Selettore Periodo (7 / 28 / 90 giorni)

Stati pre-dati

  • Non collegato — empty-state con link Impostazioni
  • Connessione incompleta — manca URL/token (Matomo) o autorizzazione/property (GA4)
  • Backfill in corso — overlay clessidra “Sto preparando i dati…” che blocca il grafico finché lo storico async non è completo (la pagina si aggiorna da sola via polling, può richiedere 1-2 minuti)

Le 4 card metriche (toggle del grafico)

Sopra il grafico, 4 card cliccabili che accendono/spengono la serie corrispondente:

  • Sessioni (✓ attiva di default) — sessioni del periodo
  • Utenti (✓ attiva di default) — utenti unici nel periodo. Il simbolo ✦ accanto al numero indica che il provider restituisce il valore già deduplicato di periodo (non c’è approssimazione)
  • Conversioni (off) — eventi chiave configurati (GA4) o completamenti dell’obiettivo collegato (Matomo)
  • Engagement rate (off) — % sessioni “engaged” (con permanenza, conversione o più pagine viste). La variazione è in pp (punti percentuali)

Ogni card mostra il valore totale + delta rispetto al periodo precedente di pari durata.

KPI secondari (7 card)

Sotto il grafico, una griglia di stat card:

  • Visualizzazioni — page views totali
  • Nuovi utenti
  • Utenti di ritorno
  • Bounce rate — % sessioni non-engaged (inverso di engagement)
  • Conversion rate — conversioni / sessioni
  • Tempo medio engagement — secondi
  • Valore conversioni — valore monetario nella valuta della property (Total revenue su GA4, valore goal su Matomo)

I tab

Sotto i KPI, tab per esplorare i dati. Tabelle ordinabili cliccando l’intestazione.

📈 Andamento giornaliero

Riga per giorno: Sessioni · Utenti · Conversioni · Engagement %.

📄 Landing page

Le pagine d’ingresso più visitate dal traffico organico (la tab non rispetta il toggle Tutto/Organico). Ordinabile per Sessioni / Utenti / Engagement % / Conversioni.

🎯 Conversioni

Totale conversioni, valore economico e conversion rate del periodo.

Breakdown — Canale / Paese / Dispositivo / Browser

Tab aggiuntive (icone in alto), una per ogni dimensione. Lo storico breakdown si popola dal primo sync giornaliero dopo il collegamento: non c’è backfill retroattivo per queste dimensioni, quindi i dati partono dalla data di collegamento (è normale che siano vuoti il primo giorno).

Sincronizzazione

  • Backfill iniziale automatico — appena colleghi, Miraqo importa in background gli ultimi 90 giorni. Per progetti grandi può richiedere qualche minuto. Durante il backfill la dashboard mostra l’overlay clessidra descritto sopra.
  • Sync giornaliero — automatico, rinfresca con una finestra che recupera i dati che i provider consolidano in ritardo.
  • Sincronizza — bottone manuale nell’header per forzare un refresh.

Disconnessione

Impostazioni → Generale → pulsante Disconnetti nella card GA4 o Matomo (con conferma). Lo storico già importato resta visibile nella dashboard, ma non riceverai nuovi aggiornamenti finché non ricolleghi.

Per GA4 puoi anche revocare l’accesso lato Google da Account Google → Sicurezza → App di terze parti. Dopo la revoca, il prossimo sync fallirà con errore di autorizzazione: torna in Impostazioni e ricollega.

Errori frequenti

  • “GA4 autenticato — seleziona una property” non si completa — hai concesso l’accesso ma non hai ancora scelto la property dal dropdown. Torna in Impostazioni e selezionala.
  • Matomo: “Test connessione” fallisce — verifica che l’URL sia quello base (senza /index.php) e che l’auth token abbia i permessi di lettura sul sito.
  • Nessuna property/sito nell’elenco — l’account Google o l’auth token usato non ha accesso a nessuna property GA4 / sito Matomo. Usa credenziali con i permessi corretti.
  • Conversioni a zero — non hai configurato l’evento di conversione (GA4 → Impostazioni avanzate) o il goal/ecommerce (Matomo).
  • Breakdown vuoti subito dopo il collegamento — è normale, si popolano dal primo sync giornaliero successivo (no backfill retroattivo per le dimensioni).
  • Dashboard bloccata su “Sto preparando i dati…” per più di 5 minuti — un sync del backfill è fallito. Disconnetti e ricollega, o contatta il supporto.

Cosa cambia altrove dopo il collegamento

  • Panoramica del progetto — il widget Analytics mostra una card di sintesi per ogni provider collegato, con grafico sessioni/giorno
  • Le keyword del progetto — nella tabella Dettaglio Keyword compaiono le colonne Sessioni e Conv. rate, associate alla landing page principale di ciascuna keyword
  • Dashboard di triage — il trend click GSC resta principale, ma i dati analytics arricchiscono i report

Prossimi passi:

Ultimo aggiornamento: 24 maggio 2026