Sur cette page
Kit de développement logiciel d’analyse
MarkdownLes champs collectés, le point de terminaison des événements et le modèle de confidentialité des analyses web de Glossia.
Point de terminaison des événements
POST /api/analytics/events
Accepte un événement JSON provenant du kit de développement logiciel @glossia/web. Renvoie toujours 202 Accepted, y compris pour les domaines inconnus ou les charges utiles mal formées, afin que le kit ne révèle jamais quels projets collectent des données analytiques.
Le projet est déterminé à partir du domaine du site déclaré par l’extrait de code. d fait autorité. S’il est absent, le serveur utilise l’hôte de u (l’URL de la page), puis les valeurs Origin/Referer de la requête.
Corps de la requête
| Champ | Type | Description |
|---|---|---|
d |
chaîne | Domaine du site qui identifie le projet (par exemple example.com). Obligatoire. |
n |
chaîne | Nom de l’événement. Valeur par défaut : pageview. |
u |
chaîne | URL de la page (location.href). |
r |
chaîne | Référent (document.referrer). |
l |
chaîne | Langues du navigateur (navigator.languages.join(",")). |
tz |
chaîne | Fuseau horaire IANA (Intl.DateTimeFormat().resolvedOptions().timeZone). |
sw |
nombre | Largeur de l’écran en pixels CSS. |
sid |
chaîne | Identifiant de session propre à l’onglet (sessionStorage, effacé à la fermeture). |
Le partage des ressources entre origines est ouvert (Access-Control-Allow-Origin: *), car le point de terminaison n’accepte aucun identifiant d’authentification.
Champs dérivés par le serveur
Ces champs sont calculés lors de l’ingestion et stockés côté serveur. L’adresse IP brute et l’agent utilisateur ne sont jamais stockés.
| Champ | Source | Description |
|---|---|---|
visitor_id |
HMAC | Empreinte de l’adresse IP, de l’agent utilisateur et du projet, renouvelée quotidiennement. Aucun rapprochement possible entre les jours. |
country_code |
GeoIP | Code ISO 3166-1 alpha-2. Vide lorsque GeoIP n’est pas configuré. |
device |
Agent utilisateur | desktop, mobile, tablet, bot ou unknown. |
browser |
Agent utilisateur | chrome, safari, firefox, edge, opera ou unknown. |
os |
Agent utilisateur | windows, macos, ios, android, linux ou unknown. |
hostname |
URL de la page | Hôte en minuscules. |
pathname |
URL de la page | Composant du chemin. |
referrer_source |
Référent | Hôte référent, sans le préfixe www./m.. |
browser_language |
Langues | Paramètre régional normalisé privilégié (par exemple pt-BR). |
served_locale |
Calculé | Première langue cible prise en charge correspondant à une langue privilégiée, sinon vide. |
has_locale_gap |
Calculé | 1 lorsque le visiteur préfère une langue que le projet ne prend pas en charge. |
Modèle de confidentialité
- Aucun stockage côté client. Le kit de développement ne définit aucun cookie et stocke uniquement un identifiant de session propre à l’onglet dans
sessionStorage, que le navigateur efface à sa fermeture. - Aucune prise d’empreinte. Les empreintes du canevas, de WebGL, des polices et du contenu audio ne sont pas collectées. L’empreinte du serveur renouvelée quotidiennement permet de comptabiliser les visiteurs uniques sans les utiliser.
- Aucun identifiant brut conservé. L’adresse de protocole Internet et l’agent utilisateur sont lus une seule fois, hachés avec un secret du serveur et un sel quotidien, puis supprimés.
- Cloisonnement par projet. Un même navigateur utilisé sur deux projets génère des identifiants visiteur sans lien entre eux. Les visiteurs ne peuvent donc pas être suivis entre différents clients de Glossia.
Glossia