Kreomnis Indexation
Se connecter avec Kreomnis
DocumentationInstaller le traceur

Installer le traceur

Une ligne de script, sans cookie ni stockage local, pour mesurer l’audience de n’importe quel site : HTML, Next.js, application monopage.

Sur cette page
  1. Tout site HTML
  2. Next.js
  3. Applications monopage
  4. Options du traceur
  5. Ce qui est mesuré automatiquement
  6. Ce qui n’est pas mesuré
  7. Vérifier l’installation

Tout site HTML#

Collez cette balise dans le <head> de toutes vos pages (en général dans le gabarit commun) :

<head>html
<script defer data-site="ID_DU_SITE" src="https://kreomnisindexation.com/k.js"></script>

ID_DU_SITE est l’identifiant public de votre site. La console vous donne la ligne déjà remplie dansInstallation › Installer le traceur. L’attribut defer charge le script sans bloquer l’affichage de la page.

Rien ne peut casser votre site

Le traceur absorbe ses propres erreurs, ne réessaie jamais un envoi et ne bloque rien si Kreomnis est indisponible. Inclus deux fois par erreur, il ne s’exécute qu’une fois.

Next.js#

Avec l’App Router, ajoutez le script et la balise de vérification dans le layout racine :

app/layout.tsxtsx
// app/layout.tsx
import Script from 'next/script';

export const metadata = {
  other: { 'kreomnis-site-verification': 'VOTRE_JETON' },
};

// dans <body> :
<Script defer data-site="ID_DU_SITE" src="https://kreomnisindexation.com/k.js" strategy="afterInteractive" />

Les changements de page côté client (next/link, router.push) sont comptés automatiquement : voir la section suivante. Pour compter aussi les robots, qui n’exécutent pas le JavaScript, ajoutez le middleware décrit dans Collecte côté serveur.

Applications monopage#

Le traceur suit seul la navigation des applications monopage (React, Vue, Svelte, Next.js…) :

  • chaque appel à history.pushState et chaque retour arrière (popstate) compte une nouvelle page vue, si l’adresse a changé ;
  • un retour depuis le cache du navigateur (bfcache) compte aussi une page vue ;
  • une page affichée en prérendu n’est comptée qu’au moment où elle devient visible.

Si votre application utilise des routes en #/ (par exemple /#/compte), ajoutez data-hash="true" : chaque changement de fragment devient une page vue, et la route est enregistrée sans sa propre requête.

Options du traceur#

Les options sont des attributs de la balise <script> :

AttributEffet
data-siteIdentifiant public du site. Obligatoire.
data-exclude="/admin*,/compte*"Chemins à ne pas mesurer, séparés par des virgules. Un * final désigne tout ce qui commence par ce chemin ; sinon le chemin doit être identique.
data-hash="true"Routes en #/ des applications monopage.
data-dnt="true"Ne mesure pas les navigateurs qui envoient Do Not Track ou Global Privacy Control. Sans cet attribut, ces signaux ne sont pas pris en compte.
data-forms="true"Compte chaque envoi de formulaire comme un événement « Formulaire envoyé » (voir Événements).
data-localMesure aussi localhost, 127.0.0.1 et les domaines en .localhost (utile pour tester).
data-api="URL"Adresse de collecte. Par défaut : https://kreomnisindexation.com/api/collect.
Exemple avec optionshtml
<script defer data-site="ID_DU_SITE" data-exclude="/admin*,/compte*" data-forms="true" src="https://kreomnisindexation.com/k.js"></script>

Ce qui est mesuré automatiquement#

MesureDétail
Pages vuesOrigine, chemin et paramètres de campagne (utm_*, ref). Le reste de la requête n’est jamais envoyé.
ProvenanceLe référent, réduit à son origine et son chemin, à la première page vue seulement.
EngagementTemps passé avec la page visible au premier plan, et profondeur de défilement maximale (en %). Envoyés quand la page est masquée, fermée ou quittée.
Web VitalsLCP, CLS, INP (approché) et TTFB du chargement réel, une fois par page.
Erreurs JavaScriptLe nombre d’erreurs et de promesses rejetées sur la page, sans leur contenu.
Liens sortantsÉvénement outbound : adresse du lien, sans sa requête.
TéléchargementsÉvénement download pour les liens vers .pdf, .zip, .docx, .xlsx, .csv, .mp3, .mp4, .epub, .apk, .exe… (nom du fichier et adresse).
ContactsÉvénements contact_email et contact_tel pour les liens mailto: et tel: (sans l’adresse ni le numéro).
ContexteLargeur d’écran et langue du navigateur. Pays, région et ville sont déduits de la requête par l’hébergement ; l’adresse IP n’est pas conservée.
KreomnisNetLes visites arrivées depuis KreomnisNet (extension, ou lien avec ?ref=kreomnisnet ou utm_source=kreomnisnet) sont reconnues.

Pour vos propres événements (inscription, devis, formulaire), voir Événements et objectifs.

Ce qui n’est pas mesuré#

  • Les pages ouvertes en file:, localhost et adresses locales (sauf avec data-local).
  • Les navigateurs pilotés par un outil d’automatisation (WebDriver, Cypress, PhantomJS).
  • Les robots : ceux qui exécutent le JavaScript sont reconnus et comptés à part, jamais dans l’audience ; les autres ne chargent pas le script et se mesurent côté serveur (Robots et IA).
  • Les chemins exclus par data-exclude.

Vérifier l’installation#

Ouvrez votre site dans un navigateur, puis consultez Installation : la pastille « Dernier événement reçu » passe à « à l’instant ». La page Statistiques montre aussi les visiteurs des cinq dernières minutes.

Politique de sécurité du contenu (CSP)

Si votre site envoie un en-tête Content-Security-Policy, autorisez https://kreomnisindexation.com dans script-src (chargement de k.js) et dans connect-src (envoi des mesures).

Les mesures ne partent pas ?

Vérifiez que la page est servie sur le domaine du site ou l’un de ses sous-domaines : les mesures envoyées depuis un autre domaine sont ignorées. Certains bloqueurs de publicité peuvent aussi empêcher le chargement du script.

Une question sans réponse ici ? Consultez les questions fréquentes.