Vai al contenuto

Piano di tracciamento

Un piano di tracciamento (tracking plan) è la specifica viva di ogni evento di analytics che un prodotto traccia: il nome di ogni evento, le sue proprietà, quando scatta e chi ne è responsabile. È il contratto tra chi rilascia il codice e chi legge i dati, così lo stesso comportamento viene sempre registrato allo stesso modo.

Aggiornato: 2 min di letturaDi fromHello

Punti chiave

  1. Una riga per evento (nome, proprietà, trigger, responsabile), e il piano cambia nella stessa pull request del codice.

  2. Un’unica convenzione di nomi, di solito oggetto_azione in snake_case (subscription_started), mantiene gli eventi interrogabili anche a distanza di mesi.

  3. La deriva (nomi cambiati, duplicati, proprietà mancanti) corrompe in silenzio funnel, segmenti e ogni report a valle.

Cosa c’è in un piano di tracciamento?

Come minimo, una riga per evento: il nome dell’evento, le proprietà associate, il momento esatto in cui scatta e la persona che ne è responsabile. I piani fatti bene registrano anche quali strumenti ricevono l’evento e a quale domanda l’evento deve rispondere: un evento che nessuno interroga è manutenzione senza ritorno. Il formato conta meno dell’abitudine: un foglio di calcolo, un file versionato nel repository o uno strumento di schema come Segment Protocols o Amplitude Data vanno tutti bene, purché il piano venga aggiornato nella stessa pull request del codice di tracciamento.

Un piano di tracciamento e i termini di cui è fatto.

Come dare un nome agli eventi?

Scegli una convenzione e applicala ovunque. La più comune è oggetto_azione in snake_case: subscription_started, invoice_paid, report_exported. Prima l’oggetto, così gli eventi correlati finiscono vicini nell’ordinamento; l’azione al passato, perché l’evento registra qualcosa che è successo. Quale convenzione scegli conta meno della sua uniformità: Sign Up, signup e user_signed_up nello stesso insieme di dati sono tre eventi che il tuo strumento di analisi tratta come estranei, e ogni grafico costruito su di essi è sbagliato.

Cos’è la deriva del tracciamento e perché rovina le analisi?

La deriva è lo scarto che si apre tra il piano e ciò che il codice invia davvero: un evento viene rinominato senza aggiornare il piano, una proprietà cambia tipo, compare un duplicato con un secondo nome. Ogni modifica è piccola; insieme fanno sì che i funnel contino meno del dovuto, che i segmenti dinamici smettano di includere gli utenti che dovrebbero e che le dashboard scivolino nella finzione, finché il team smette del tutto di fidarsi dei dati. La cura è procedurale, non tecnica: nessun evento viene rilasciato senza una voce nel piano, e rivedere la voce fa parte della code review.

Perché conta per un team di due persone

I piccoli team saltano il piano perché sembra un processo pensato per un’azienda che non sono ancora. La logica va nel senso opposto: in due, a ottobre nessuno ricorda perché esistono sia checkout_completed sia order_completed. Un piano di una pagina scritto prima del primo evento costa un pomeriggio: è il primo lavoro di un Growth Engineer. Per capire come il piano si inserisce in una configurazione completa, dall’SDK al consenso, leggi la guida a dati first-party e tracciamento.

FAQ

Domande frequenti

  • Che differenza c’è tra un piano di tracciamento e un dizionario dei dati?

    Un piano di tracciamento è prescrittivo: dice cosa va tracciato, prima che il codice venga rilasciato. Un dizionario dei dati è descrittivo: documenta i dati che esistono già, difetti compresi. I piccoli team di solito uniscono i due: un solo documento che è sia la specifica sia il riferimento.

  • Chi dovrebbe essere responsabile del piano di tracciamento?

    Una persona con nome e cognome: in una piccola startup, di solito il founder più vicino ai dati o il Growth Engineer. Essere responsabile significa approvare ogni nuovo evento e respingere i nomi che rompono la convenzione, non scrivere personalmente ogni voce.

  • Quanti eventi dovrebbe contenere un piano di tracciamento?

    Meno di quanti pensi. Parti dagli eventi che servono al tuo funnel e alla tua metrica di attivazione, e aggiungine uno solo quando una domanda reale lo richiede. Ogni evento è un impegno di manutenzione; sia Segment sia Amplitude consigliano di mantenere la tassonomia snella.

  • Quali strumenti possono far rispettare un piano di tracciamento?

    Gli strumenti di validazione dello schema (Segment Protocols, Amplitude Data, Avo) bloccano o segnalano gli eventi che non corrispondono al piano. Senza di loro, un linter sui nomi degli eventi più una regola di revisione (nessun nuovo evento senza una voce nel piano) intercettano la maggior parte della deriva, alla scala di un team di due persone.

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