Démarrage rapide

Trois étapes : créer un site, coller une balise, ouvrir la vue en direct. Dans les snippets, remplacez SITE_ID par l’identifiant affiché dans Settings → Tracking code. Vous découvrez Globatics ? La page Fonctionnement explique ce qu’envoie le script et où vont les données.

Ajouter un site#

1. Créez un compte

   Inscrivez-vous, ou connectez-vous à votre propre serveur. En auto-hébergement, lisez d’abord Auto-hébergement.

2. Ajoutez votre site web

   Indiquez son nom, son domaine, son fuseau horaire (détecté pour vous) et sa devise. Les sous-domaines du domaine sont acceptés automatiquement.

3. Copiez le snippet

   L’écran de configuration affiche la balise avec l’identifiant de votre site déjà rempli, et attend votre premier visiteur.

Installer le script#

Ajoutez la balise une seule fois, sur chaque page. Dans les applications monopages, les navigations côté client sont suivies automatiquement : inutile d’écouter le routeur.

<!-- in the <head> of every page -->
<script defer data-site="SITE_ID" src="https://globatics.live/script.js"></script>
<!-- optional: queue calls made before the script loads -->
<script>window.globatics=window.globatics||function(){(window.globatics.q=window.globatics.q||[]).push(arguments)}</script>

Tous les attributs acceptés par la balise (exclusions, routage par hash, persistance) sont décrits dans l’API du tracker. Pour compter les inscriptions et les achats, envoyez des événements personnalisés avec leur revenu.

Installer avec un agent de code IA#

Collez ce prompt dans Claude Code, Cursor, Copilot ou un autre agent de code. Il installe la balise comme il faut pour votre framework et suit vos conversions clés. Il est en anglais, ce qui convient à tous les agents.

Add Globatics analytics to this project.

1. Load this script on every page, once, as early as possible without blocking rendering:
   <script defer data-site="SITE_ID" src="https://globatics.live/script.js"></script>
   - Next.js App Router: use next/script <Script src=... data-site="SITE_ID" strategy="afterInteractive" /> in app/layout.tsx.
   - Next.js Pages Router: same <Script> in pages/_app.tsx.
   - Vite/React/Vue/Svelte SPA: put the tag in index.html.
   - Server-rendered templates: put it in the shared <head> partial.
   Do NOT add a router listener: SPA navigations are tracked automatically.
2. Do not add a cookie banner entry for it and do not wrap it in consent logic: it sets no cookies
   and stores nothing in the browser (unless data-persist is added on purpose).
3. Track the key conversions with window.globatics:
   - signups:   window.globatics?.('event', 'signup', { plan })
   - purchases: window.globatics?.('event', 'purchase', { plan }, { revenue: amount, currency: 'USD' })
   Use snake_case event names; never start them with "$" (reserved). Props must be flat
   (string, number, boolean or null), max 30 per event.
4. If the app has logged-in users, call window.globatics?.('identify', user.id, { name, plan })
   after login, and window.globatics?.('reset') on logout. Never send passwords or tokens.
5. In TypeScript, declare `globatics?: (...args: unknown[]) => void` on the Window interface.
6. Do not change anything else. Afterwards, list the files you changed.

Vérifier l’installation#

Ouvrez votre site dans un autre onglet et laissez-le visible. En moins d’une seconde, vous apparaissez sur le globe en direct. Dans les DevTools de votre navigateur, l’onglet Réseau montre une requête collect au chargement (réponse 202) puis un heartbeat toutes les 15 secondes.

L’écran de configuration attend cette visite et n’accepte que celle envoyée par une page de votre domaine (ou de l’un de ses sous-domaines). Votre navigateur indique à Globatics de quel site vient une requête (l’en-tête Origin), et c’est ce qui compte, pas l’URL contenue dans le hit. Une visite depuis localhost, une URL de prévisualisation ou une page Globatics s’affiche dans le direct mais ne valide jamais l’installation. Quand c’était vous, l’écran affiche « This is you. » avec votre ville et votre navigateur.

Check installation charge votre page d’accueil depuis nos serveurs et indique ce qu’il trouve : le snippet, un mauvais identifiant de site, une Content Security Policy qui le bloque, un <Script> Next.js, ou une page illisible (une connexion ou un mur anti-bots). Settings → Tracking propose la même vérification.

Exclure vos propres visites#

Ouvrez n’importe quelle page de votre site avec #globatics-ignore à la fin de l’URL. Ce navigateur n’est plus compté jusqu’à ce que vous ouvriez une page avec #globatics-unignore. Vous pouvez aussi appeler globatics('optout'). Les robots d’indexation, navigateurs headless et sondes de disponibilité sont filtrés pour vous dès la collecte : voir Bots et filtrage.