Come i parametri evento di GA4 portano il dettaglio dietro ogni evento

Che cosa sono i parametri evento di GA4?

Ogni evento che Google Analytics 4 registra porta con sé dei parametri evento GA4, le coppie chiave-valore che dicono quale link è stato cliccato, quanto valeva un acquisto o quale prodotto ha visualizzato un visitatore. Il nome dell'evento dice che cosa è successo. I parametri dicono i dettagli. La guida di Google per sviluppatori lo riassume in una riga: "I parametri forniscono informazioni aggiuntive sui modi in cui gli utenti interagiscono con il tuo sito web."

Il Centro assistenza di Google traccia la stessa distinzione tra i tre livelli di dati di GA4: "Gli eventi misurano ciò che gli utenti fanno sul tuo sito web o sulla tua app, come cliccare un link o guardare un video. I parametri evento forniscono più dettagli su queste azioni, per esempio quale link è stato cliccato o quanta parte del video ha guardato un utente. Le proprietà utente ti dicono di più sugli utenti stessi." Se il modello a eventi per te è ancora nuovo, parti dal tracciamento degli eventi e poi torna qui per il livello dei parametri.

Quali parametri raccoglie GA4 senza scrivere codice?

GA4 collega una serie di parametri a ogni evento di un flusso web, eventi personalizzati compresi, prima ancora che tu scriva una riga di codice di tracciamento. L'elenco di Google dei parametri "raccolti per impostazione predefinita con ogni evento, inclusi gli eventi personalizzati" cita language, page_location, page_referrer, page_title e screen_resolution per i flussi web. GA4 genera inoltre ga_session_id e ga_session_number a ogni sessione e invia engagement_time_msec con eventi come user_engagement e page_view.

Gli eventi consigliati aggiungono un secondo livello, cioè parametri che Google ha già battezzato e collegato ai report predefiniti. L'evento purchase è quello che usano quasi tutti i team:

Il riferimento di Google aggiunge una regola che, se ignorata, rompe i report sui ricavi: "Se imposti value, allora currency è obbligatorio perché le metriche di ricavo vengano calcolate in modo accurato." I parametri degli eventi raccolti automaticamente e degli eventi consigliati alimentano dimensioni e metriche predefinite. Tutto quello che inventi tu no.

Come si invia un parametro evento personalizzato?

Un parametro evento personalizzato si invia aggiungendolo come coppia chiave-valore nel terzo argomento della chiamata gtag('event', ...). La guida di Google indica la struttura gtag('event', '<event_name>', {<event_parameters>}); con questo esempio:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

Qui app_name e screen_name sono i nomi dei parametri, mentre myAppName e Home sono i valori. Per collegare un parametro a ogni evento di una pagina, inseriscilo invece nel comando config, come in gtag('config', 'G-XXXXXXXXXX', {'page_title': 'Contact Us', 'currency': 'EUR'}). Google sconsiglia la terza opzione per i valori personalizzati: "Il comando set potrebbe non propagare in modo affidabile i parametri personalizzati a tutti i flussi di misurazione di Google Analytics." Per tutto ciò che hai inventato tu usa event o config.

Controlla il risultato nel report Tempo reale o in DebugView. Secondo Google, "Questi report mostrano i dati man mano che arrivano." DebugView elenca l'insieme unificato, compresi i valori applicati a livello globale, nella scheda Parametri dell'evento.

Perché un parametro personalizzato non compare nei report di GA4?

Un parametro personalizzato non compare nei report di GA4 perché Google lo include nei report solo dopo che lo hai registrato come dimensione o metrica personalizzata. La guida per sviluppatori lo dice senza giri di parole: "Senza questa registrazione, i dati del parametro vengono raccolti ma non sono disponibili per i report." Tempo reale e DebugView mostrano il valore grezzo, ed è per questo che un parametro può sembrare a posto nei test e mancare comunque da ogni esplorazione una settimana dopo.

La registrazione richiede due minuti nella schermata di amministrazione. La pagina di assistenza di Google elenca i passaggi:

1. In Amministrazione, sotto Visualizzazione dati, clicca su Definizioni personalizzate.
2. Apri la scheda Dimensioni personalizzate e clicca su Crea dimensioni personalizzate.
3. Inserisci un Nome dimensione. Google qui accetta trattini bassi e spazi, ma non trattini.
4. Imposta l'Ambito su Evento.
5. In Parametro evento, scrivi il nome del parametro esattamente come lo invia il tuo codice.
6. Clicca su Salva.

