Script de suivi

Un script de suivi léger et respectueux de la vie privée.

Utilisation de base

<script
  defer
  data-site-id="YOUR_SITE_ID"
  src="https://glyphex.io/tracker.js"
></script>

Certains bloqueurs de publicité arrêtent les requêtes vers glyphex.io. Pour compter aussi ces visites, servez le tracker depuis votre propre domaine.

Ce qui est suivi

Le script de suivi collecte automatiquement :

  • Pages vues - Chaque page consultée par vos visiteurs
  • Référent - D’où viennent les visiteurs (Google, réseaux sociaux, etc.)
  • Paramètres UTM - Suivi de campagne (utm_source, utm_medium, etc.)
  • Type d’appareil - Ordinateur, mobile ou tablette
  • Navigateur - Chrome, Firefox, Safari, etc.
  • Système d’exploitation - Windows, macOS, iOS, Android, etc.
  • Pays et ville - Localisation approximative à partir de l’IP (IP non conservée)
  • Clics sur les liens sortants - Liens vers des sites externes
  • Téléchargements de fichiers - Téléchargements de PDF, ZIP et autres fichiers
  • Profondeur de défilement - Jusqu’où les visiteurs font défiler chaque page
  • Temps passé sur la page - Durée passée sur chaque page

Ce qui n’est PAS suivi

  • Informations personnelles (noms, e-mails, etc.)
  • Adresses IP (utilisées uniquement pour la géolocalisation, puis supprimées)
  • Cookies ou identifiants persistants
  • Suivi intersites
  • Empreinte numérique pouvant identifier des individus

Options de configuration

Désactiver le suivi

Les utilisateurs peuvent se désinscrire en définissant un indicateur localStorage :

// Opt out of tracking
localStorage.setItem('glyphex_ignore', 'true');

// Opt back in
localStorage.removeItem('glyphex_ignore');

Suivre uniquement en production

Le script ignore automatiquement localhost et les URL file://. Pour un chargement conditionnel :

{process.env.NODE_ENV === 'production' && (
  <Script
    defer
    data-site-id="YOUR_SITE_ID"
    src="https://glyphex.io/tracker.js"
  />
)}

Suivi automatique

Liens sortants

Les clics sur les liens vers des domaines externes sont suivis automatiquement. Vous les verrez dans l’onglet « Comportement » sous « Liens sortants ».

Téléchargements de fichiers

Les téléchargements des types de fichiers courants sont suivis automatiquement :

pdf, zip, rar, 7z, doc, docx, xls, xlsx, ppt, pptx, csv, mp3, mp4, exe, dmg, apk

Comment fonctionne l’identification des visiteurs

Glyphex utilise une approche respectueuse de la vie privée pour identifier les visiteurs uniques sans cookies :

  1. Un sel renouvelé chaque jour est combiné avec l’adresse IP et l’agent utilisateur du visiteur
  2. Cela est haché pour créer un identifiant temporaire
  3. L’identifiant change chaque jour, ce qui empêche tout suivi à long terme
  4. L’IP d’origine n’est jamais conservée

Cela permet un décompte précis des visiteurs uniques tout en préservant la vie privée.

Modules et taille du script

Le tracker se compose d'un petit noyau (pages vues, navigation SPA, événements personnalisés, engagement, désactivation) et de modules optionnels. La balise par site /t/VOTRE_SITE_ID.js fournit le noyau et uniquement les modules activés dans Paramètres, Code de suivi, Fonctionnalités. Un réglage absent laisse actif un module qui l'était toujours, les sites existants ne changent donc pas.

  • Liens sortants, téléchargements de fichiers : activés par défaut, désactivables dans les paramètres
  • Clics de rage, Core Web Vitals, erreurs JavaScript : optionnels
  • Cartes de chaleur : optionnelles (offre Starter ou supérieure). Enregistre la position du clic (part de la largeur de page, hauteur arrondie à 10 px), la classe d'appareil et un sélecteur d'élément (balise, id ou deux premières classes), envoyés en lot une seule fois quand la page est masquée. Pas de texte, pas de saisies, pas d'enregistrements
  • URL cassées (404) : intégrées au noyau, aucune taille en plus
  • La balise avec /tracker.js charge la version complète avec tous les modules

Hook beforeSend

Inspectez, modifiez ou supprimez chaque envoi avant qu'il parte. Définissez data-before-send sur la balise script avec le nom d'une fonction globale, ou beforeSend dans window.__glyphex. Une valeur falsy supprime l'envoi, un objet remplace la charge utile.

<script defer data-site-id="YOUR_SITE_ID" data-before-send="myFilter" src="https://glyphex.io/tracker.js"></script>

window.myFilter = (type, payload) => {
  if (payload.pathname.startsWith("/admin")) return false; // drop
  return payload; // or return a changed copy
};

Options du tracker

Définissez-les comme attributs data sur la balise script, ou comme les mêmes clés (camelCase) dans window.__glyphex. Pour la balise par site, elles sont aussi dans Paramètres, Code de suivi, Fonctionnalités.

  • data-exclude-search="true": Supprime la query string des referrers et des URL 404 enregistrés. Les paramètres UTM sont d’abord lus dans l’URL.
  • data-exclude-hash="true": Les fragments de hash ne sont jamais enregistrés et leurs changements ne comptent jamais comme pages vues. C’est déjà le comportement par défaut ; l’option le rend explicite.
  • data-auto-track="false": Aucune page vue automatique, aucun suivi SPA, aucun hit 404. Appelez vous-même analytics.pageview() et analytics.track().
  • data-tag="variant-b": Associe un libellé (50 caractères max) à chaque page vue et événement, pour les tests A/B ou pour séparer des environnements. Filtrable dans le tableau de bord.
  • data-domains="example.com,www.example.com": N’envoie des données que si le nom d’hôte de la page figure dans cette liste séparée par des virgules (correspondance exacte, donc staging et localhost sont ignorés). Sans cette option, le tracker envoie depuis tous les hôtes.

Page vue manuelle : window.analytics.pageview("/virtual/path")

<script defer data-site-id="YOUR_SITE_ID" data-auto-track="false" data-tag="variant-b" src="https://glyphex.io/tracker.js"></script>

Événements déclaratifs

Ajoutez data-glyphex-event à n'importe quel élément pour suivre un clic sans écrire de JavaScript. Les attributs data-glyphex-event-* supplémentaires deviennent des propriétés de l'événement.

<button data-glyphex-event="Signup" data-glyphex-event-plan="pro">Sign up</button>

Performances

  • Taille du script : noyau d'environ 2,5 Ko compressé en gzip. Le script par site par défaut des nouveaux sites fait environ 3,4 Ko, le /tracker.js complet environ 4,6 Ko.
  • Se charge de manière asynchrone avec defer
  • Impact minime sur la vitesse de chargement de la page et les Core Web Vitals
  • Envoie avec fetch et keepalive, pour que les sorties de page et les clics survivent à la navigation, avec une nouvelle tentative en mémoire pour le reste