Monitorare gli eventi personalizzati

Cosa sono gli eventi personalizzati?

Le visualizzazioni di pagina vengono registrate automaticamente, ma molte azioni importanti non comportano il caricamento di una nuova pagina: il clic su un pulsante, l’invio di un modulo, la riproduzione di un video, il download di un file. Gli eventi personalizzati ti permettono di monitorare queste interazioni.

Monitorare gli eventi con JavaScript

Usa la funzione umami.track() in qualsiasi punto del JavaScript del tuo sito:

// Basic event — just a name
umami.track('signup-click');

// Event with custom data
umami.track('download', {
  fileName: 'whitepaper-2026.pdf',
  category: 'resources'
});

// Event with multiple properties
umami.track('video-play', {
  title: 'Product Demo',
  duration: 120,
  autoplay: false
});

Monitorare gli eventi con attributi HTML

Per il semplice tracciamento dei clic non serve scrivere JavaScript. Basta aggiungere l’attributo data-umami-event a qualsiasi elemento HTML:

<!-- Basic click event -->
<button data-umami-event="signup-click">Sign Up</button>

<!-- Event with extra data -->
<a href="/pricing"
   data-umami-event="cta-click"
   data-umami-event-location="header">
  View Pricing
</a>

<!-- Download tracking -->
<a href="/files/report.pdf"
   data-umami-event="download"
   data-umami-event-file="report.pdf">
  Download Report
</a>

Tutti gli attributi data-umami-event-* diventano proprietà personalizzate dell’evento.

Visualizzare i dati degli eventi

Apri Events nella barra laterale, sotto Traffic.

Troverai:

• Timeline degli eventi: un grafico che mostra quante volte si verificano gli eventi nel tempo
• Elenco degli eventi: tutti gli eventi monitorati con il relativo conteggio
• Proprietà degli eventi: fai clic su un evento per vedere il dettaglio dei suoi dati personalizzati

Identificazione degli utenti

Puoi anche identificare i visitatori con proprietà personalizzate usando umami.identify():

umami.identify({
  userId: 'user-123',
  plan: 'pro',
  company: 'Acme Corp'
});

In questo modo i dati personalizzati vengono associati alla sessione del visitatore e puoi usarli per filtrare e segmentare.

Schemi comuni di tracciamento degli eventi

Buone pratiche

• Usa nomi descrittivi e coerenti. add-to-cart è meglio di click1.
• Mantieni puliti i valori delle proprietà. Evita valori dinamici che generano troppe voci uniche (ad esempio i timestamp).
• Monitora il risultato, non il clic. Traccia form-submit, non submit-button-click.
• Non tracciare troppo. Concentrati sugli eventi che danno indicazioni utili per agire.

E adesso?

• → Monitorare gli obiettivi di conversione: usa gli eventi come obiettivi di conversione
• → Configurare i funnel di conversione: crea funnel a partire dagli eventi
• → Monitorare i ricavi: aggiungi dati sui ricavi agli eventi

Serve aiuto? Scrivici a support@eurometrics.eu.