PostHog guida completa: eventi, funnel, sessioni e feature flag
PostHog riunisce analisi eventi, funnel, registrazioni sessioni, feature flag e test A/B. Guida pratica dall'installazione al primo esperimento.
👁 115 letture
PostHog è un insieme di strumenti per conoscere gli utenti della tua applicazione: analisi degli eventi, funnel, registrazioni delle sessioni, feature flag e test A/B in un unico posto. Questa guida ti accompagna dall’installazione al primo funnel e alla prima feature flag, seguendo la documentazione ufficiale di PostHog.
Prima di iniziare: la lista delle domande
PostHog raccoglie molti dati subito dopo l’installazione ed è facile perdersi. Prima di installare, scrivi tre domande a cui vuoi trovare risposta, per esempio: quanti nuovi utenti completano la registrazione, quale funzione viene usata più spesso, dove le persone abbandonano l’acquisto. Per ogni domanda annota gli eventi di cui hai bisogno. Questi diventeranno i tuoi primi eventi personalizzati.
Stabilisci anche con il team una convenzione per i nomi degli eventi, perché cambiarla dopo è difficile senza rovinare i grafici.
Passo 1. Installazione
Il metodo più veloce secondo la documentazione è il wizard eseguito nella cartella del progetto con un singolo comando via npx. Funziona anche con assistenti AI come Cursor. L’alternativa è uno snippet di codice da incollare nella pagina, nella sezione head, con la chiave del progetto e l’indirizzo del server, oppure una libreria installabile via npm.
La documentazione raccomanda anche un server proxy, che riduce il rischio che gli ad blocker intercettino gli eventi. PostHog lo fornisce gratuitamente per gli utenti cloud.
Passo 2. Gli eventi si raccolgono da soli
Dopo l’installazione la raccolta automatica è attiva di default: visualizzazioni di pagina, clic, invio di form e dati sulle sessioni. Non devi configurare nulla per vedere i primi dati. Gli eventi personalizzati, per esempio “registrazione completata”, li invii con una riga di codice contenente il nome dell’evento e le sue proprietà.
Passo 3. Il primo funnel
Il funnel mostra quante persone passano attraverso i vari step e dove abbandonano. Nel menu vai in Insights, dalla lista accanto al pulsante nuovo grafico scegli funnel. Parti dal primo evento, aggiungi gli step intermedi e concludi con l’evento che indica il successo. Esempio: ingresso nella pagina di registrazione, compilazione del form, conferma email.
Il primo funnel di solito mostra subito lo step in cui si perde il maggior numero di persone. È lì che vale la pena guardare le registrazioni delle sessioni.
Passo 4. Registrazioni delle sessioni
Attivi le registrazioni delle sessioni con poche righe di configurazione. Registrano clic, scroll, digitazione e passaggi tra pagine. Puoi filtrare le registrazioni, per esempio per clic multipli frustrati, errori JavaScript, eventi personalizzati o varianti di flag. Il supporto più completo è sui siti web, nelle app mobile ci sono alcune limitazioni.
Passo 5. Feature flag
Una flag ti permette di attivare una nuova funzione solo per una parte degli utenti. La crei nel pannello PostHog e nel codice verifichi se è attiva per quella persona. La documentazione raccomanda il rilascio graduale, partendo dal 5-10 percento degli utenti e aumentando la quota quando tutto funziona. Per i test puoi attivare la flag per il tuo indirizzo email.
Passo 6. Esperimenti
Crei un test A/B nella sezione esperimenti. Il wizard ha tre step: descrizione con ipotesi e chiave della flag, varianti con distribuzione percentuale e metriche, per esempio la conversione da un funnel. Nel codice verifichi la variante della flag e PostHog raccoglie automaticamente i dati e calcola il risultato.
Esempio: perché le persone non completano la registrazione
Installi PostHog con il wizard, aspetti un giorno per i dati e costruisci il funnel di registrazione. Il funnel mostra che metà delle persone abbandona alla conferma email. Filtri le registrazioni delle sessioni di chi ha abbandonato e vedi che tornano al form perché non sanno dove cercare l’email. Aggiungi un messaggio dietro una flag per metà degli utenti e dopo una settimana confronti i risultati nell’esperimento.
In questo esempio è importante la sequenza: prima i numeri dal funnel, poi le registrazioni, infine la modifica. Se il team avesse iniziato con una modifica basata sull’intuizione, per esempio ridisegnando il form, avrebbe potuto migliorare uno step che non era affatto il problema. Il funnel ha indicato il punto, le registrazioni hanno spiegato la causa e l’esperimento ha verificato se la correzione funziona. Ognuno di questi tre passaggi richiede poco tempo, ma insieme trasformano le ipotesi in conoscenza.
Errori più comuni
- Mancanza di eventi personalizzati per le azioni più importanti.
- Rilasciare funzioni a tutti contemporaneamente invece che gradualmente.
- Registrazioni senza filtri, perdendoci ore.
Come valutare la prima settimana
Dopo una settimana verifica se hai risposta ad almeno una delle tre domande. Se sì, passa alle registrazioni delle sessioni delle persone nello step problematico. Se no, di solito manca qualche evento o è nominato male.
Controlla anche se i dati corrispondono alla realtà. Confronta per esempio il numero di registrazioni in PostHog con il numero di account nel database. Una grande differenza è di solito causata dagli ad blocker, e il server proxy descritto nella documentazione aiuta a risolverla.
Se hai un’applicazione piccola e poco traffico, non trarre conclusioni da pochi giorni di dati. Un funnel con venti persone può mostrare differenze casuali. Meglio aspettare qualche settimana o concentrarsi sulle registrazioni delle sessioni, che anche con poco traffico mostrano problemi concreti.
More on this from NITIDO
guide·Railway tutorial: app da GitHub, database e dominio pubblicoRailway mette online un'app da GitHub in pochi minuti: scegli il progetto, Railway lo compila e avvia, aggiungi il database con un clic.