Google Search Console

Come collegare Google Search Console al progetto e leggere la pagina Dati GSC — card metriche con serie del grafico attivabili, 6 tab (Query, Pagine, Paesi, Dispositivi, Date, Aspetto), filtri di periodo e sincronizzazione manuale.

Collegare Google Search Console è opzionale ma fortemente raccomandato. Ti dà accesso ai dati reali di Google sulle tue impressioni, click e CTR — informazioni che Miraqo usa per:

Mostrare il traffico organico stimato per ogni keyword
Suggerire keyword nuove (query che già portano impressioni ma non sono ancora tracciate, vedi Le keyword del progetto)
Distinguere la “posizione media” mostrata da Google dal ranking puro

GSC misura come Google vede il tuo sito (impressioni, click, posizione). Per il traffico reale sul sito (sessioni, utenti, conversioni) c’è un’integrazione separata e complementare: Google Analytics 4 o Matomo.

Prerequisiti

Sito già verificato in Google Search Console (con l’account Google che userai per il collegamento)
Permesso di accesso ai dati GSC del sito (proprietario o utente delegato)

Se il sito non è ancora verificato in GSC, fai prima quel passaggio sul portale Google. Miraqo non può aggiungere o verificare un nuovo sito in GSC — solo leggere i dati di siti già verificati.

Procedura di collegamento

Apri il progetto → Impostazioni → Generale. Nella griglia, la prima riga contiene la card 🔍 Google Search Console.
Clicca Collega con Google.
Vieni reindirizzato a Google: scegli l’account con accesso a GSC e clicca Continua.
Concedi i permessi richiesti (sola lettura: Miraqo non scrive nulla in GSC).
Torni su Miraqo. Se il dominio del progetto matcha una sola property GSC, viene selezionata automaticamente. Altrimenti scegli manualmente dal dropdown quale property usare (https://esempio.it/ vs sc-domain:esempio.it).

Il primo sync parte automaticamente e importa gli ultimi 90 giorni di dati. Possono volerci 1-2 minuti per progetti con molte query.

Cambio property dopo il collegamento: dalla stessa card di Impostazioni, se hai più property disponibili sull’account, puoi cambiare la property utilizzata dal dropdown senza dover ridisconnettere.

La pagina Dati GSC

La raggiungi dalla sidebar del progetto → Google Search Console.

Header e azioni

Titolo “Google Search Console” + dominio del progetto
Bottone 🔄 Sincronizza — forza un nuovo fetch dei dati (per i ruoli con permesso di sync)
Selettore periodo — chip per scegliere l’intervallo (7/28/90 giorni); cambia tutta la pagina e le tabelle

Stati possibili prima dei dati

GSC non collegata — empty-state con bottone “Vai alle Impostazioni”
Connessa ma senza property selezionata — banner ⚠️ con bottone Impostazioni
Nessun dato sincronizzato — empty-state con bottone ”🔄 Sincronizza ora” (capita subito dopo il primo collegamento)

Le 4 card metriche

Cliccabili come toggle: accendi/spegni la serie corrispondente nel grafico sottostante. Per ogni metrica vedi il valore totale del periodo + variazione percentuale (quando confrontabile):

Clic totali (attiva di default)
Impressioni totali (attiva di default)
CTR media (spenta di default)
Posizione media (spenta di default)

Il grafico sotto le card mostra l’andamento giornaliero delle serie attive.

Le 6 tab

Sotto il grafico, tab per esplorare i dati GSC da angolazioni diverse. Tutte le tabelle sono ordinabili cliccando l’intestazione della colonna.

🔎 Query

Tabella delle query con Click, Impressioni, CTR e Posizione. Le celle CTR e Pos. hanno una colorazione che segnala valori “buoni” vs “da migliorare”.

📄 Pagine

Tabella delle URL del sito posizionate, con le stesse 4 metriche. Le pagine sono linkate (si aprono in nuova scheda).

🌍 Paesi

Distribuzione del traffico organico per paese (con codice ISO).

📱 Dispositivi

Card riepilogative per Mobile, Desktop e Tablet, ognuna con i 4 indicatori in griglia 2×2.

📅 Date

Tabella giorno per giorno (utile per esportare manualmente o investigare singoli giorni).

✨ Aspetto

Distribuzione per rich result type (Rich Results, Video, Immagini, FAQ, Review, …). Vedi quali aspetti Google sta usando per mostrare il tuo sito in SERP.

Sincronizzazione

Miraqo rinfresca i dati GSC automaticamente ogni giorno sull’intera finestra di 90 giorni. In più puoi forzare un sync manuale dal bottone 🔄 Sincronizza nell’header (consumo: 1 chiamata API GSC al giorno, non c’è limite di piano dedicato).

Freschezza dei dati Google. Search Console consolida i dati con 2-3 giorni di ritardo. Per non mostrare cali fittizi, i grafici sparkline e i delta percentuali della Dashboard si fermano al confine di freschezza (circa oggi − 2 giorni): gli ultimi 1-2 giorni non ancora definitivi vengono esclusi dai confronti. È normale che la Dashboard non mostri “ieri”.

Disconnessione

Impostazioni → Generale → 🔍 Google Search Console → Disconnetti. Conferma richiesta. Lo storico dei dati già importati resta visibile nella pagina Dati GSC, ma non riceverai nuovi aggiornamenti finché non ricollegherai.

Puoi anche revocare l’accesso lato Google: Account Google → Sicurezza → App di terze parti. Dopo la revoca, il prossimo sync fallirà con invalid_grant (vedi sotto).

Errori frequenti

“invalid_grant” durante il sync — il token è stato revocato (cambio password Google, scadenza, accesso revocato manualmente o app rimossa da Account Google). Vai in Impostazioni → Generale, clicca Disconnetti e ricollega.
Nessuna property compare nel selettore — l’account Google scelto non ha accesso a nessuna property GSC. Verifica di aver fatto login con l’account corretto e, se serve, fatti aggiungere come utente in GSC dal proprietario del sito.
Property elencate ma nessun dato — la property è verificata da meno di 24-72h. Google impiega 1-3 giorni a popolare i dati delle nuove property.
Sync OK ma tabelle vuote per uno specifico tab (es. Paesi/Aspetto) — il tuo sito non ha ancora ricevuto traffico/impression di quel tipo, oppure GSC non ha aggregato abbastanza dati. Non è un bug del tool.

Cosa cambia altrove dopo il collegamento

Panoramica del progetto — la card “Principali Metriche” mostra dati arricchiti e l’eventuale widget Analytics si correla meglio
Dashboard di triage — compare la colonna ∆ Impressioni GSC e il trend click 30 giorni nella riga del progetto
Le keyword del progetto — in Impostazioni → Keywords compare il pannello ”💡 Suggerite da Google Search Console” con le query in entrata da aggiungere in tracking
Prompt AI — in Impostazioni → Prompt AI compare un pannello analogo con le query multi-parola da GSC come candidate prompt

Hai completato la configurazione iniziale. Ora puoi:

Ultimo aggiornamento: 24 maggio 2026