Cosa sono le dimensioni di
GA4, quali usare, i nomi API, i limiti per proprietà e come creare una dimensione personalizzata passo dopo passo.

In questa pagina
In breve
Una dimensione di Google Analytics è un attributo testuale che descrive i tuoi dati, come il paese di un visitatore, il dispositivo usato o la pagina da cui è iniziata la sessione. Le dimensioni danno contesto alle metriche come sessioni o conversioni. Parti dalle dimensioni integrate e crea una dimensione personalizzata solo quando quell'elenco non riesce a rispondere alla tua domanda, entro i limiti della tua proprietà (50 a portata evento e 25 a portata utente in una proprietà standard).
Vuoi approfondire? Chiedi a
Quiz veloce
Quale modo di misurare il tuo marketing fa per te?
Sorank corrisponde alle tue risposte
Provalo per 3 giorni sul tuo sito e scopri a che punto sei su Google, ChatGPT e le altre IA.
Prova gratis per 3 giorni3 giorni gratis, poi smetti quando vuoi. Garanzia di risultati di 90 giorni, soggetta a condizioni.
Ogni numero in un report di GA4 ha un'etichetta. Il numero è una metrica. L'etichetta è una dimensione. «412 sessioni» è una metrica. «412 sessioni dalla Germania da mobile» aggiunge due dimensioni, il paese e la categoria del dispositivo, che indicano quali visitatori hanno prodotto quel numero.
Il riferimento della Guida di Google Analytics fa la stessa distinzione. Le dimensioni sono attributi descrittivi, cioè testo o categorie. Le metriche sono quantità. Medie, tassi e percentuali sono metriche, anche quando si calcolano a partire da altre metriche. Puoi sommare le sessioni tra una riga e l'altra. Non puoi sommare i paesi. Li raggruppi.
Per questo la stessa metrica può significare cose diverse. Un tasso di coinvolgimento del 60% su una landing page si legge in modo molto diverso se sai che i visitatori arrivavano dalla tua newsletter e non da una campagna a pagamento. La dimensione ti dice chi è arrivato. La metrica ti dice quanti di loro hanno fatto qualcosa.
Se GA4 è nuovo per te, leggi prima la nostra scheda del glossario su GA4 e poi torna qui. Questa guida presuppone che i dati arrivino già a una proprietà GA4.
Dimensione o metrica?
Le guide più vecchie parlano di «dimensione personalizzata indice 1» e di ambiti a livello di hit. Quel mondo è finito. Google ha smesso di elaborare nuovi hit per le proprietà standard di Universal Analytics il 1° luglio 2023. Le proprietà 360 con un contratto in corso hanno avuto tempo di elaborazione aggiuntivo fino al 1° luglio 2024. Se nel tuo team si parla ancora in numeri di indice, abbandona questa abitudine. In GA4 dai un nome a ogni dimensione personalizzata e la colleghi a un parametro che il tuo sito o la tua app invia.
Date di fine di Universal Analytics
Fonte: Guida di Google Analytics, «Google Analytics 4 ha sostituito Universal Analytics»
La pagina della Guida di Google su dimensioni e metriche raggruppa le dimensioni integrate in 16 categorie: Attribuzione, Dati demografici, E-commerce, Evento, Gaming, Generale, Geografia, Link, Pagina / schermata, Piattaforma / dispositivo, Publisher, Tempo, Origine del traffico, Utente, Durata di vita dell'utente e Video. La stessa pagina elenca anche 11 categorie di metriche, come Sessione, Ricavi e Pubblicità. Tieni separate le due liste quando cerchi, perché una categoria di metriche non ti aiuterà a filtrare per paese.

Non serve memorizzare la lista. Serve sapere quale categoria contiene la risposta alla tua domanda. Quattro categorie coprono la maggior parte del lavoro su un sito di contenuti:
Subito dopo vengono le dimensioni Evento e Utente. Le dimensioni Evento descrivono un'azione, come un clic su un pulsante o la riproduzione di un video. Le dimensioni Utente descrivono il visitatore nel corso delle sue sessioni, come l'origine che lo ha portato per la prima volta sul tuo sito. Conoscere questa suddivisione ti dice se una domanda riguarda una sessione, un evento o un utente. Mescolare questi livelli è una delle cause più comuni di report che sembrano sbagliati, e torniamo sull'argomento nella sezione sugli errori.

