Premiers pas

Ce guide part d’une instance qui tourne — la vôtre, ou la pile de développement de l’installation. En dix minutes : un site déclaré, la balise collée, « Reçu ✓ ».

1. Créer le site

Dans Sites, un administrateur clique sur Nouveau site et donne :

• un nom (« Maison Arvor ») ;
• son domaine (maison-arvor.fr).

Le site reçoit une clé publique de la forme s_xxxxxxxxxxxx, et s’ouvre sur son onglet Installation. Seuls les domaines déclarés peuvent envoyer des données : ajoutez ceux de recette ou de préproduction dans les Réglages du site (*.maison-arvor.fr couvre tous les sous-domaines).

Par défaut, le site mesure sans cookie. Le mode se change à tout moment dans ses Réglages, sans toucher à la balise : voir les modes de mesure.

2. Coller la balise

L’onglet Installation donne la balise du site, sa clé et l’adresse de collecte déjà remplies. Collez-la dans le <head> de toutes les pages :

<script defer src="https://stats.exemple.fr/a.js" data-site="s_arvordemo001"></script>

C’est tout : les pages vues, les sources, les campagnes, le temps d’engagement, la profondeur de défilement, les clics et les mesures automatiques partent d’elles-mêmes. Un gestionnaire de balises (Google Tag Manager, par exemple) convient aussi, avec une balise HTML personnalisée.

Sans rien installer

En développement, la page d’essai http://localhost:4600/demo porte déjà la balise du site de démonstration : ouvrez-la, cliquez, puis passez à l’étape suivante.

3. Voir « Reçu ✓ »

Ouvrez une page du site, puis l’onglet Vérification du site dans eodia analytics. Il attend d’abord : « En attente du premier événement… ». Dès que la page vue arrive, il affiche « Reçu ✓ », puis :

• les chiffres de contrôle : événements reçus ces dernières 24 heures, refusés par raison, visites rangées en Non attribué et leurs couples source / support ;
• les derniers événements, reçus et refusés, relus toutes les deux secondes, avec la raison de chaque refus.

Raison d’un refus	Ce qu’elle veut dire
Origine non autorisée	la page n’est pas sur un domaine déclaré du site
Robot	un agent utilisateur de robot, un navigateur sans tête, ou pas d’agent du tout
Chemin exclu, adresse IP exclue	les exclusions des Réglages du site (/admin/*, le réseau du bureau)
Débit dépassé	plus de 120 événements par minute pour un même visiteur
Charge invalide	un nom d’événement ou des propriétés hors des limites
Identité refusée	un visiteur connecté sur un site qui ne les accepte pas, ou un jeton invalide

Le point de collecte répond 202 à tout ce qui est bien formé, refus compris : il ne dit pas quels sites existent. C’est l’onglet Vérification qui dit pourquoi un événement a été écarté.

Rien n’arrive ?

Vérifiez dans l’ordre : la console du navigateur (une politique de sécurité qui bloque le script), un bloqueur de publicités (essayez une fenêtre privée, ou servez le script depuis un sous-domaine du site), le signal Global Privacy Control du navigateur, qui vaut refus, et le domaine déclaré du site.

4. Déclarer ce que vous mesurez

L’onglet Métadonnées décrit les événements et les zones : un libellé, une description, des propriétés typées. Les événements reçus mais non déclarés y sont listés, avec leurs propriétés observées : Déclarer préremplit la fiche. Ces descriptions deviennent des commentaires SQL, que lit eodia insights. Voir les vues.

5. Lire les données

Branchez eodia insights sur la base : la source PostgreSQL, puis le bouton Statistiques, qui ouvre les tableaux de bord d’insights verrouillés sur le site.

Et ensuite ?

• La balise et ses attributs, puis l’API de la page pour vos propres événements.
• Le commerce en ligne, si le site vend.
• La CNIL : le texte d’information à reprendre et le lien de refus.