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>

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, clics de rage : activés par défaut, désactivables dans les paramètres
  • Core Web Vitals, erreurs JavaScript : optionnels
  • 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
};

É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 1,5 Ko compressé en gzip (moins de 2 Ko). Un script par site par défaut fait environ 2,4 Ko, le /tracker.js complet environ 2,8 Ko.
  • Se charge de manière asynchrone avec defer
  • Impact minime sur la vitesse de chargement de la page et les Core Web Vitals
  • Utilise sendBeacon pour un suivi fiable sans blocage