Ogni dimensione ha due nomi. Il nome dell'interfaccia è quello che vedi in un report. Il nome API è quello che invii all'API Data di Google Analytics, e ti serve per esportazioni, script e dashboard. Google documenta i nomi API nel suo schema dell'API Data. La tabella qui sotto copre le dimensioni che usa la maggior parte dei siti di contenuti.
| Nome nell'interfaccia | Nome API | Domanda a cui risponde |
|---|---|---|
| Origine della sessione | sessionSource | Quale sito o piattaforma ha avviato la sessione |
| Mezzo della sessione | sessionMedium | Che tipo di traffico era, come organic, referral o cpc |
| Gruppo di canali predefinito della sessione | sessionDefaultChannelGroup | A quale gruppo di canali appartiene la sessione |
| Landing page | landingPage | La prima pagina della sessione |
| Percorso della pagina | pagePath | La parte di percorso di ogni pagina aperta dal visitatore |
| Paese | country | Da dove proveniva l'attività dell'utente |
| Categoria del dispositivo | deviceCategory | Desktop, tablet o mobile |
| Nome dell'evento | eventName | Quale evento è stato registrato |
| Data | date | La data dell'evento, nel formato AAAAMMGG |

Tre regole aiutano quando passi dall'interfaccia all'API. Primo, i nomi API distinguono maiuscole e minuscole: sessionSource non è SessionSource. Secondo, ogni dimensione in più divide ogni riga in altre righe, e il risultato diventa più difficile da leggere, quindi inizia con due o tre. Terzo, una richiesta che nomina una dimensione sconosciuta alla tua proprietà fallisce. Quest'ultimo punto conta soprattutto per le dimensioni personalizzate.
Le dimensioni personalizzate seguono uno schema diverso. Lo schema di Google le indica per ambito e nome del parametro. Una dimensione a portata evento si scrive customEvent: seguito dal nome del parametro. Una dimensione a portata utente si scrive customUser: seguito dal nome del suo parametro. L'esempio qui sotto chiede l'origine della sessione e una dimensione personalizzata a portata evento chiamata author_name, per gli ultimi 28 giorni. Sostituisci i nomi con i tuoi.
{
"dimensions": [
{ "name": "sessionSource" },
{ "name": "customEvent:author_name" }
],
"metrics": [{ "name": "sessions" }],
"dateRanges": [{ "startDate": "28daysAgo", "endDate": "yesterday" }]
}
Questa richiesta funziona solo se la tua proprietà ha registrato author_name come dimensione personalizzata a portata evento. Altrimenti la richiesta fallisce. Registra prima, poi interroga.
Nota
Le dimensioni registrate prima di ottobre 2020 usano una forma più lunga che include il nome dell'evento tra parentesi quadre, come customEvent:parameter_name[event_name]. Se una query che funzionava l'anno scorso oggi fallisce, controlla se la dimensione è una di queste vecchie.
Una dimensione principale è quella con cui un report viene raggruppato. Ogni riga è un valore di quella dimensione. Una dimensione secondaria aggiunge una seconda suddivisione all'interno di ogni riga. L'idea è semplice, ma è qui che la maggior parte delle persone si blocca, perché gli stessi dati rispondono a una domanda diversa a seconda di quale dimensione viene prima.
| Domanda | Dimensione principale | Dimensione secondaria | Cosa scopri |
|---|---|---|---|
| Quali pagine ricevono visite organiche? | Landing page | Origine / mezzo della sessione | Se la ricerca è la fonte principale di ogni pagina, o se la pagina dipende da altri canali |
| I visitatori di un mercato usano soprattutto il telefono? | Paese | Categoria del dispositivo | La quota di mobile per ogni paese, che indica dove testare prima i layout |
| Quali campagne arrivano su quali pagine? | Campagna della sessione | Landing page | Campagne che portano a pagine non coerenti con la loro offerta |
| Quali browser usano i visitatori di un paese? | Browser | Paese | Problemi di compatibilità che compaiono solo in un mercato |
In una tabella di Esplorazioni puoi impilare più di due dimensioni, ma la leggibilità cala in fretta. Resta su due o tre per vista e sposta il resto nei filtri. Un filtro toglie righe, una dimensione le divide. Usa i filtri per restringere la domanda e le dimensioni per spiegare la risposta.
Prendi la prima riga della tabella sopra. Se la landing page è la dimensione principale e l'origine della sessione quella secondaria, ogni riga è una pagina con il suo traffico diviso per origine. Invertile, e ogni riga diventa un'origine con le sue pagine elencate sotto. I numeri sono identici. La domanda è un'altra. Decidi quale ti serve prima di aprire il report, e scrivilo in una frase.
Le dimensioni standard coprono la maggior parte dei report. Ti serve una dimensione personalizzata quando l'informazione sta nel tuo sistema, o in un parametro che invii tu. I casi tipici sono il nome dell'autore di un blog, il tipo di piano in un'app SaaS, una categoria di contenuto, o se il visitatore era connesso. Prima di creare qualsiasi cosa, fatti una domanda: la lista integrata può rispondere? Se sì, fermati lì.
La portata determina cosa descrive la dimensione personalizzata. Una dimensione a portata evento si lega a un singolo evento, come un clic o una visualizzazione di pagina che porta un parametro. Una dimensione a portata utente si lega a un visitatore e mantiene lo stesso valore su tutte le sue sessioni, come un livello di piano. Una dimensione a portata elemento si lega a un singolo elemento all'interno di un evento e-commerce, come il colore di un prodotto.
| Portata | Si lega a | Uso tipico | Proprietà standard | Proprietà 360 |
|---|---|---|---|---|
| Evento | Un evento | Autore dell'articolo letto | 50 | 125 |
| Utente | Un visitatore | Livello di piano, stato di accesso | 25 | 100 |
| Elemento | Un elemento di un evento e-commerce | Marca o colore del prodotto | 10 | 25 |
Limiti delle dimensioni personalizzate su una proprietà standard
Fonte: Guida di Google Analytics, panoramica delle dimensioni e metriche personalizzate
I limiti si applicano per proprietà e contano ogni dimensione registrata. La pagina Definizioni personalizzate in Amministrazione mostra il tuo utilizzo. Apri il link Informazioni sulla quota in alto a destra per vedere quanti posti ti restano. Tieni aperta questa pagina ogni volta che pianifichi una modifica al tracciamento.
Se raggiungi il limite, liberare un posto non è immediato. La pagina della Guida di Google sui limiti delle dimensioni personalizzate indica che devi aspettare 48 ore dopo aver eliminato delle dimensioni prima di poterne aggiungere di nuove. Pianifica i nomi prima di iniziare, ed evita di creare una dimensione per un test una tantum che eliminerai la settimana dopo.

