Google Analytics 4

Traccia il traffico di qualsiasi property Google Analytics 4.

Cosa ottieni

Metrica	Significato in Google Analytics	Valore di periodo
Visitors	Total users	Utenti unici esatti sull’intero periodo
Visits	Sessions	Somma dei giorni
Page views	Views (page and screen views)	Somma dei giorni

I giorni sono contati nel fuso di reporting della property, così i numeri giornalieri coincidono con Google Analytics. Gli ultimi tre giorni sono trattati come provvisori perché Google può ancora rivederli.

Prima di iniziare

Ti serve:

• accesso Editor o Administrator alla property Google Analytics, per aggiungere un utente,
• un progetto Google Cloud dove creare un service account. Qualsiasi account Google gratuito può crearne uno.

Un service account è un account Google per software. Gli dai accesso Viewer alla property, come faresti con un collega, e Metribay accede come esso. Puoi riusare lo stesso service account per tutte le property e per Search Console.

Connect Google

Se vedi Connect Google quando aggiungi la fonte dati, puoi accedere con il tuo account Google e saltare il service account. Metribay chiede solo accesso in lettura ad Analytics.

Passo 1: Creare un service account

1. Apri la Google Cloud console e seleziona un progetto, o creane uno chiamato «Metribay».

2. Vai a APIs & Services → Library. Trova e abilita Google Analytics Data API e Google Analytics Admin API. La Data API fornisce i numeri; la Admin API permette a Metribay di elencare le property e leggere i fusi.

3. Vai a IAM & Admin → Service Accounts e seleziona Create service account. Chiamalo ad esempio metribay-reader. Non servono ruoli di progetto: salta quei passaggi e seleziona Done.

4. Apri il nuovo service account, vai a Keys e seleziona Add key → Create new key → JSON. Si scarica un file JSON. Tienilo al sicuro: è la password dell’account.

5. Copia l’email del service account. Termina con iam.gserviceaccount.com.

Creazione chiavi bloccata?

Alcune organizzazioni Google Workspace bloccano le chiavi dei service account con una policy. Se Google non ti lascia creare una chiave, chiedi all’amministratore Google Cloud o crea il progetto con un account Google personale.

Passo 2: Dargli accesso alla property

1. In Google Analytics, apri Admin.

2. Sotto Property, seleziona Property access management. Per coprire ogni property dell’account in una volta, usa Account access management.

3. Seleziona + → Add users, incolla l’email del service account e scegli il ruolo Viewer. Puoi deselezionare la notifica email.

4. Seleziona Add.

Passo 3: Collegarlo in Metribay

1. Nella pagina del progetto, seleziona Add data source e scegli Google Analytics 4.

2. Apri Connect an account with your own credentials e incolla l’intero contenuto del file chiave JSON in Service account JSON.

3. Seleziona Save account and continue. Metribay verifica la chiave.

4. Scegli la property dall’elenco. Il fuso di reporting viene compilato per te.

5. Seleziona Add and start import.

Puoi eliminare il file JSON scaricato dopo. Metribay conserva una copia crittografata.

Inserire la property a mano

Se l’elenco è vuoto, apri Enter it manually:

• Property ID: il numero sotto Admin → Property details, come 412345678. Non è l’ID misurazione G-.
• Property reporting timezone: il fuso sotto Admin → Property details. Deve coincidere, altrimenti i giorni saranno spostati.

Avanzato: token OAuth refresh

Invece di un service account, puoi collegarti con la tua app OAuth Google. Apri Use OAuth credentials instead e compila Client Id, Client Secret e un Refresh Token emesso con lo scope analytics.readonly. Lascia vuoto Service account JSON. Usalo solo se gestisci già un’app OAuth Google.

Se la raccolta non riesce

La property non è in elenco. Il service account non è stato aggiunto, o la Admin API non è abilitata. Controlla il passo 2, attendi un minuto, poi seleziona Refresh list.

«Needs attention» dopo che funzionava. Qualcuno può aver rimosso l’accesso del service account o eliminato la chiave. Aggiungilo di nuovo, o crea una nuova chiave e aggiorna l’account collegato.

Dati campionati, soggetti a soglia o limitati. Metribay non memorizza numeri che Google ha stimato, nascosto o troncato. Se Google applica soglie, spesso con Google signals attivo, la fonte dati richiede attenzione. In Google Analytics, apri Admin → Reporting identity e scegli Device-based. Di solito rimuove le soglie per questi totali.

Vedi anche Risoluzione problemi.