Vai al contenuto

Il piano di tracciamento degli eventi per startup

Un piano di tracciamento degli eventi (tracking plan) è la specifica viva di ogni evento che registri: il nome, le proprietà, quando scatta e chi ne è responsabile. Per una startup conviene partire in piccolo: gli 8–10 eventi che descrivono il funnel dalla registrazione all’attivazione fino ai ricavi. Aggiungine altri solo quando una domanda reale lo richiede.

Aggiornato: 7 min di letturaDi fromHello

Punti chiave

  1. Un piano di tracciamento è una specifica viva, non un documento da scrivere una volta: nome, proprietà, trigger e responsabile per ogni evento.

  2. Parti con 8–10 eventi lungo registrazione → attivazione → ricavi. Aggiungi un evento solo quando una domanda reale lo richiede.

  3. Scegli una convenzione di nomi (object_action, per esempio subscription_started) e non infrangerla mai: la deriva distrugge l’analisi in silenzio.

  4. Decidi chi è responsabile del piano e dove vivono i dati (first-party, self-hosted o SaaS) prima della prima chiamata track().

Cos’è un piano di tracciamento

Un piano di tracciamento è un unico documento che elenca ogni evento registrato dal tuo prodotto, le proprietà associate a ciascuno, il momento esatto in cui scatta e la persona che ne risponde. È il contratto tra il codice che emette i dati e le dashboard che li leggono. Trattalo come una specifica viva che cambia con il prodotto, non come un documento da scrivere una volta e dimenticare. Per la versione in una riga, leggi piano di tracciamento; questa guida spiega come costruirne uno.

I quattro termini che compongono un piano di tracciamento, dall’unità più piccola (un evento) alla specifica che li governa tutti.

Perché un piano batte il tracciamento improvvisato

Senza un piano, il tracciamento si accumula. Uno sviluppatore invia signup, un altro Sign Up, un terzo user_registered: tre nomi per un’azione sola, e ogni funnel che passa dalla registrazione si divide o si rompe senza che nessuno se ne accorga. Questa è la deriva, ed è il motivo principale per cui si smette di fidarsi dell’analisi. Un piano fissa il vocabolario prima che il codice vada in produzione, così i numeri che estrai tra sei mesi significano ancora ciò che pensi. Eventi puliti e coerenti sono anche ciò su cui si regge una roadmap di sperimentazione: non puoi misurare un test su una metrica che registri in tre modi diversi.

Chiama gli eventi object_action e non derogare

La convenzione che la maggior parte degli strumenti di analisi consiglia è object_action: l’oggetto, poi ciò che gli è successo, come subscription_started, invite_sent, checkout_completed. Segment, Amplitude e PostHog descrivono ciascuno una variante (Segment usa “Object Action”, PostHog lo snake_case minuscolo, Amplitude un sostantivo più un verbo al passato). Maiuscole e minuscole contano molto meno che scegliere una convenzione e non infrangerla mai. Due regole portano quasi tutto il valore: mantieni coerente il tempo verbale e non costruire mai nomi di eventi in modo dinamico. Un evento chiamato plan_${name}_upgraded crea un evento per ogni cliente e diventa impossibile da interrogare.

Gli 8–10 eventi che descrivono il tuo funnel

Resisti alla tentazione di tracciare tutto. Parti dai pochi eventi che seguono un utente dal primo contatto al pagamento (registrazione, attivazione e ricavi) e strumentali bene prima di aggiungere profondità. Qui sotto trovi un set di partenza per un tipico SaaS B2B; rinominali con i sostantivi del tuo prodotto. Ognuno diventa una riga del piano e, insieme, formano il tuo primo insieme di dati first-party: la materia prima di ogni funnel, coorte e curva di retention che costruirai. Dove strumentare ogni evento, nel browser o sul server, è una decisione a parte: tracciamento server-side e client-side spiega come dividerli.

