Quasi tutti i team che si lamentano dei dati di prodotto pensano di avere un problema di strumento. Cambiano Google Analytics con Mixpanel, Mixpanel con Amplitude, poi tornano a guardare il data warehouse, e dopo sei mesi i numeri non tornano ancora.
Il guasto di solito sta a monte: nessuno decide come si chiamano gli eventi, nessuno controlla che arrivino come previsto e nessuno risponde quando un rilascio rompe il funnel del checkout. Questo memo propone una decisione su chi possiede il tracking plan e 30 controlli concreti per tenerlo in piedi.
La decisione da prendere: a chi spetta il tracking plan
Il tracking plan è un documento semplice: l'elenco degli eventi che il prodotto invia, con le loro proprietà, i tipi di dato, i valori ammessi, il punto del codice che li genera e la domanda di business a cui rispondono. Diventa complicato perché tocca tre funzioni. Il prodotto lo vuole ricco, l'ingegneria lo vuole piccolo, il marketing lo vuole compatibile con i suoi strumenti pubblicitari.
Le opzioni realistiche sono tre. Nella prima il tracking plan appartiene agli sviluppatori, che aggiungono eventi quando scrivono una feature: è veloce, ma produce nomi diversi per la stessa azione. Nella seconda appartiene al marketing, che lo plasma intorno a GA4 e alle piattaforme di advertising: funziona per l'acquisizione e lascia scoperto il comportamento in prodotto. Nella terza un analista, o un piccolo gruppo di dati, fa da proprietario con un processo di revisione leggero.
La raccomandazione è la terza, con un vincolo: il proprietario ha potere di veto sui nomi, non sulle priorità. Decide come si chiama un evento e quali proprietà porta, mentre il product manager continua a decidere cosa misurare.
Un team di 8 sviluppatori che rilascia due volte a settimana genera, a stima, da 4 a 10 richieste di tracciamento al mese; una revisione asincrona di 15 minuti ciascuna costa meno di 3 ore mensili di un analista. Il costo dell'alternativa, cioè ripulire 18 mesi di eventi incoerenti, si misura in settimane.
Tassonomia degli eventi: dieci regole di naming
La convenzione più diffusa nei prodotti digitali è oggetto più azione al passato: Order Completed, Product Viewed, Signup Started. La rende popolare la specifica di Segment, ed è leggibile da chi non scrive codice. GA4 usa invece nomi in snake_case come add_to_cart o purchase per gli eventi consigliati, e per l'e-commerce conviene rispettarli, perché i report standard li riconoscono.
Le dieci regole di tassonomia, che sono i primi dieci controlli della checklist:
- un solo stile di scrittura in tutto il piano, per esempio snake_case, senza eccezioni;
- struttura oggetto_azione con verbo al passato (cart_viewed, order_completed);
- nessun nome generico come click, button_pressed o event1;
- nessun dato variabile nel nome dell'evento: product_viewed con proprietà product_id, mai product_123_viewed;
- nomi entro 40 caratteri, che è il limite di GA4, anche se usi altri strumenti;
- solo lettere, numeri e trattino basso, con una lettera come primo carattere;
- nessun prefisso riservato di GA4 come ga_, google_ o firebase_;
- un glossario degli oggetti: se si dice order, nessuno scrive purchase o checkout per la stessa entità;
- un elenco chiuso di verbi ammessi, di solito non più di 12;
- eventi di sistema (errori, timeout) separati con un prefisso dedicato, per non mescolarli alle azioni dell'utente.
Sembrano pignolerie. Il loro effetto si vede quando un analista scrive una query: con 3 varianti dello stesso evento un funnel a 4 passi richiede 12 combinazioni da controllare, e una se ne dimentica sempre.
Proprietà, tipi e valori ammessi
Gli eventi dicono cosa è successo; le proprietà dicono in quale contesto. Qui si nasconde la maggior parte degli errori silenziosi, perché una proprietà sbagliata non fa fallire nulla: arriva, viene salvata e corrompe i report in modo invisibile. Un prezzo inviato come stringa «49,90» con la virgola italiana, invece che come numero 49.90, produce somme a zero in metà degli strumenti.
Gli otto controlli sulle proprietà:
- ogni proprietà ha un tipo dichiarato (stringa, numero, booleano, data ISO 8601);
- gli importi sono numeri con il punto decimale e la valuta in una proprietà separata (currency: EUR);
- le proprietà con valori finiti hanno un elenco chiuso (payment_method: card, paypal, bank_transfer);
- le proprietà comuni a tutti gli eventi stanno in un contesto globale e non vengono ripetute evento per evento;
- nessun dato personale in chiaro: email, telefono e codice fiscale non entrano mai come proprietà;
- gli identificativi utente seguono una sola regola, per esempio user_id solo dopo il login;
- in GA4 ogni evento resta sotto le 25 proprietà personalizzate;
- ogni proprietà ha una riga di descrizione con un esempio reale di valore.
Il controllo sui dati personali merita attenzione in Italia. Il Garante per la protezione dei dati personali ha già dichiarato non conforme, nel giugno 2022, l'uso di Google Analytics in un caso concreto per il trasferimento di dati verso gli Stati Uniti. Un tracking plan che documenta cosa si invia, e cosa no, è anche il primo documento che chiede un DPO durante una verifica.
Convenzioni e strumenti a confronto
La scelta dello strumento conta meno della disciplina, ma cambia quanto costa mantenerla. La tabella confronta le opzioni più comuni per un team di prodotto tra 5 e 50 persone.
| Opzione | Dove vive il piano | Validazione automatica | Adatto a | Limite principale |
|---|---|---|---|---|
| Foglio di calcolo condiviso | Google Sheets o Excel | Nessuna, solo manuale | Team sotto i 20 eventi | Si disallinea dal codice in poche settimane |
| Avo | Piattaforma dedicata con codice generato | Sì, tipi verificati in sviluppo | Team con più piattaforme (web, iOS, Android) | Costo e curva di adozione per gli sviluppatori |
| Segment Protocols | Dentro Segment | Sì, blocco o segnalazione degli eventi fuori piano | Chi usa già Segment come CDP | Legato all'ecosistema Segment |
| Amplitude Data | Dentro Amplitude | Sì, su eventi in ingresso | Chi analizza principalmente in Amplitude | Meno utile se i dati finiscono altrove |
| Mixpanel Lexicon | Dentro Mixpanel | Parziale: descrizioni e occultamento | Pulizia di un piano esistente | Documenta più che prevenire |
Il foglio di calcolo resta una scelta onesta per partire. Diventa un rischio quando gli eventi superano la trentina e i rilasci sono settimanali: a quel punto la distanza tra documento e codice cresce a ogni sprint, e il piano descrive un prodotto che non esiste più.
QA prima del rilascio: sette controlli in staging
Il momento più economico per trovare un errore di tracciamento è prima del merge. Dopo il rilascio lo stesso errore costa dati persi, che non si recuperano: un evento di checkout mancante per 9 giorni lascia un buco permanente in ogni analisi di coorte che attraversa quel periodo.
I sette controlli da fare in staging, idealmente nella definizione di done della storia:
- l'evento compare nel debugger dello strumento (DebugView in GA4, Live View in Amplitude o Mixpanel) con il nome esatto del piano;
- ogni proprietà obbligatoria è presente e del tipo previsto;
- l'evento parte una sola volta per azione, anche con doppio clic o ricaricamento della pagina;
- l'evento parte anche quando l'azione fallisce, se il piano prevede un evento di errore;
- il comportamento con consenso negato è quello documentato;
- lo user_id resta coerente prima e dopo il login, senza creare due utenti distinti;
- il test copre almeno un browser mobile reale, perché Safari su iOS limita cookie e storage in modo diverso da Chrome desktop.
Il controllo sul doppio invio è quello che salta più spesso. Un pulsante «Acquista» che spara order_completed due volte quando l'utente torna indietro con il browser gonfia il fatturato in analytics. Il confronto con il gestionale degli ordini rivela la differenza solo a fine mese.
Monitoraggio in produzione: cinque allarmi
Il QA in staging non vede tutto. Il traffico reale contiene versioni vecchie dell'app, estensioni che bloccano script, utenti che arrivano da deep link mai testati. Servono quindi controlli continui, possibilmente automatici, che avvisano un canale preciso quando qualcosa devia.
I cinque allarmi minimi:
- volume giornaliero di ogni evento critico fuori da una banda, per esempio più o meno 30% rispetto alla media dello stesso giorno nelle 4 settimane precedenti;
- comparsa di eventi o proprietà non presenti nel piano;
- quota di eventi con proprietà obbligatorie vuote sopra il 2%;
- scarto tra ordini in analytics e ordini nel sistema gestionale sopra il 5% su base settimanale;
- calo improvviso del rapporto tra due passi consecutivi del funnel, come checkout_started su cart_viewed.
Un esempio illustrativo dei numeri. Un negozio online registra in media 1.200 order_completed al giorno nel gestionale e 1.150 in analytics: lo scarto del 4% è fisiologico per blocchi pubblicitari e consenso negato. Dopo un rilascio dell'app iOS, analytics scende a 890 ordini mentre il gestionale resta a 1.210. Lo scarto passa al 26% e l'allarme scatta il giorno stesso, invece che alla riunione mensile.
Il costo delle tre opzioni in un anno
Per rendere la decisione confrontabile conviene stimare il costo annuo di ciascuna opzione. I numeri che seguono sono illustrativi, calcolati per un team con 8 sviluppatori, un analista e circa 40 eventi.
Con il tracking plan lasciato agli sviluppatori non ci sono costi diretti, ma ogni trimestre l'analista passa a stima 5 giorni a riconciliare nomi e duplicati: 20 giorni l'anno, circa 8.000 euro a un costo aziendale di 400 euro al giorno. Con il piano in mano al marketing la riconciliazione cala, ma il comportamento in prodotto resta coperto a metà, e ogni domanda sulla retention richiede un tracciamento nuovo con due o tre settimane di attesa.
L'opzione consigliata costa circa 3 ore al mese di revisione, 36 ore l'anno, più un eventuale strumento di validazione. Anche aggiungendo una licenza di qualche migliaio di euro, il totale resta sotto quello della riconciliazione continua. Il vero risparmio però sta altrove: nelle decisioni prese su un funnel che misura davvero ciò che succede.
Il limite di questo calcolo va detto. In un'azienda con un solo prodotto web, 15 eventi e rilasci mensili, il processo di revisione formale è sovradimensionato: basta un foglio di calcolo e una persona che lo aggiorna.
Domande che i team fanno sul tracking plan
Quanti eventi deve contenere un tracking plan iniziale? Per un e-commerce o un SaaS appena avviato bastano spesso da 15 a 25 eventi ben definiti. Oltre i 60 eventi senza un responsabile, la quota di eventi mai interrogati in dashboard tende a crescere più in fretta del valore.
Il tracking plan va scritto in inglese o in italiano? Nomi di eventi e proprietà conviene scriverli in inglese e in ASCII, perché finiscono in SQL, API e strumenti esterni. Descrizioni, definizioni di business ed esempi possono restare in italiano per chi li legge.
Come si gestisce il consenso cookie nel tracking plan? Ogni evento dovrebbe indicare la base giuridica e se parte prima o dopo il consenso. In Europa con Google Consent Mode v2 gli hit senza consenso arrivano senza identificativi, quindi i conteggi grezzi e quelli modellati vanno tenuti distinti nei report.
Ogni quanto si rivede la tassonomia? Una revisione trimestrale di 60 minuti basta per la maggior parte dei team: si archiviano gli eventi senza query negli ultimi 90 giorni e si uniscono i duplicati emersi nel frattempo.
Il compromesso, alla fine, è tra velocità e affidabilità. Un piano governato da un proprietario rallenta ogni nuova feature di qualche ora e obbliga gli sviluppatori a una disciplina che all'inizio pesa. In cambio, dopo un anno, il team può rispondere a una domanda sulla conversione in 20 minuti invece che in due settimane. Per un prodotto che rilascia ogni settimana e decide su quei numeri, lo scambio conviene; per un sito vetrina con dieci eventi, no.