Événements personnalisés

Au-delà des pages vues automatiques, MetriXs suit des événements personnalisés, tout ce que vous souhaitez mesurer : clics de boutons, soumissions de formulaires, lectures vidéo, inscriptions, achats. Les événements personnalisés portent leurs propres propriétés que vous pouvez attacher, et le tableau de bord les décompose pour vous.

Envoi d’événements personnalisés

Déclenchez un événement personnalisé depuis votre site avec la fonction globale metrixs() (disponible une fois le script du tracker chargé) :

// Un événement personnalisé avec des propriétés
metrixs('Signup', { props: { plan: 'pro', location: 'hero' } })

Option	Type	Défaut	Description
`name`	`string`	—	Le nom de l’événement. Utilisez `'pageview'` pour une page vue manuelle.
`props`	`object`	`{}`	Propriétés personnalisées à attacher à l’événement.
`url`	`string`	`location.href`	Remplace l’URL de page enregistrée pour cet événement (utile pour les changements de route SPA).
`interactive`	`boolean`	`true`	Définir à `false` pour les signaux passifs qui ne doivent pas compter comme une interaction réelle (pour ne pas baisser le taux de rebond). Les événements intégrés de profondeur de défilement/engagement utilisent ceci.
`callback`	`function`	—	Appelé après l’envoi de l’événement.

// Signal non interactif, étend la durée de visite sans affecter le taux de rebond
metrixs('scroll_to_bottom', { props: { article: 'gdpr' }, interactive: false })

Les événements personnalisés déclenchés pendant une visite étendent aussi sa durée mesurée, car la durée est calculée comme le temps entre la première page vue et le dernier événement. Voir Durée de visite pour l’importance.

Événements auto-suivis

Le tracker capture automatiquement trois types d’événements, aucune configuration requise :

Nom d’événement	Quand il se déclenche	Propriété
`Outbound Link: Click`	Un visiteur clique sur un lien vers un domaine externe	`url`
`File Download`	Un visiteur clique sur un lien vers un fichier (pdf, zip, mp4, docx, …)	`url`
`404`	Une page 404, seulement si la page définit `<meta name="metrixs:404" content="true">`	`path`

Ceux-ci apparaissent dans le tableau de bord dans leur propre carte Événements auto-suivis, séparés de vos événements personnalisés, pour que vos événements restent propres.

Le tracker lite (tracker.lite.js) omet le suivi automatique, pages vues uniquement. Utilisez le tracker.js complet si vous voulez capturer les liens sortants, téléchargements et 404.

Consultation des événements personnalisés dans le tableau de bord

Le tableau de bord montre deux cartes (seulement quand le site a des événements personnalisés, elles se cachent sinon, donc pas de désordre sur les sites qui n’en utilisent pas) :

Événements personnalisés, vos événements définis par l’utilisateur.
Événements auto-suivis, liens sortants, téléchargements de fichiers et 404.

Chaque ligne montre le nom de l’événement et combien de fois il s’est déclenché, avec une barre mise à l’échelle de l’événement principal. Cliquez sur une ligne pour la déployer et voir sa répartition des propriétés, chaque clé de propriété avec ses valeurs principales et comptages.

Cliquer sur une valeur de propriété (par exemple plan = pro) filtre tout le tableau de bord sur ce segment, tout comme cliquer sur une page ou un pays. Retirez le filtre depuis la barre de filtres en haut.

Comment les propriétés sont stockées

Les propriétés d’événements personnalisés sont stockées dans ClickHouse comme des tableaux parallèles meta.key / meta.value (une ligne par événement). Le tableau de bord découvre les clés de propriétés par événement avec un point de terminaison dédié POST /api/v2/event-props (le constructeur de requêtes principal ne peut pas énumérer des clés inconnues), puis lit chaque valeur via la dimension event:props:<key>. Les clés de propriétés sont restreintes à ^[a-zA-Z0-9_-]+$, tenez-vous-en aux lettres, chiffres, tirets et tirets bas.