EventoQuando scattaPerché conta
account_createdL’utente completa la registrazione ed esiste un recordCima del funnel; il denominatore di ogni tasso di conversione
onboarding_startedL’utente entra nel flusso del primo avvioSepara gli utenti registrati che iniziano la configurazione da quelli che abbandonano
activation_reachedL’utente raggiunge l’aha moment che hai definito (per esempio il primo progetto condiviso)L’evento iniziale più predittivo; convalidalo, non darlo per scontato
feature_usedViene usata una funzione centrale, con una proprietà feature_nameProfondità di coinvolgimento; input per segmenti e retention
invite_sentL’utente invita un collegaIndicatore anticipatore di espansione e stickiness nel B2B
trial_startedInizia una prova o un piano gratuitoApre il funnel dei ricavi; fa da base al tasso di conversione da prova a pagamento
subscription_startedL’utente passa a un piano a pagamentoIl momento dei ricavi; collega il lavoro di growth al fatturato
subscription_cancelledL’utente abbandona un piano a pagamentoSegnale di churn; alimenta la riconquista e l’analisi della retention

Le proprietà portano i dettagli, i responsabili tengono tutto in ordine

Tieni gli eventi pochi e generici; sposta i dettagli nelle proprietà. Invece di un evento separato per ogni piano, invia subscription_started con le proprietà plan_name e amount_usd: un solo evento, descritto bene, resta interrogabile. Mantieni snello il set di proprietà di ogni evento: poche proprietà che interroghi davvero valgono più di decine che non usi mai. Poi decidi chi ne è responsabile: nella maggior parte dei piccoli team è un Growth Engineer o chiunque rilasci la strumentazione, e ogni nuovo evento dovrebbe passare da questa persona perché piano e codice non si separino mai. Infine, sappi dove arrivano gli eventi. Inviarli a uno strumento di analisi ospitato o a una CDP è rapido, ma mette i tuoi dati comportamentali sui server di qualcun altro; tenerli first-party (Postgres self-hosted, il tuo data warehouse) li lascia tuoi, ed è il compromesso centrale tra open source e SaaS negli strumenti di engagement.

FAQ

Domande frequenti

  • Quanti eventi dovrebbe tracciare una startup?

    Parti con 8–10, gli eventi che descrivono registrazione, attivazione e ricavi, e aggiungine altri solo quando una domanda precisa li richiede. Tracciare tutto fin dall’inizio crea rumore che devi mantenere e che interroghi di rado. È più facile aggiungere più avanti un evento con un buon nome che districare cento eventi incoerenti.

  • Qual è la migliore convenzione di nomi per gli eventi?

    object_action (il sostantivo, poi ciò che è successo) è la più consigliata: subscription_started, invite_sent. Segment, Amplitude e PostHog ne pubblicano ciascuno una variante. La convenzione migliore è quella che applichi con coerenza: maiuscole e tempo verbale contano meno del non infrangere mai la regola e del non generare nomi in modo dinamico.

  • Che differenza c’è tra un evento e una proprietà?

    Un evento è l’azione (subscription_started); una proprietà è un dettaglio su quell’azione (plan_name, amount_usd). Tieni gli eventi pochi e generici e sposta i dettagli nelle proprietà, così un evento ben descritto resta interrogabile invece di frammentarsi in decine di quasi-duplicati.

  • I dati di tracciamento devono stare in uno strumento SaaS o in self-hosting?

    Vanno bene entrambe le strade. Uno strumento di analisi ospitato o una CDP è più rapido per iniziare; il self-hosting (il tuo Postgres o il tuo data warehouse) tiene i dati comportamentali sulla tua infrastruttura ed evita il lock-in. Per un team tecnico che tratta i dati dei clienti come first-party, il self-hosting è spesso la scelta migliore nel lungo periodo. Decidi prima di strumentare, perché migrare gli eventi in seguito è doloroso.

fromHello è un software di marketing automation open source: messaggi attivati da ciò che fanno le persone.

fromHello Cloud è in accesso anticipato tramite la lista d’attesa.

Accesso anticipato

fromHello Cloud

Non si parte per restare piccoli.

L’accesso anticipato a fromHello Cloud si apre a scaglioni. L’onboarding è guidato: ti aiutiamo a configurare tutto e a portare i tuoi contatti.

Ti scriveremo quando il tuo accesso sarà pronto. Niente spam.

Vuoi aspettare ancora un po’? Vedi su GitHub