Come una convenzione per i nomi degli eventi sopravvive al primo rinominamento

Perché la convenzione di denominazione degli eventi è importante?

Scegliere una convenzione di denominazione costa poco il primo giorno e molto il duecentesimo, perché Google Analytics 4 non applica mai una rinomina ai dati che ha già raccolto. Ogni nome incoerente che pubblichi diventa una seconda riga permanente in tutti i report raggruppati per evento, e l'unico modo per unire quelle righe in seguito è ricalcolare i dati da solo in un data warehouse.

Il problema non è teorico e non è ordinato. Tre sviluppatori strumentano lo stesso pulsante in tre sprint diversi e ottieni signup_click, SignupClick e click_signup. GA4 li tratta come tre eventi separati, perché "i nomi degli eventi distinguono tra maiuscole e minuscole. Ad esempio, my_event e My_Event sono eventi distinti." Il funnel si divide in tre, il conteggio degli eventi chiave è un terzo della realtà e nessuno se ne accorge finché qualcuno non confronta la dashboard con Stripe. La disciplina più generale è trattata in tracciamento degli eventi. Questa pagina riguarda solo i nomi.

Quali nomi GA4 rifiuta a priori?

GA4 rifiuta i nomi riservati e i prefissi riservati, e le regole di Google sui nomi degli eventi ne spiegano chiaramente la conseguenza: "Se provi a usare un prefisso o un nome riservato, Analytics mostrerà un messaggio di errore." Le regole che valgono per ogni nome sono poche:

• "I nomi degli eventi devono iniziare con una lettera. Usa solo lettere, numeri e trattini bassi. Non usare spazi."
• "I nomi degli eventi distinguono tra maiuscole e minuscole."
• "I nomi degli eventi possono contenere parole e lettere inglesi e non inglesi."

Per i flussi di dati web, Google riserva query_id come prefisso e riserva diciannove nomi di evento. Quelli che mettono in difficoltà un team di implementazione sono i nomi plausibili, quelli che ti verrebbe naturale scegliere:

Riservati sul web	Perché li sceglieresti d'istinto
click	Il nome più ovvio per qualsiasi gestore di click
error	Il nome più ovvio per un errore lato client
scroll	Il nome più ovvio per un evento di profondità di scorrimento
file_download	Il nome più ovvio per il download di un PDF
page_view	Il nome più ovvio per una visualizzazione di pagina virtuale in una single-page app
session_start	Il nome più ovvio per l'equivalente di un'apertura dell'app
user_engagement	Il nome più ovvio per un evento di tempo di permanenza
video_start	Il nome più ovvio per un evento del player
ad_impression	Il nome più ovvio per uno slot di annunci interni

La maggior parte di questi viene già inviata al posto tuo dalla misurazione avanzata, ed è per questo che sono riservati. Prima di dare un nome a qualsiasi cosa, controlla cosa raccoglie la tua proprietà senza alcuna configurazione. Per capire cosa cattura e cosa no la raccolta automatica, leggi acquisizione automatica.

Il riferimento del Measurement Protocol aggiunge una seconda lista, più lunga, valida quando invii gli eventi lato server. Include first_open, first_visit, app_exception, os_update e l'intera famiglia firebase_, e precisa che "gli eventi ad_impression, in_app_purchase e screen_view sono consentiti solo per i flussi App."

Anche i parametri hanno le loro riserve. Il nome firebase_conversion è riservato e i nomi dei parametri "non possono iniziare con" _, firebase_, ga_, google_ o gtag.. I nomi delle proprietà utente non possono iniziare con _, firebase_, ga_ o google_, e i nomi first_open_time, first_visit_time, last_deep_link_referrer, user_id e first_open_after_install sono già occupati.

Quali limiti di lunghezza si applicano?