Due campi non si possono annullare. Google segnala sia Ambito sia Parametro evento con "Non puoi modificare questo campo dopo aver salvato la nuova dimensione." Un errore di battitura nel nome del parametro significa eliminare la dimensione e ricrearla. Dopo il salvataggio, Google dice che puoi aggiungere la dimensione ai report "dopo 24-48 ore da quando i dati personalizzati sono stati inviati e la dimensione personalizzata è stata creata." In quella finestra la dimensione risulta come una delle cause documentate di (not set) in GA4. Le pagine di Google non dicono nulla sul recupero dei valori raccolti prima che la dimensione esistesse, quindi registra la dimensione lo stesso giorno in cui rilasci il parametro.

I numeri seguono un'altra strada. Un parametro che misura una quantità, come i secondi guardati o gli articoli nel carrello, va in una metrica personalizzata. La regola di Google è che per "i dati categorici, invece, come il testo cliccato o la pagina visualizzata, è più indicato usare una dimensione personalizzata con ambito evento."

Quali limiti valgono per i parametri evento di GA4?

I parametri evento di GA4 sono limitati a 25 per evento, 40 caratteri per il nome e 100 caratteri per il valore, e Google non registra nulla che superi questi tetti. La pagina sui limiti di raccolta dice: "Google Analytics non registra eventi, parametri evento e proprietà utente che superano i seguenti limiti."

Google dice che passare ad Analytics 360 permette di "aumentare alcuni limiti (ma non i limiti di caratteri di eventi e parametri)", quindi la lunghezza di nomi e valori resta la stessa su ogni proprietà. Per la maggior parte dei siti il limite che pesa davvero sono le 50 dimensioni personalizzate con ambito evento, non i 25 parametri per evento, perché ogni dimensione copre un nome di parametro in tutti gli eventi che lo inviano. Raggiungere il tetto delle dimensioni ha anche un costo: Google dice che "dovrai aspettare 48 ore dopo aver eliminato delle dimensioni per aggiungerne di nuove."

Quali nomi di parametro riserva GA4?

GA4 riserva cinque prefissi e un elenco di nomi per i parametri degli eventi, e un nome riservato non può alimentare una dimensione personalizzata. Le regole di denominazione di Google dicono che i nomi dei parametri "non possono iniziare" con un trattino basso, firebase_, ga_, google_ o gtag.. I nomi riservati per dimensioni e metriche personalizzate sono cid, currency, customer_id, customerid, dclid, gclid, session_id, sessionid, sfmc_id, sid, srsltid, uid, user_id e userid.

Per gli eventi maiuscole e minuscole contano, e la stessa abitudine vale anche per i parametri. Le regole di Google dicono: "I nomi degli eventi distinguono tra maiuscole e minuscole. Ad esempio, my_event e My_Event sono eventi distinti." Scegli uno stile, come lo snake case minuscolo, e usalo sia per gli eventi sia per i parametri, così Plan e plan non finiscono mai in due colonne separate.

Cosa non va mai inviato come parametro di un evento?

Dati personali e identificatori univoci non vanno mai inviati come parametri di eventi GA4. La policy di Google chiede che "a Google non vengano trasmessi dati che Google potrebbe usare o riconoscere come informazioni personali identificabili (PII)", con indirizzi email, numeri di cellulare personali e codici fiscali come esempi. La fuga più comune è un valore di un modulo o una query string dell'URL copiati in un parametro, come spiega la sezione su eventi e parametri in come Google Analytics raccoglie i dati degli utenti.

I valori univoci causano un secondo problema anche quando non sono personali. Google sconsiglia alle proprietà standard di creare "dimensioni personalizzate inutili ad alta cardinalità" e porta tre esempi: un ID univoco per utente, un ID univoco per sessione e un timestamp. Queste dimensioni "possono influire negativamente su report ed esplorazioni e far confluire i dati nella riga (other)." Invia categorie, come plan: pro o method: google, e non valori diversi a ogni hit.

C'è poi una regola di interpretazione che coglie di sorpresa molti team. Google avverte che "qualsiasi valore di una dimensione personalizzata che assomigli a un numero verrà trattato come un numero, anche se in origine era formattato come testo", quindi un valore testuale "94E40" viene letto come notazione scientifica. Aggiungi un prefisso ai codici che sembrano numerici, come sku_94E40, per mantenerli come testo.

Come gestisce Flowsery i dati degli eventi personalizzati?

