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 ``: ```html ``` 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 : ```bash npm install @glossia/web ``` Initialisez-le une fois dans le point d'entrée de votre application : ```ts 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 : ```ts glossia.track("signup"); ``` ## Vérifiez qu'il fonctionne 1. Ouvrez votre site dans un navigateur. 2. Ouvrez l'onglet réseau et confirmez une `POST` requête vers `/api/analytics/events` retourne `202 Accepted`. 3. 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.