Quaranta caratteri per il nome dell'evento, e la penalità per chi li supera è più strana di un semplice rifiuto. I limiti di raccolta degli eventi di Google indicano che il nome di un evento arriva a "40 caratteri", poi aggiungono: "Se contrassegni un evento come evento chiave e l'evento supera i 40 caratteri, non verrà registrato come evento chiave perché mancherà il suffisso _c aggiunto." L'evento viene comunque raccolto. Semplicemente smette di essere conteggiabile come evento chiave, in silenzio, perché GA4 aggiunge _c internamente e il nome così ottenuto va oltre il limite.

I limiti che lo circondano condizionano una convenzione quanto il limite sul nome:

Limite	Valore
Lunghezza del nome dell'evento	40 caratteri
Nomi di evento distinti, flusso web	Nessun limite
Nomi di evento distinti, flusso app	500 per utente dell'app
Parametri evento per evento	25
Lunghezza del nome del parametro	40 caratteri
Lunghezza del valore del parametro	100 caratteri
Valore di page_title	300 caratteri
Valore di page_referrer	420 caratteri
Valore di page_location	1.000 caratteri
Proprietà utente per proprietà	25
Lunghezza del nome della proprietà utente	24 caratteri
Lunghezza del valore della proprietà utente	36 caratteri

Il valore di 100 caratteri per i parametri è quello che coglie di sorpresa i team. Il nome di un prodotto, una query di ricerca o un messaggio di errore di un modulo lo supereranno, e il valore viene troncato invece di far rifiutare l'evento. Il limite di 24 caratteri per il nome della proprietà utente è ancora più stretto, e di sedici caratteri più corto di quello sul nome dell'evento: un buon motivo per non replicare i nomi degli eventi nei nomi delle proprietà utente.

Il numero illimitato di eventi distinti sul web è una trappola, non un permesso. Niente ti impedisce di pubblicare quattrocento nomi di evento, ma i report diventano inutilizzabili e ognuno va registrato come definizione personalizzata prima di comparire nella maggior parte delle analisi. Quel costo di registrazione è trattato in configurare le dimensioni personalizzate.

Prima l'oggetto o prima l'azione?

Il consiglio più diffuso è mettere l'oggetto per primo, cart_added e video_played, perché i report si ordinano in ordine alfabetico e i nomi con l'oggetto davanti raggruppano tutti gli eventi che riguardano la stessa cosa. È un buon consiglio, ma va contro quello che fa Google.

Gli eventi consigliati da Google partono dall'azione. Solo il set per il retail comprende add_payment_info, add_shipping_info, add_to_cart, add_to_wishlist, begin_checkout, purchase, refund, remove_from_cart, select_item, view_item, e il set generale aggiunge earn_virtual_currency, join_group, login, search, select_content, share, sign_up, spend_virtual_currency, tutorial_begin e tutorial_complete.

Conta perché gli eventi consigliati non sono un dettaglio estetico. Google li descrive come "eventi standardizzati per diversi settori (ad esempio retail, viaggi, giochi) che sbloccano pannelli di report predefiniti", mentre gli eventi personalizzati sono "eventi che definisci tu perché nessun evento automatico, di misurazione avanzata o consigliato risponde alle tue esigenze" e sono "accessibili tramite report personalizzati". Rinominare add_to_cart in cart_added per coerenza interna ti fa perdere i report ecommerce predefiniti.

La regola che funziona, quindi, si divide per origine e non per gusto. Usa la grafia di Google ovunque esista un evento consigliato, esattamente come è pubblicata, e applica il tuo schema con l'oggetto davanti solo agli eventi che Google non definisce. Una convenzione che produce add_to_cart accanto a pricing_table_viewed sulla carta sembra incoerente, ma è l'unica versione che mantiene sia i report sia l'ordinamento. Qualunque ordine tu scelga, lo snake_case in minuscolo è l'unica scrittura che evita la trappola della distinzione tra maiuscole e minuscole, perché una convenzione in cui qualsiasi carattere può cambiare di caso è una convenzione che prima o poi verrà violata.

Come scegliere l'ordine dell'evento

1

