Impostare le proprietà utente di GA4 e analizzarle nei report

Cosa sono le proprietà utente di GA4?

Google Analytics 4 usa le proprietà utente di GA4 per descrivere la persona che sta dietro agli eventi, ad esempio il livello del piano, la lingua preferita o un ruolo, e applica ogni valore a tutti gli eventi successivi di quell'utente. La pagina di aiuto di Google le definisce come "attributi che descrivono gruppi della tua base di utenti", con le preferenze linguistiche e le posizioni geografiche come esempi. Usale per i dati che valgono su molti eventi e lascia i dettagli della singola azione nei parametri evento.

Una proprietà utente compare nei report solo dopo che l'hai registrata come dimensione personalizzata con ambito utente. Google lo dice chiaramente: "Per creare report sui dati raccolti tramite le proprietà utente, crea dimensioni personalizzate con ambito utente." La sua pagina sulle dimensioni personalizzate aggiunge che "le proprietà utente diventano alias degli slot delle dimensioni personalizzate con ambito utente", quindi lavori con nomi sensati come customer_tier invece che con slot numerati.

GA4 compila anche da solo una serie di dimensioni utente, come Paese, Lingua e Categoria di dispositivo. Queste dimensioni predefinite coprono i casi più comuni. Le proprietà utente personalizzate servono per i dati che conosce solo il tuo sito, per esempio se un visitatore ha un piano gratuito o a pagamento.

In cosa le proprietà utente differiscono dai parametri evento?

Le proprietà utente descrivono l'utente e si portano dietro negli eventi futuri, mentre i parametri evento descrivono un solo evento e finiscono lì. La pagina di Google sulle dimensioni personalizzate traccia il confine in due frasi: i parametri evento "forniscono più dettagli su queste azioni, per esempio quale link è stato cliccato", mentre "le proprietà utente ti dicono di più sugli utenti stessi".

Il limite di 36 caratteri per il valore significa etichette di categoria brevi, non testo libero. Se stai ancora decidendo quali dati meritano uno slot, parti dalle decisioni che devono supportare, come spiega la guida all'implementazione di analytics personalizzati.

Come si impostano le proprietà utente con gtag?

Imposti le proprietà utente con il tag Google chiamando il comando set con un oggetto user_properties, che applica i valori a ogni evento della pagina. La pagina di aiuto di Google riporta questo esempio:

gtag('set', 'user_properties', {
  favorite_composer: 'Mahler',
  favorite_instrument: 'double bass',
  season_ticketholder: 'true'
});

Per limitare i valori a un solo flusso di dati, Google mostra lo stesso oggetto dentro un comando config: gtag('config', 'STREAM_ID', { 'user_properties': { ... } }). Esegui la chiamata appena la pagina conosce il valore, per esempio subito dopo il login.

La pagina di aiuto di Google elenca altri due modi per impostarle:

1. Google Tag Manager. In un tag evento di Google Analytics 4, "aggiungi una riga nella sezione Proprietà utente per ogni parametro che vuoi includere."
2. Firebase per le app mobile. Dopo aver installato l'SDK Google Analytics per Firebase, segui la documentazione "Set user properties" di Firebase.

Il codice lato server può inviare proprietà utente tramite il Measurement Protocol in un oggetto user_properties, dove ogni proprietà contiene un campo value. La guida per sviluppatori di Google segnala che puoi inviare proprietà utente anche senza eventi e che "Google Analytics usa il valore più recente di una proprietà utente per ciascun utente."

Come si creano report su una proprietà utente di GA4?

Crei report su una proprietà utente di GA4 creando una dimensione personalizzata con ambito utente in Amministrazione, sotto Visualizzazione dati, Definizioni personalizzate, con il ruolo di Editor o superiore sulla proprietà. La procedura di Google:

1. In Amministrazione, sotto Visualizzazione dati, clicca su Definizioni personalizzate.
2. Apri la scheda Dimensioni personalizzate e clicca su Crea dimensioni personalizzate.
3. Inserisci il nome della dimensione. I trattini non sono ammessi, i trattini bassi e gli spazi sì.
4. Imposta l'ambito su Utente. Google precisa che l'ambito non si può cambiare dopo il salvataggio.
5. Inserisci il nome della proprietà utente esattamente come lo invia il tuo codice. Anche questo campo non si modifica più dopo il salvataggio.
6. Clicca su Salva.

