Documentation

Tout ce dont vous avez besoin pour faire fonctionner Monoid sur votre site.

Démarrage rapide Configuration Événements personnalisés Confidentialité et données Référence API

1. Créer un compte

Rendez-vous sur monoid.website, entrez votre e-mail, mot de passe et domaine. Vous recevrez un lien d'activation par e-mail.

2. Ajouter l'extrait de tracking

Après confirmation, collez ceci dans la balise <head> de votre site. Remplacez YOUR_SITE_ID par l'ID de votre tableau de bord.

html

<script async defer
  src="https://api.monoid.website/tracker.min.js"
  data-site-id="YOUR_SITE_ID"
  data-autotrack="true">
</script>

Le script est chargé de manière asynchrone — il ne bloque jamais le rendu de la page. Les données commencent à apparaître dans votre tableau de bord en quelques secondes.

3. Vérifier l'installation

Ouvrez votre site dans un navigateur, puis vérifiez votre tableau de bord Monoid. Vous devriez voir une page vue apparaître en temps réel dans le panneau Visiteurs en direct. Si rien n'apparaît après une minute, vérifiez que l'attribut data-site-id correspond exactement à votre ID de site.

Next.js / React

Dans Next.js, ajoutez l'extrait à votre _document.tsx ou utilisez le composant next/script avec strategy="afterInteractive" :

tsx

import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://api.monoid.website/tracker.min.js"
          data-site-id="YOUR_SITE_ID"
          strategy="afterInteractive"
        />
      </body>
    </html>
  )
}

WordPress

Dans le functions.php de votre thème, ajoutez :

php

function monoid_tracker() {
  echo '<script async defer src="https://api.monoid.website/tracker.min.js" data-site-id="YOUR_SITE_ID" data-autotrack="true"></script>';
}
add_action('wp_head', 'monoid_tracker');

Tracking sans JS (pixel)

Si vous ne pouvez pas exécuter JavaScript — pages rendues côté serveur avec JS désactivé, pages statiques strictes ou environnements qui bloquent les scripts — utilisez le pixel de tracking à la place. Déposez cette balise <img> là où vous voulez que le tracking se déclenche. Remplacez YOUR_SITE_ID et définissez p comme le chemin de la page actuelle.

html

<img src="https://api.monoid.website/pixel.gif?s=YOUR_SITE_ID&p=/your-page-path"
  width="1" height="1" alt=""
  style="display:none"
  referrerpolicy="strict-origin-when-cross-origin" />

Le pixel enregistre les mêmes données analytiques principales que le tracker JS — chemin, référent, pays, type d'appareil et hash journalier de visiteur — mais sans la largeur d'écran (pas de JavaScript disponible). L'en-tête Referer du navigateur est utilisé automatiquement ; vous pouvez le remplacer avec un paramètre &r=domaine-referent. Les visiteurs qui envoient DNT: 1 ne sont pas enregistrés.

Quelque chose manque ou est incorrect ? Dites-le nous