Suivre des événements personnalisés

Qu’est-ce qu’un événement personnalisé ?

Les pages vues sont enregistrées automatiquement, mais beaucoup d’actions importantes ne chargent pas de nouvelle page : cliquer sur un bouton, envoyer un formulaire, lancer une vidéo, télécharger un fichier. Les événements personnalisés vous permettent de suivre ces interactions.

Suivre des événements en JavaScript

Utilisez la fonction umami.track() n’importe où dans le JavaScript de votre site :

// 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
});

Suivre des événements avec des attributs HTML

Pour un simple suivi des clics, inutile d’écrire du JavaScript. Ajoutez simplement un attribut data-umami-event à n’importe quel élément 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>

Tous les attributs data-umami-event-* deviennent des propriétés personnalisées de l’événement.

Consulter les données d’événements

Rendez-vous dans Événements, dans la barre latérale, sous Trafic.

Vous y trouverez :

• La chronologie des événements : un graphique du nombre d’événements dans le temps
• La liste des événements : tous les événements suivis avec leur nombre
• Les propriétés des événements : cliquez sur un événement pour voir le détail de ses données personnalisées

Identification des utilisateurs

Vous pouvez aussi identifier les visiteurs avec des propriétés personnalisées grâce à umami.identify() :

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

Ces données personnalisées sont rattachées à la session du visiteur ; vous pouvez ensuite les utiliser pour filtrer et segmenter.

Cas d’usage courants

Bonnes pratiques

• Choisissez des noms descriptifs et cohérents. add-to-cart vaut mieux que click1.
• Gardez des valeurs de propriétés propres. Évitez les valeurs dynamiques qui créent trop d’entrées uniques (les horodatages, par exemple).
• Suivez le résultat, pas le clic. Suivez form-submit, pas submit-button-click.
• Ne suivez pas tout. Concentrez-vous sur les événements qui mènent à des décisions concrètes.

Et ensuite ?

• → Suivre des objectifs de conversion : utilisez les événements comme objectifs de conversion
• → Configurer des entonnoirs de conversion : construisez des entonnoirs à partir d’événements
• → Suivi des revenus : ajoutez des données de revenus à vos événements

Besoin d’aide ? Écrivez-nous à support@eurometrics.eu.