Le pagine di Google non concordano sull'ordine. La pagina sulla raccolta dei dati utente dice di creare la dimensione "prima di impostare le proprietà utente", mentre quella sulla creazione della dimensione dice di aggiungere prima la proprietà al codice e di verificarla nella scheda "Utenti per proprietà utente" del report Tempo reale. Google indica che la dimensione arriva nei report dopo un tempo da 24 a 48 ore, quindi registrala il giorno stesso in cui la proprietà va online. Una volta creata, puoi usarla in confronti, filtri, esplorazioni e condizioni del pubblico.

Quali limiti valgono per le proprietà utente di GA4?

Una proprietà GA4 standard accetta 25 proprietà utente e una proprietà Google Analytics 360 ne accetta 100, con nomi fino a 24 caratteri e valori fino a 36 caratteri. La pagina di Google sui limiti di raccolta afferma che Analytics "non elabora la 26ª proprietà utente" su una proprietà standard.

I nomi seguono altre tre regole, tratte dalla guida per sviluppatori e dalle pagine di aiuto di Google:

• Nomi riservati. Non puoi usare first_open_time, first_visit_time, last_deep_link_referrer, user_id e first_open_after_install.
• Prefissi riservati. I nomi non possono iniziare con google_, ga_ o firebase_.
• Distinzione tra maiuscole e minuscole. Google avverte che "impostare due proprietà utente con nomi che differiscono solo per le maiuscole produce due proprietà utente distinte registrate."

Una quarta trappola si trova nella dimensione personalizzata. Google dice che "qualsiasi valore in una dimensione personalizzata che assomigli a un numero verrà trattato come un numero, anche se in origine era formattato come testo." Un codice di livello come 94E40 diventa notazione scientifica, quindi fai precedere i codici da una lettera.

Quali proprietà utente raccoglie GA4 in automatico?

GA4 raccoglie in automatico una serie di dimensioni utente predefinite e, secondo Google, con gtag.js o l'SDK "non devi scrivere codice aggiuntivo per raccoglierle". Sui siti web includono Età, Genere, Interessi, Lingua, Paese, Regione, Città, Browser, Categoria di dispositivo, Marca del dispositivo, Sistema operativo e Piattaforma. Gli stream delle app aggiungono App store, Versione dell'app, Modello del dispositivo e Nuovo/Consolidato.

Non sprecare uno dei tuoi 25 slot per duplicarle. La pagina di Google sulle dimensioni personalizzate con ambito utente dice: "Non creare una proprietà utente personalizzata se esiste già una dimensione utente predefinita."

Età, Genere e Interessi hanno un'insidia. Google precisa che "devi rispettare le soglie dei dati di Analytics per vedere i dati demografici e sugli interessi", e Google nasconde quelle righe quando un gruppo è così piccolo da rendere identificabili le persone. La guida sulla soglia dei dati in GA4 spiega quando succede e come ridurla.

Quando inizia ad applicarsi una proprietà utente di GA4?

Una proprietà utente di GA4 si applica dal momento in cui viene impostata a tutti gli eventi futuri di quell'utente, comprese le sessioni successive, e mai a quelli precedenti. Le parole di Google: "La proprietà utente non verrà applicata agli eventi avvenuti prima che fosse impostata."

Se un visitatore legge cinque pagine e solo dopo riceve customer_tier al momento della registrazione, quelle cinque visualizzazioni di pagina non hanno alcun livello. Imposta la proprietà a ogni caricamento di pagina per un utente che ha effettuato l'accesso.

GA4 elimina anche i duplicati. Google spiega che Analytics raccoglie una proprietà utente quando viene "impostata per la prima volta in una pagina" oppure quando il suo valore cambia, quindi ripetere la stessa chiamata set nella stessa pagina non invia dati aggiuntivi.

Le proprietà utente di GA4 possono contenere dati personali?

Le proprietà utente di GA4 non devono contenere informazioni di identificazione personale, perché la policy di Google vieta di inviarne. La pagina di assistenza di Google afferma che le sue "policy impongono di non trasmettere a Google dati che Google possa usare o riconoscere come informazioni di identificazione personale (PII)" e cita come esempi "indirizzi email, numeri di cellulare personali e numeri di previdenza sociale". Il suo elenco delle funzioni che richiedono particolare attenzione include "Tutte le dimensioni personalizzate", e quindi ogni proprietà utente registrata.

Limita i valori a categorie come pro, trial o admin. Per un identificatore stabile dell'account, Google indica la funzione User-ID invece di una proprietà utente, e la sua pagina sulle dimensioni personalizzate sconsiglia "una dimensione personalizzata per un ID univoco per utente". Anche un ID che non nomina nessuno può comunque essere considerato dato personale secondo la normativa sulla privacy, come spiega la guida sugli identificatori di analytics e dati personali.

Come associa Flowsery i dettagli a un utente che ha effettuato l'accesso?

