Ajouter le tracker

Installation

Ajoutez l’extrait suivant dans le <head> de chaque page que vous souhaitez suivre :

<script
  defer
  data-domain="yourdomain.com"
  src="https://app.metrixs.eu/tracker.js"
></script>

Remplacez yourdomain.com par le domaine de votre site (doit correspondre à celui enregistré dans MetriXs).

Options

Attribut	Description
`data-domain`	Requis. Le domaine de votre site
`data-local-dev`	Définir pour suivre sur localhost (désactivé par défaut)

Événements personnalisés

Au-delà des pages vues automatiques, vous pouvez déclencher des événements personnalisés pour tout ce que vous souhaitez mesurer, clics de boutons, lectures vidéo, soumissions de formulaire, jalons de défilement. Les événements personnalisés apparaissent dans votre tableau de bord et portent leurs propres propriétés.

// Déclencher un événement personnalisé avec des propriétés
metrixs('Signup CTA Click', { props: { location: 'hero' } })

Options

Option	Type	Défaut	Description
`name`	`string`	—	Le nom de l’événement (par exemple `'Signup CTA Click'`). 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 complet capture aussi 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, …)	`url`
`404`	Une page 404, seulement si la page définit `<meta name="metrixs:404" content="true">`	`path`

Ceux-ci apparaissent dans leur propre carte Événements auto-suivis sur le tableau de bord. Pour capturer les 404, ajoutez la balise meta à votre modèle de page 404 :

<meta name="metrixs:404" content="true" />

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.

Voir Événements personnalisés pour la consultation et le détail dans le tableau de bord.

Auto-exclusion

Pour exclure vos propres visites, exécutez ceci dans la console de votre navigateur :

localStorage.setItem('metrixs_ignore', 'true')

Version allégée

Pour une taille de bundle minimale, utilisez le tracker lite :

<script defer data-domain="yourdomain.com" src="https://app.metrixs.eu/tracker.lite.js"></script>