Flowsery registra un evento personalizzato con una sola chiamata come window.flowsery("signup"), senza tag manager e senza un passaggio di registrazione delle dimensioni personalizzate tra il codice e la dashboard. Il suo tracciamento di obiettivi ed eventi copre clic sui pulsanti, invii di moduli, download di file e riproduzioni di video, ti permette di associare valori di ricavo agli eventi e mostra ogni evento in un feed in tempo reale mentre scatta, così controlli il tracciamento nel momento in cui lo pubblichi. Gli eventi vengono tracciati senza cookie e senza dati personali. Se stai spostando un piano eventi fuori da GA4, il confronto in tracciamento di eventi personalizzati nelle analytics privacy-first e in GA4 spiega quali abitudini di GA4 conviene lasciare per strada.

Domande frequenti

Quanti parametri può avere un evento GA4?

Un evento GA4 può contenere 25 parametri su una proprietà standard. Google non registra i parametri oltre questo limite, quindi i valori in più non arrivano mai ai report. Analytics 360 alza alcuni limiti, ma non quelli di 40 caratteri per il nome e 100 caratteri per il valore.

Perché vedo il mio parametro in DebugView ma non nei report?

DebugView e Tempo reale mostrano i parametri grezzi appena arrivano, mentre i report standard e le esplorazioni mostrano solo i parametri personalizzati che hai registrato come dimensioni o metriche personalizzate. Registra il parametro da Amministrazione, Definizioni personalizzate, poi attendi da 24 a 48 ore prima di vedere i dati.

Che differenza c'è tra un parametro dell'evento e una dimensione personalizzata?

Un parametro dell'evento è la coppia chiave-valore che il tuo codice invia con un evento. Una dimensione personalizzata è il campo di report che crei in GA4 e che legge un nome di parametro su tutti gli eventi che lo inviano. Una sola dimensione personalizzata a livello di evento copre un parametro su tutti gli eventi che vuoi.

Le dimensioni personalizzate si applicano ai dati raccolti prima della loro creazione?

Le pagine di aiuto di Google non dicono che le dimensioni personalizzate recuperino i dati precedenti. Dicono che puoi usare una dimensione da 24 a 48 ore dopo l'invio dei dati e la creazione della dimensione. Registra la dimensione il giorno in cui il parametro va online, per evitare un buco nei dati.

Posso inviare uno user ID come parametro di un evento?

Non registrare uno user ID come dimensione personalizzata a livello di evento. user_id è nell'elenco dei nomi riservati di Google, e Google cita l'ID univoco per utente tra le dimensioni ad alta cardinalità da evitare. Per questo caso Google rimanda alla sua funzione User-ID.

Cosa succede a un valore di parametro più lungo di 100 caratteri?

GA4 non registra un valore di parametro che supera il limite previsto per quel parametro. Il limite è di 100 caratteri per la maggior parte dei parametri, con eccezioni di 300 per page_title, 420 per page_referrer e 1.000 per page_location. Accorcia i valori lunghi o associali a categorie brevi prima di inviarli.

Posso usare il comando set di gtag per inviare un parametro personalizzato?

Google lo sconsiglia. Il comando set potrebbe non propagare in modo affidabile i parametri personalizzati a tutti i flussi di misurazione di Google Analytics. Invia i valori personalizzati con event o config, i due comandi che Google raccomanda per questo compito.

Quanti parametri personalizzati può avere un articolo ecommerce?

La tabella dei limiti fissa a 27 per evento ecommerce i parametri personalizzati a livello di articolo, in aggiunta ai parametri articolo che GA4 prevede già, come item_id e item_name. Questo tetto è separato dal limite di 25 parametri sull'evento stesso.

Il nome di una dimensione personalizzata può contenere un trattino?

La regola di Google nella schermata di amministrazione consente trattini bassi e spazi nel nome di una dimensione personalizzata, ma non trattini. Usa solo lettere, numeri, trattini bassi e spazi per evitare un errore di convalida quando salvi la dimensione.

Cosa succede se elimino per errore una dimensione personalizzata?

L'attesa scatta una volta raggiunto il limite delle dimensioni personalizzate. La nota di Google dice: "Se raggiungi il limite delle dimensioni personalizzate, dovrai attendere 48 ore dopo l'eliminazione delle dimensioni per aggiungerne di nuove." Con tutti i 50 slot a livello di evento occupati, eliminare quella sbagliata per fare spazio ti costa due giorni prima di poterla ricreare.