Flowsery associa i dettagli a un utente che ha effettuato l'accesso con una sola chiamata identify(), che la documentazione dell'SDK descrive come un modo per "Identificare il visitatore corrente con i dettagli dell'utente". L'esempio documentato passa un ID utente, un'email e un nome: flowsery.identify({ userId: 'user_123', email: 'user@example.com', name: 'John Doe' }). L'API dei visitatori di Flowsery restituisce poi ID, nome ed email di quell'utente in un campo profilo, che è null per i visitatori anonimi. Il traffico anonimo funziona in modo diverso. Con l'opzione "Cookieless", Flowsery usa un hash del visitatore che cambia ogni giorno e non conserva dati personali, quindi non collega un visitatore anonimo da un giorno all'altro né da un dispositivo all'altro. Gli eventi personalizzati accettano metadati opzionali: il tag script ne registra uno con window.flowsery("signup") e l'SDK npm con flowsery.trackEvent('signup'), nell'ambito del tracciamento di obiettivi ed eventi di Flowsery. Gli eventi compaiono nel feed eventi in tempo reale di Flowsery appena scattano, senza nessun passaggio di registrazione in mezzo.

Domande frequenti

Qual è la differenza tra una proprietà utente e una dimensione personalizzata con ambito utente?

Una proprietà utente è il valore che invia il tuo codice, come customer_tier. Una dimensione personalizzata con ambito utente è la registrazione nell'Admin di GA4 che rende quella proprietà visibile nei report. Servono entrambe, e secondo Google la dimensione arriva nei report da 24 a 48 ore dopo la creazione.

Quante proprietà utente può avere una property GA4?

Una property standard può avere 25 proprietà utente e una property Google Analytics 360 ne può avere 100. Analytics non elabora la 26ª proprietà utente su una property standard. Le dimensioni personalizzate con ambito utente seguono gli stessi limiti di 25 e 100.

Le proprietà utente di GA4 si applicano agli eventi passati?

No. Google afferma che una proprietà utente si applica a tutti gli eventi futuri di quell'utente, comprese le sessioni successive, ma "non verrà applicata agli eventi avvenuti prima che fosse impostata". Imposta la proprietà il prima possibile, appena conosci il valore.

Come modifico una proprietà utente di GA4?

Invia di nuovo la proprietà con il nuovo valore. La guida per sviluppatori di Google dice che Analytics "usa il valore più recente di una proprietà utente per ogni utente", e GA4 raccoglie di nuovo la proprietà ogni volta che il suo valore cambia. Gli eventi precedenti conservano il valore che avevano quando sono stati inviati.

Posso usare user_id come nome di una proprietà utente?

No. user_id è uno dei cinque nomi riservati, insieme a first_open_time, first_visit_time, last_deep_link_referrer e first_open_after_install. I nomi inoltre non possono iniziare con google_, ga_ o firebase_. Per gli ID degli account usa la funzione User-ID.

Dove posso verificare che una proprietà utente stia arrivando?

Apri il report Tempo reale e guarda la scheda "Utenti per proprietà utente". Google spiega che la scheda "mostra il numero di persone raggruppate in ciascuna proprietà utente". Conferma lì la proprietà prima di costruirci sopra dei report.

Posso impostare le proprietà utente di GA4 in Google Tag Manager?

Sì. In un tag Evento di Google Analytics 4, aggiungi una riga nella sezione Proprietà utente per ogni proprietà che vuoi inviare. Registra poi ciascuna come dimensione personalizzata con ambito utente, altrimenti non comparirà nei report.

Perché la mia proprietà utente di GA4 non compare nei report?

Una proprietà utente resta fuori dai report finché la sua dimensione personalizzata non esiste e non ha finito l'elaborazione. Google spiega che la dimensione arriva nei report da 24 a 48 ore dopo la creazione. Controlla che l'ambito sia Utente e che il nome della proprietà coincida esattamente con quello inviato dal tuo codice, perché entrambi non si possono più modificare una volta salvati.

Una proprietà utente di GA4 può contenere un indirizzo email?

No. La policy di Google vieta di inviare qualsiasi dato che possa riconoscere come informazione di identificazione personale, e gli indirizzi email sono citati come esempio. Limita i valori a categorie brevi come pro, trial o admin.

Devo creare una proprietà utente per Paese o Lingua?

No. GA4 raccoglie già dimensioni utente predefinite come Paese, Lingua e Categoria di dispositivo, e Google dice di non crearne una personalizzata se una dimensione utente predefinita copre già quel dato. Tieni i tuoi 25 slot per le informazioni che conosce solo il tuo sito.