Installer des analyses web

Ajoutez le SDK web Glossia à votre site avec une seule ligne de HTML ou via npm, et commencez à collecter des signaux de localisation.

Ce guide suppose que vous disposez d'un projet Glossia dont le domaine du site est configuré dans les paramètres d'analyse du projet. La collecte est identifiée par ce domaine, il n'y a donc pas de clé ou de secret à copier.

Option A : balise script

Ajoutez cet extrait à chaque page, idéalement dans le <head>:

<script defer data-domain="example.com" src="https://cdn.glossia.ai/web.js"></script>

Le SDK s'initialise automatiquement, envoie une pageview au chargement et enregistre les pageviews suivantes lors de la navigation côté client dans les applications à page unique. data-domain par défaut window.location.hostname lorsqu'il est omis, vous pouvez ainsi l'utiliser sur un site à domaine unique. Pour utiliser un endpoint de collecte personnalisé, ajoutez data-endpoint="https://collect.your-host.com".

Option B : npm

Installez le package :

npm install @glossia/web

Initialisez-le une fois dans le point d'entrée de votre application :

import glossia from "@glossia/web";

glossia.init();

Le domain est déduit de window.location.hostname de sorte que le SDK enregistre pour le projet enregistré pour votre site. Passez { domain: "example.com" } pour surécrire, par exemple pour envoyer des événements depuis une origine de staging vers le même projet que la production.

Pour enregistrer un événement personnalisé, par exemple une inscription :

glossia.track("signup");

Vérifiez qu'il fonctionne

Ouvrez votre site dans un navigateur.
Ouvrez l'onglet réseau et confirmez une POST requête vers /api/analytics/events retourne 202 Accepted.
Dans une minute, la vue de page apparaît dans le tableau de bord analytique de votre projet.

Ce qui est collecté

Le navigateur envoie l'URL de la page, le référent, navigator.languages, fuseau horaire, et la largeur d'écran, ainsi qu'un identifiant de session par onglet. Le serveur ajoute le pays (via GeoIP) et calcule l'écart de localisation par rapport aux langues cibles de votre projet. Aucun cookie n'est défini et aucune empreinte n'est capturée.