Controlla l'elenco consigliato. Verifica se Google definisce già un evento per ciò che stai tracciando, come add_to_cart o begin_checkout.

2

Trovi una corrispondenza. Usa la grafia esatta di Google, con l'azione per prima, per mantenere i report ecommerce predefiniti.

3

Nessuna corrispondenza. Applica il tuo schema con l'oggetto davanti, scegliendo da un elenco chiuso di verbi e oggetti.

Quanto costa rinominare un evento dopo il lancio?

Ti costa lo storico, in modo permanente, e ti costa uno slot su cinquanta. La documentazione di Google sulla rinomina degli eventi è chiara sulla prima parte: "Gli eventi modificati e quelli nuovi non si applicano ai dati storici." La modifica riscrive gli eventi solo da quel momento in avanti. Ogni riga già presente nella proprietà conserva il vecchio nome e non esiste alcuna rielaborazione che possa correggerlo.

Ci sono altri due vincoli. "Passa almeno un'ora prima che le modifiche abbiano effetto", quindi la correzione non è immediata nemmeno dopo averla fatta. E "puoi modificare fino a 50 eventi esistenti e creare fino a 50 eventi a partire da eventi esistenti", il che significa che la funzione di modifica è un kit di riparazione, non un livello di denominazione su cui appoggiarti all'infinito.

Il costo pratico di una singola rinomina, allora, è questo:

• Una divisione permanente in ogni report che raggruppa per nome evento, alla data della modifica.
• Ogni definizione di evento chiave, pubblico o funnel che fa riferimento al vecchio nome va duplicata sul nuovo, altrimenti smette di contare. La differenza tra i due concetti è spiegata in eventi chiave e conversioni.
• I confronti anno su anno a cavallo della data di modifica vanno ricuciti a mano.
• Uno dei cinquanta slot di modifica, occupato finché il vecchio nome continua ad arrivare da una pagina in cache o da una build dell'app non ancora rilasciata.

Niente di tutto questo si recupera pagando di più o aspettando più a lungo, ed è proprio per questo che vale la pena dedicare un pomeriggio al documento sui nomi prima che parta il primo tag.

Come si presenta una convenzione che funziona?

Una convenzione è fatta di quattro decisioni messe per iscritto, non di un elenco di nomi. Prendi ciascuna decisione una volta sola e l'elenco si genera da sé.

Scrittura: solo snake_case in minuscolo, sia per i nomi sia per i parametri. GA4 accetta comunque solo lettere, numeri e trattini bassi, e il minuscolo elimina l'unico modo in cui due eventi identici possono divergere.

Vocabolario: un elenco chiuso di verbi e un elenco chiuso di oggetti. view, select, add, remove, submit, start, complete coprono la maggior parte dei siti. Due verbi con lo stesso significato sono il modo in cui signup_submit e signup_complete finiscono entrambi in produzione.

Ordine: la grafia di Google dove esiste un evento consigliato, l'oggetto davanti in tutti gli altri casi, con l'eccezione scritta nel documento, così il prossimo sviluppatore non la normalizza di nascosto.

Posizione dei dettagli: i dettagli variabili vanno nei parametri, mai nel nome. form_submit con un parametro form_name è un solo evento che puoi filtrare. newsletter_form_submit, contact_form_submit e demo_form_submit sono tre eventi che non puoi confrontare senza costruire un report per ogni modulo, e consumano tre registrazioni di definizioni personalizzate invece di una.

Lunghezza: tieni i nomi sotto i 40 caratteri con un po' di margine, perché la penalità dell'evento chiave aggiunge _c a qualsiasi nome tu abbia scelto e l'errore avviene in silenzio.

Domande frequenti

Quali caratteri può contenere il nome di un evento GA4?

Lettere, numeri e trattini bassi, e il nome deve iniziare con una lettera. Google formula la regola così: "I nomi degli eventi devono iniziare con una lettera. Usa solo lettere, numeri e trattini bassi. Non usare spazi." Le lettere non inglesi sono ammesse: "I nomi degli eventi possono includere parole e lettere inglesi e non inglesi."

