É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.

Limites

Limite	Valeur
Propriétés par événement	30 (les excédents sont abandonnés)
Longueur de la clé de propriété	300 caractères
Longueur de la valeur de propriété	2 000 caractères
Types de valeurs	chaînes, nombres, booléens (pas d’objets ni de tableaux)

Les charges utiles qui dépassent ces limites sont rejetées.

Données personnelles (PII)

MetriXs ne stocke aucune donnée personnelle, et cela inclut les propriétés d’événements personnalisés. Les propriétés qui ressemblent à des données personnelles (adresses e-mail, numéros de téléphone, identifiants utilisateur, données de paiement, etc.) sont supprimées automatiquement avant tout stockage. Si une propriété est supprimée, un avertissement s’affiche dans la console du navigateur afin que vous puissiez corriger votre implémentation.

La vérification est un filet de sécurité, pas un substitut à une bonne hygiène des données. Il reste de votre responsabilité de ne pas envoyer de données personnelles en premier lieu. N’attachez jamais de noms, d’adresses e-mail, de numéros de téléphone ou toute autre donnée identifiant un visiteur à un événement personnalisé. La vérification ne peut pas tout reconnaître (par exemple le nom d’une personne), ne comptez donc jamais sur elle pour « nettoyer » des données que vous ne devriez pas envoyer. Pour segmenter vos visiteurs, utilisez des labels non identifiants (plan: 'pro', variant: 'b'), jamais des identifiants.