Attenzione
Non inviare mai dati personali come valore di una dimensione. Nomi, indirizzi email e numeri di telefono sono informazioni personali identificabili, e le regole di Google vietano di inviarli ad Analytics. Il nome di un autore va bene. L'indirizzo email di un cliente no, anche se è offuscato nel tuo codice.
Questi passaggi presuppongono che il tuo sito o la tua app invii già il parametro. Se non arrivano dati, la dimensione viene creata ma non mostra nulla. Segui l'elenco in ordine.
Creare una dimensione personalizzata in cinque passi
Fonte: Guida di Google Analytics, «[GA4] Informazioni sulle dimensioni e metriche personalizzate»
Apri DebugView, poi attiva l'evento sul tuo sito o nella tua app. Guarda l'evento e i suoi parametri. Verifica che il valore sia quello atteso, per esempio «Jane Doe» per un autore e non «undefined». Solo a quel punto crea la dimensione. Un parametro che invia il valore sbagliato riempirà i tuoi report di dati errati da quel giorno in poi, e i giorni precedenti non si possono correggere.
Il nome del parametro nell'interfaccia deve coincidere con quello inviato dal codice. Una lettera di differenza, una maiuscola o uno spazio creano una dimensione che non si riempie mai. Copia il nome dal codice invece di scriverlo a memoria. Usa lettere minuscole e trattini bassi, come in author_name, perché incollerai la stessa stringa nelle richieste API più avanti.
Nota
La pagina della Guida di Google sulle dimensioni personalizzate di GA4 indica che i report partono da 24 a 48 ore dopo la creazione di una dimensione. Non creare una dimensione il pomeriggio del lancio di una campagna aspettandoti dati lo stesso giorno. Creala qualche giorno prima, poi verificala.
Una volta che le dimensioni esistono, puoi leggerle in quattro posti. Ognuno serve a un lavoro diverso. Scegliere lo strumento sbagliato ti fa perdere tempo, quindi confrontali prima di costruire qualsiasi cosa.
| Metodo | Ideale per | Limite principale | Esempio |
|---|---|---|---|
| Report standard | Controlli rapidi su traffico, pagine ed eventi | Layout fissi con una dimensione principale e una secondaria | Acquisizione del traffico per origine della sessione |
| Esplorazioni | Tabelle personalizzate, funnel e analisi dei percorsi | Richiede impostazione, e le tabelle grandi rallentano | Landing page per origine della sessione e categoria del dispositivo |
| API Data | Esportazioni, script e dashboard propri | Richiede codice, e ogni dimensione deve essere registrata | Esportazione settimanale delle sessioni per pagina in un foglio di calcolo |
| Looker Studio | Report condivisi con clienti o responsabili | Dipende dal connettore e dalla sua frequenza di aggiornamento | Dashboard mensile per il cliente con il traffico per canale |
I report standard rispondono alla prima domanda che hai ogni mattina. Usali per notare un calo, poi passa a uno strumento più flessibile per trovare la causa. Il loro vantaggio è la velocità. Il loro punto debole è che non puoi scegliere qualsiasi coppia di dimensioni, quindi una domanda che ne richiede tre non entra in un report standard.
Le Esplorazioni ti permettono di costruire una tabella con le dimensioni e le metriche che scegli, e di salvarla per dopo. È lo strumento per analizzare le landing page, per confrontare i canali all'interno di un paese e per verificare che una dimensione personalizzata si riempia davvero. Limita ogni esplorazione a una domanda. Una tabella che risponde a cinque domande di solito non ne risponde chiaramente a nessuna.
Suggerimento
Dimensioni pulite partono da link di campagna puliti. I valori di origine e mezzo arrivano dai tuoi parametri UTM, quindi una differenza di scrittura come «Newsletter» e «newsletter» crea una seconda riga per lo stesso canale. Crea i tuoi link con il nostro generatore di link UTM gratuito, per mantenere coerenti i nomi.
Usa l'API quando un report gira ogni settimana, quando alimenti una dashboard o quando vuoi confrontare il risultato di due proprietà in uno script. Lo schema di richiesta visto prima in questa guida è il mattone di base. Quando funziona in un test, metti lo stesso JSON nel tuo script e tieni i nomi delle dimensioni in un solo punto, così una rinomina non rompe dieci query in una volta.
Looker Studio è la scelta abituale quando qualcun altro deve leggere i numeri. Si collega a GA4 e presenta le dimensioni in grafici e tabelle. I suoi limiti vengono dal connettore e dalla sua frequenza di aggiornamento, non da GA4 in sé. Se costruisci una dashboard per un cliente, la nostra guida a Looker Studio per la SEO copre le formule e i limiti che contano per i dati di ricerca, e la nostra guida a una dashboard GA4 spiega cosa mettere nella prima schermata.
Gli assistenti IA inviano visitatori che arrivano tramite un link, e quel link porta con sé un'origine di riferimento. La vedi nella dimensione origine della sessione e nella landing page. Alcune app di IA non trasmettono alcun referrer, quindi questo metodo copre solo una parte del quadro. La nostra scheda del glossario sul traffico oscuro dell'IA spiega cosa manca e perché. Per la ricerca organica nello stesso report, la nostra guida a Google Analytics per la SEO mostra come separarla dal resto.
Isolare le visite dell'IA in quattro passi
Leggi il risultato con attenzione. Un aumento delle sessioni dell'IA su una pagina indica che la pagina viene usata, ma non dice se i visitatori hanno comprato qualcosa. Aggiungi una metrica di conversione alla tabella prima di decidere che una pagina funziona. L'articolo su come misurare le citazioni IA con Google Analytics illustra la parte delle conversioni.
Suggerimento
Se vuoi il traffico di Google e quello dell'IA su un'unica schermata senza costruire tu l'esplorazione, la dashboard GEO / SEO di Sorank mostra entrambi. Combina i dati di Google Search Console (clic, impression, CTR, posizione) con le visualizzazioni di pagina che inviano gli assistenti IA, così come vengono registrate in Google Analytics.
La maggior parte dei problemi con le dimensioni si vede da una colonna vuota, da una colonna di valori «(not set)» o da un report che sembra corretto ma risponde alla domanda sbagliata. La tabella ti indica il segnale da cercare. Le sezioni seguenti spiegano ogni errore.
| Errore | Come riconoscerlo | Correzione |
|---|---|---|
| Creare una dimensione prima che arrivino i dati | Ogni riga mostra «(not set)» | Conferma il valore in DebugView, poi crea la dimensione |
| Nome diverso tra codice e interfaccia | Nessun dato 48 ore dopo | Copia il nome del parametro dal codice |
| Duplicare una dimensione integrata | Due dimensioni danno le stesse righe | Controlla prima l'elenco standard, poi elimina la copia |
| Valori ad alta cardinalità | Migliaia di righe, ognuna con una sola sessione | Invia categorie e conserva gli identificativi unici nel tuo sistema |
| Dati personali in un valore | Valori che sembrano email o nomi completi | Rimuovi il parametro e invia una categoria al suo posto |
| Aspettarsi uno storico | Le date vecchie sono vuote, quelle nuove sono piene | Confronta solo dalla data di creazione e annota il buco |
L'errore: crei la dimensione, poi scopri che il parametro non è mai arrivato a GA4. Te ne accorgi perché ogni riga del report mostra «(not set)». La correzione è invertire l'ordine. Conferma il valore in DebugView, registra la dimensione, poi aspetta le 24 o 48 ore che indica Google prima di giudicare il report.
L'errore: il codice invia author_name, ma l'interfaccia contiene Author_name o author name. La dimensione esiste e resta vuota. Il segnale: una definizione personalizzata regolare senza dati dopo due giorni. La correzione: apri il codice, copia la stringa esatta e ricontrollala in DebugView. Correggere più tardi non recupera i giorni persi, quindi sistemalo il giorno in cui lo trovi.
L'errore: crei una dimensione personalizzata chiamata Country perché non hai controllato l'elenco standard. Lo vedi da due righe con gli stessi valori. Il costo è la quota. Ogni duplicato usa uno dei tuoi 50 posti a portata evento, o uno dei 25 a portata utente, e quei posti ti serviranno dopo per cose che GA4 non può darti. Controlla prima l'elenco standard nei report, poi decidi.
L'errore: invii una dimensione con un valore unico per ogni visitatore o ogni ordine, come un ID utente, un URL completo con stringa di query o un numero d'ordine. Google consiglia di evitare le dimensioni ad alta cardinalità nelle proprietà standard. Il segnale: una tabella con migliaia di righe, ognuna con una sola sessione. La correzione è inviare una categoria. Invia il tipo di piano, non l'ID utente. Invia il tipo di contenuto, non l'URL completo. Conserva l'identificativo unico nel tuo CRM, dove puoi ricollegarlo ai dati da solo.
L'errore: una dimensione contiene un indirizzo email, un nome o un numero di telefono, spesso perché qualcuno ha usato una variabile comoda. Il segnale: un valore che sembra una persona. La correzione è rimuovere il parametro e inviare una categoria o un codice interno anonimo. Verifica con il tuo responsabile della protezione dei dati se hai dubbi. Offuscare un indirizzo email non lo rende sicuro da inviare.
L'errore: crei una dimensione a maggio e ti aspetti che spieghi le sessioni di gennaio. I report mostrano solo i valori raccolti dopo che la dimensione ha iniziato a riceverli. Il segnale: una colonna vuota per le date precedenti. La correzione: indica la data di inizio nel titolo del report e confronta solo da quella data in poi. Non presentare un grafico prima-dopo che parte nel mezzo di un buco.
Una dimensione è un attributo testuale, come il paese, il dispositivo o il percorso della pagina. Una metrica è un numero, come le sessioni, gli utenti attivi o le conversioni. Le dimensioni raggruppano ed etichettano i numeri, quindi la stessa metrica si legge in modo diverso a seconda delle dimensioni con cui la abbini.
Una proprietà standard consente 50 dimensioni personalizzate a portata evento, 25 a portata utente e 10 a portata elemento. Una proprietà 360 ne consente 125, 100 e 25. La pagina Definizioni personalizzate in Amministrazione mostra quante ne hai usate. Eliminarne una non libera subito il suo posto, perché devi attendere 48 ore prima di aggiungerne un'altra.
Di solito il parametro non arriva a GA4, oppure il suo nome non corrisponde esattamente. Controlla DebugView, correggi il nome nell'interfaccia o nel codice e aspetta da 24 a 48 ore dalla creazione. Se i dati continuano a non comparire, è probabile che il parametro non venga inviato.
La tua lista per questa settimana
Parti da una domanda a cui oggi non sai rispondere. Costruisci una dimensione per quella, verifica i dati e solo dopo aggiungi la successiva.
Una dimensione è un attributo testuale, come il paese, il dispositivo o il percorso della pagina. Una metrica è un numero, come le sessioni, gli utenti attivi o le conversioni. Le dimensioni raggruppano ed etichettano i numeri.
Una proprietà standard consente 50 dimensioni a portata evento, 25 a portata utente e 10 a portata elemento. Una proprietà 360 ne consente 125, 100 e 25. La pagina Definizioni personalizzate in Amministrazione mostra il tuo utilizzo.
Di solito il parametro non arriva a GA4, oppure il suo nome non corrisponde esattamente. Controlla DebugView, correggi il nome e aspetta da 24 a 48 ore dalla creazione prima di giudicare il report.