I nomi degli eventi GA4 distinguono tra maiuscole e minuscole?

Sì. Le regole di denominazione di Google dicono che "i nomi degli eventi distinguono tra maiuscole e minuscole. Per esempio, my_event e My_Event sono eventi diversi." Non esiste alcuna normalizzazione, quindi due grafie dello stesso evento producono due righe indipendenti in ogni report che raggruppa per nome evento.

Cosa succede se invio un nome evento riservato?

Analytics lo rifiuta e mostra un errore. Le regole sui nomi degli eventi dicono che "se provi a usare un prefisso o un nome riservato, Analytics mostrerà un messaggio di errore." Tra i nomi riservati sul web ci sono click, error, scroll, file_download, page_view, session_start, user_engagement e video_start.

Devo usare oggetto_azione o azione_oggetto?

Per gli eventi consigliati da Google usa la grafia esatta di Google, che mette prima l'azione. Per tutto il resto metti prima l'oggetto. Tra gli eventi consigliati ci sono add_to_cart, begin_checkout, select_item e view_item, e se li rinomini perdi i pannelli di reportistica predefiniti che Google collega a questi eventi.

Posso rinominare un evento GA4 dopo il lancio?

Puoi rinominarlo da quel momento in avanti, mai con effetto retroattivo. Google afferma che "gli eventi modificati e quelli nuovi non si applicano ai dati storici", che "prima che le modifiche abbiano effetto passa almeno un'ora" e che "puoi modificare fino a 50 eventi esistenti e creare fino a 50 eventi basati su eventi esistenti."

Quanto può essere lungo il nome di un evento GA4?

40 caratteri. Superare il limite ha una conseguenza precisa oltre al rifiuto: Google avverte che "se contrassegni un evento come evento chiave e l'evento supera i 40 caratteri, non verrà riportato come evento chiave perché mancherà il suffisso _c aggiunto."

Cosa succede se un team pubblica nomi di eventi incoerenti?

GA4 tratta ogni grafia come un evento separato, perché i nomi degli eventi distinguono tra maiuscole e minuscole. Se tre sviluppatori chiamano lo stesso pulsante signup_click, SignupClick e click_signup, ottieni tre righe separate in ogni report, il funnel si divide in tre e il conteggio degli eventi chiave scende a un terzo del totale reale. Nessuno se ne accorge finché qualcuno non confronta la dashboard con un'altra fonte di dati come Stripe.

C'è un limite al numero di nomi evento che posso inviare a GA4?

Un flusso web non ha limiti sul numero di nomi evento distinti, ma questa assenza di limiti ti gioca contro invece di aiutarti. I nomi degli eventi compaiono da soli, ma ogni parametro che alleghi richiede uno slot di definizione personalizzata, quindi quattrocento nomi ti regalano report che nessuno riesce a leggere. Un flusso app invece ha un tetto, 500 eventi distinti per utente dell'app.

Qual è la differenza tra un evento personalizzato e un evento consigliato?

Un evento consigliato è uno dei nomi standardizzati di Google per un settore, come retail o viaggi, e secondo Google sblocca pannelli di reportistica predefiniti. Un evento personalizzato lo definisci tu perché nessun evento automatico, di misurazione avanzata o consigliato di Google è adatto, e compare solo nei report personalizzati che crei. Se rinomini un evento consigliato come add_to_cart per coerenza interna, perdi il pannello predefinito che lo accompagna.

Gli eventi chiave continuano a contare dopo che rinomino l'evento che monitorano?

Non in automatico. Ogni definizione di evento chiave, pubblico o funnel che puntava al vecchio nome va duplicata sul nuovo, altrimenti smette di contare nel momento in cui la rinomina diventa effettiva. Questa duplicazione non consuma nessuno slot di modifica. Solo la rinomina in sé ne usa uno dei cinquanta che GA4 concede.