> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Installez le snippet de suivi et configurez l'analyse web sans cookie de votre espace de travail.

![Dashboard de l'analyse web avec les sessions, le TimeScore, le taux de rebond, le graphique du trafic avec ses annotations, les principales pages et les principales sources](https://www.notifuse.com/docs/assets/screenshots/web_analytics/dashboard.png)

L'analyse web enregistre les visites de votre site dans votre propre base de données, à côté de vos contacts. Elle fonctionne sans cookie, ne stocke aucune adresse IP et ne dépend d'aucun service tiers.

- **First-party** : les sessions, les pages vues et les objectifs sont stockés dans la base de données de votre espace de travail, dans trois tables partitionnées par mois.
- **Sans cookie** : aucun cookie n'est déposé et aucun identifiant ne suit un visiteur d'un site à l'autre. Une session vit dans le `localStorage` et se termine après 30 minutes d'inactivité, ou 24 heures après son début si cela arrive avant.
- **Attribution intégrée** : 40 règles fournies classent le trafic par canal, pour que vous voyiez ce que vos newsletters ont apporté.
- **Relié aux contacts** : les visites d'un visiteur que vous identifiez sont enregistrées dans la chronologie de son contact, où les segments peuvent les utiliser.

## Activer l'analyse web

Allez dans **Paramètres** → **Analyse web**, activez-la et ajoutez au moins un domaine.

> [!WARNING]
>
> L'analyse web ne peut pas être activée avec une liste de domaines vide. Cette liste détermine les sites qui peuvent vous envoyer du trafic, et les hôtes qui peuvent recevoir une identité depuis un lien d'email suivi.

## Installer le snippet

Collez ce code avant la balise de fermeture `</head>` de chaque page que vous voulez suivre.

```html
<script>
  window.NotifuseAnalyticsConfig = { workspace_id: "your_workspace", endpoint: "https://your-instance.com" };
</script>
<script async src="https://your-instance.com/na.js"></script>
```

L'écran des paramètres affiche ce snippet avec l'ID de votre espace de travail et votre endpoint déjà remplis : copiez-le depuis cet écran au lieu de modifier l'exemple.

Le script est servi par votre propre instance à l'adresse `/na.js` et mis en cache pendant une heure. Une variante avec hash, `/na.<hash>.js`, est servie avec un cache immuable d'un an : utilisez-la si votre CDN préfère les URL permanentes. Les deux envoient leurs beats à `POST /track`.

> [!NOTE]
>
> Tout ce que le tracker ne peut pas accepter (un espace de travail désactivé, un domaine absent de votre liste, une requête qui ressemble à un bot) reçoit une réponse de succès et est ignoré. Le SDK ne réessaie jamais ce qui ne peut pas réussir : une erreur de configuration se voit donc à des données manquantes, et non à des erreurs dans la console de votre navigateur.

## Domaines autorisés

Chaque entrée est un nom d'hôte, avec au plus un joker en tête.

| Entrée          | Correspond à                                         | Ne correspond pas à                   |
| --------------- | ---------------------------------------------------- | ------------------------------------- |
| `example.com`   | `example.com`                                        | `www.example.com`, `shop.example.com` |
| `*.example.com` | `example.com`, `www.example.com`, `shop.example.com` | `example.org`                         |

Les ports ne font pas partie d'un nom d'hôte et ne doivent pas apparaître. Un joker sur un seul label, comme `*.com` ou `*.io`, est refusé : il remettrait l'identité de chaque destinataire à tous les liens de ce suffixe.

> [!TIP]
>
> La plupart des sites veulent `*.example.com`. Cette entrée couvre le domaine racine et tous les sous-domaines, et `www` continue donc de fonctionner si quelqu'un l'ajoute plus tard.

La liste détermine aussi les pages que la console ouvre depuis la chronologie d'un contact. **Voir le site web** est proposé pour une page vue dont l'hôte figure dans la liste ou, tant que la liste est vide, dont l'hôte est le domaine du site web de votre espace de travail, avec ou sans `www.`. Une page vue enregistrée sans hôte s'ouvre sur le site web de votre espace de travail. Pour prévisualiser les pages de vos autres hôtes, listez tous les hôtes que vous suivez, y compris celui de votre site : dès que la liste contient des entrées, les beats d'un hôte qui n'y figure pas sont ignorés.

## Paramètres

![Paramètres de l'analyse web avec l'interrupteur d'activation, les domaines autorisés, le seuil de rebond et l'identification des contacts](https://www.notifuse.com/docs/assets/screenshots/web_analytics/settings.png)

| Réglage                                     | Effet                                                                                                                                                                                                       |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Statut**                                  | Active ou désactive le suivi. Désactivé par défaut.                                                                                                                                                         |
| **Domaines autorisés**                      | Les noms d'hôte qui peuvent envoyer du trafic, les seuls hôtes auxquels un lien d'email suivi peut remettre une identité, et les hôtes dont la chronologie d'un contact ouvre les pages.                    |
| **Seuil de rebond**                         | Nombre de secondes de temps d'engagement en dessous duquel une visite compte comme un rebond. 10 par défaut.                                                                                                |
| **Identifier les destinataires des emails** | Permet à Notifuse d'ajouter une identité signée aux liens des emails suivis. Désactivé par défaut. Voir [Identifier les visiteurs](https://www.notifuse.com/fr/docs/web-analytics/identifying-visitors.md). |
| **Dimensions personnalisées**               | Les noms d'affichage de `custom_1` à `custom_10`. Voir [Rapports](https://www.notifuse.com/fr/docs/web-analytics/reports.md).                                                                               |
| **Localisation des visiteurs**              | Indique s'il faut déterminer le pays du visiteur (**Localiser les visiteurs**), et avec quelle précision.                                                                                                   |

Le seuil de rebond porte sur le temps d'engagement, pas sur le nombre de pages : un visiteur qui lit un long article n'est pas un rebond, alors qu'un visiteur qui ouvre cinq pages en quatre secondes en est un.

## Géolocalisation

Le pays est déterminé à partir de l'adresse IP du visiteur, avec une base MaxMind GeoLite2 fournie. **L'adresse IP elle-même n'est jamais stockée** : elle sert à la recherche, puis elle est supprimée.

- **Région** et **Ville** ajoutent ces niveaux nommés. Les désactiver supprime les _noms_ de région et de ville.
- **Coordonnées** règle la part de la latitude et de la longitude qui est conservée : `0` ≈ pays (\~111 km), `1` ≈ région (\~11 km), `2` ≈ ville (\~1 km). La valeur par défaut est `2`.

> [!NOTE]
>
> Une coordonnée est un nom de lieu sous une autre forme. Elle n'est donc jamais conservée avec plus de finesse que
> le nom le plus fin que vous stockez, quel que soit le réglage de précision. Avec **Ville**
> désactivé, les coordonnées sont plafonnées à `1`, et avec les deux réglages de noms désactivés, à `0`. Le
> réglage est un plafond que ces interrupteurs peuvent abaisser, jamais relever.
>
> Les coordonnées sont arrondies plutôt que supprimées, et la carte En direct continue donc de montrer
> où se trouvent les visiteurs. Une carte vide laisserait croire que personne n'est en ligne.

Les instances auto-hébergées livrent la base à l'emplacement `/app/geoip/GeoLite2-City.mmdb`. Faites pointer `GEOIP_DB_PATH` vers un autre fichier pour utiliser la vôtre.

## Permissions

Modifier ces réglages demande `web_analytics` en **écriture**. Lire les rapports demande `web_analytics` en **lecture**, et la section **Analyse web** apparaît dans la barre latérale pour un membre qui a l'un ou l'autre.

Le panneau des paramètres lui-même n'est pas restreint : tout membre de l'espace de travail peut l'ouvrir et voir la configuration actuelle en lecture seule, domaines autorisés compris.

## Remarques

- Les sessions, les pages vues et les objectifs sont stockés dans trois tables partitionnées par mois, dans la base de données de votre espace de travail. Il n'y a pas encore de réglage de rétention : rien n'est supprimé automatiquement.
- Une session porte au plus 1000 actions enregistrées. Au-delà, la visite est toujours comptée, mais les nouvelles actions sont ignorées.
- Supprimer un contact efface son adresse de toutes les lignes analytiques. Le trafic lui-même reste, en anonyme.
- [Référence de l'API](https://www.notifuse.com/docs/api-reference.md)
