Quattro minuti per creare l'account di servizio. Sedici mesi di cronologia di Search Console recuperati al primo sync. Due secondi per un dominio già verificato e autorizzato. E due mesi — il numero che genera più ticket di assistenza degli altri tre messi insieme, perché è la finestra di conservazione dati predefinita di GA4, e quasi nessuno sa di doverla controllare prima di collegarsi.
La configurazione in sé è breve: una credenziale in Impostazioni → Account Google, due pulsanti di connessione in Gestione Dominio, e poi ti dimentichi quasi che questa pagina esista. Ma quel dato dei due mesi merita una spiegazione completa, perché chiarisce perché alcuni domini mostrano fin dal primo giorno una cronologia Analytics ricca e utile, mentre altri mostrano quasi nulla per settimane — e non è un bug della piattaforma quando succede.
Una credenziale, concessa una sola volta
Carichi una chiave di account di servizio Google — un file JSON, non un login personale. Un'identità robot, non un token OAuth umano che scade o smette di funzionare quando qualcuno cambia password. Google Cloud la rilascia una volta sola e continua a funzionare finché non la elimini, ed è anche così che la piattaforma si sincronizza alle 3 del mattino senza che nessuno sia collegato.
Crearne uno richiede circa quei quattro minuti se non l'hai mai fatto: progetto nuovo o esistente, IAM e Admin → Account di servizio → Crea, scarica la chiave. Il permesso conta più di quanto il menu a tendina faccia pensare — assegna Visualizzatore sulla proprietà Search Console e sulla proprietà Analytics, niente di superiore. Ho visto team assegnare Editor perché è l'opzione in cima, e sei mesi dopo nessuno riesce a spiegare perché un account robot abbia accesso in scrittura alla configurazione GA4. Sola lettura è corretto; la piattaforma non tocca mai le tue impostazioni.
Una singola chiave copre tutti i domini di quel progetto Google Cloud. Se sei un'agenzia che gestisce una dozzina di siti clienti, questo è un buon motivo per usare un account di servizio per ogni cliente invece di uno unico per tutto — chiudere un rapporto con un cliente diventa eliminare una chiave, non fare un audit su quali domini abbiano condiviso silenziosamente le credenziali con qualcuno che se n'è appena andato.
Search Console: veloce quando è veloce, fastidioso quando non lo è
- Apri Connetti su un dominio. Search Console e Analytics hanno ciascuno una scheda, e Analytics ha una scorciatoia "uguale a Search Console", perché di solito una sola chiave copre entrambi.
- Già verificato con il tuo account di servizio a cui è stato concesso l'accesso? Istantaneo — un controllo dei permessi, fatto in circa due secondi.
- Non ancora verificato: verifica DNS automatica se fornisci la chiave API del tuo registrar (Cloudflare, Route 53, alcuni altri), oppure un record TXT manuale che aggiungi tu stesso.
Il percorso manuale è dove le persone perdono la pazienza. La propagazione varia davvero — novanta secondi una volta, quattro ore un'altra, a seconda del TTL e della cache dei resolver. La piattaforma esegue un polling, quindi aggiungi il record e puoi andartene. Se passa un giorno senza verifica, raramente è propagazione; più spesso è un errore di battitura nel valore o il record finito nella zona sbagliata (apex invece di sottodominio, o viceversa). Esegui un `dig TXT` su ciò che è effettivamente attivo prima di dare la colpa a Google.
Il percorso con chiave API salta tutto questo scrivendo il record al posto tuo, ma significa dare a uno strumento di terze parti l'accesso in scrittura al tuo DNS — e se quel DNS gestisce traffico di produzione, esitare non mi sembra irragionevole. Il percorso manuale costa qualche minuto in più all'inizio, ma ti permette di non doverci più pensare.
Analytics, e il divario nella cronologia dei dati di cui nessuno ti avvisa
Analytics si connette tramite rilevamento piuttosto che verifica — la piattaforma cerca una proprietà GA4 esistente sul dominio e si connette se il tuo account di servizio ha accesso, poiché i permessi GA4 sono già regolati lato Google. Può creare una proprietà se non esiste nulla, ma dovresti permetterlo solo per siti realmente nuovi. Se sei migrato da Universal Analytics o hai una proprietà con anni di cronologia, connettiti esplicitamente a quella. Una proprietà nuova con tre giorni di dati è un punto di partenza molto peggiore di una con nove anni di storico e pattern stagionali consolidati, e il ciclo di ottimizzazione si basa su questa cronologia più di quanto il flusso di connessione lasci intendere.
Ecco il divario che coglie molti impreparati: Search Console recupera fino a sedici mesi di dati sulle query alla prima sincronizzazione, perché Google conserva lato server tutta questa cronologia indipendentemente da quando ti sei connesso. GA4 non ha una garanzia equivalente — il suo recupero dati è limitato dall'impostazione di conservazione dati della proprietà stessa, che per impostazione predefinita è di due mesi, a meno che qualcuno nella tua organizzazione non l'abbia modificata. Quindi un dominio può mostrare sedici mesi di impressioni e clic nel momento stesso in cui ti connetti, e due mesi di sessioni, nello stesso identico giorno, dallo stesso identico flusso di configurazione. Non è un errore di sincronizzazione. È l'impostazione predefinita di conservazione di Google che fa esattamente ciò per cui è configurata, e la soluzione — se vuoi più di due mesi in futuro — è modificare la finestra di conservazione direttamente nelle impostazioni della proprietà GA4, non qualcosa lato piattaforma. Vale la pena controllarlo prima di connettersi, non dopo essere rimasti confusi dalla discrepanza.
Proprietà condivise e cosa succede dopo
Un'altra particolarità di Analytics: se la tua organizzazione gestisce un'unica proprietà GA4 che raccoglie dati per cinque siti — comune quando qualcuno ha configurato il tracciamento anni fa e nessuno l'ha più diviso — la connessione funziona comunque correttamente, ma ogni query viene filtrata per hostname dietro le quinte. Non è una casella di controllo, non è qualcosa che si può disattivare per errore. Per questo la dashboard mostra sempre i numeri di questo dominio e mai il totale combinato della proprietà.
Una volta stabilite entrambe le connessioni, la sincronizzazione viene eseguita quotidianamente secondo una pianificazione che controlli tu (vedi il capitolo sulle pianificazioni), e le analitiche dello store si uniscono automaticamente a tutto ciò che è costruito sulla piattaforma. La riga del dominio mostra in attesa, parziale o attiva — "parziale" significa che una delle due connessioni è attiva e l'altra no, ed è il segnale per andare a controllare quale scheda è in rosso invece di fidarsi dello stato aggregato.
Dove le cose si rompono davvero
Quasi ogni ticket che ho visto rientra in tre categorie, nessuna esotica. Uno: la chiave dell'account di servizio è valida ma associata al progetto Google Cloud sbagliato, quindi il controllo dei permessi risulta vuoto anche se la chiave stessa viene caricata correttamente. Due: nessuno ha effettivamente aggiunto l'email dell'account di servizio — qualcosa come [email protected] — come Visualizzatore nelle impostazioni di accesso di Search Console o GA4; caricare la chiave sulla piattaforma non le concede nulla lato Google. Tre, più subdolo: un dominio viene riconnesso con un nuovo account di servizio dopo l'eliminazione del vecchio, ma la pianificazione continua a fallire silenziosamente con credenziali obsolete per una settimana prima che qualcuno si accorga che i numeri hanno smesso di aggiornarsi.
Nessuno di questi è un bug della piattaforma — sono il normale costo di un robot che ha bisogno di permessi su due diversi prodotti Google, e il modello stesso di Google non lo rende evidente. Preventiva quindici minuti per il tuo primo dominio, non i due minuti che il flusso lascia intendere. Ogni dominio successivo è veloce, perché sia le credenziali sia l'abitudine si riportano avanti.
