> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/analytics/insights/traffic.md).

# Trafic

Voyez combien de personnes consultent votre site, sur quelles pages elles arrivent, ce qu’elles recherchent et ce qu’elles pensent de votre contenu

Le rapport **Trafic** couvre les personnes qui lisent votre documentation. Les machines qui la consultent également, comme les LLM, les agents et les robots d’exploration, sont comptabilisées séparément dans [Agents et MCP](https://gitbook.com/docs/documentation/fr/analytics/insights/agents-and-mcp.md), afin que les chiffres présentés ici reflètent les lecteurs humains.

Pour l’ouvrir, accédez à **Analyser → Trafic** dans la barre latérale de votre site.

En haut, vous trouverez les pages vues, les visiteurs, les sessions et les recherches pour la période sélectionnée, chacun comparé à la période précédente, puis un graphique de l’évolution du nombre de lecteurs. Consultez [Statistiques du site](https://gitbook.com/docs/documentation/fr/analytics/insights.md) pour en savoir plus sur les filtres, les périodes et leur comparaison.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-3a91a4e3597e092667c3f7bf5d3e8aa23824a85b%2F26_09_11_analytics_traffic.png?alt=media&amp;token=3d2d7312-c0fe-430f-80cb-158dc418b39d" alt="The Traffic report showing page views, visitors, sessions, searches, and reader activity over time"><figcaption><p>Le rapport Trafic.</p></figcaption></figure>

## Pages et retours

**Pages les plus consultées** classe les pages ouvertes par vos lecteurs, afin que vous puissiez voir à quoi sert votre site.

À côté, **Avis sur les pages** indique les notes attribuées à votre contenu par les lecteurs une fois que vous avez activé les [notes des pages](https://gitbook.com/docs/documentation/fr/manage-your-site/site-settings.md#page-ratings-pro-and-enterprise-plans) dans le menu **Personnaliser** , ainsi que les commentaires laissés. Les pages mal notées, étudiées avec leurs commentaires, constituent généralement le meilleur point de départ pour améliorer votre documentation.

{% hint style="info" %}
**Pourquoi ne vois-je aucune donnée d’avis pour mon site ?**\
Nous n’affichons des données que pour les sites publiés où les notes des pages sont activées. Si votre site n’est pas publié ou si les notes des pages ne sont pas activées, vous ne verrez aucune donnée d’avis.
{% endhint %}

### Filtrer et regrouper les données de retours

Utilisez des filtres pour vous concentrer sur un sous-ensemble d’évaluations et de commentaires, et des groupes pour comparer ces données selon une dimension. Vous pouvez filtrer ou regrouper les retours selon ces dimensions :

* Contenu : section, variante et page.
* Dimensions du visiteur : pays, langue, appareil, navigateur, référent et statut de visiteur authentifié.
* Attributs de visiteur configurés pour le contenu adaptatif, tels qu’un client, un forfait, un rôle ou un accès à une fonctionnalité.

Les filtres de contenu identifient d’où proviennent les retours. Les dimensions du visiteur ajoutent le même contexte d’audience disponible ailleurs dans les statistiques du site. Par exemple, filtrez les notes d’une page par pays, ou regroupez ses retours par appareil ou par statut de visiteur authentifié.

Le filtre **Visiteur authentifié** indique si GitBook a identifié le visiteur lorsqu’il a laissé un avis :

* **Authentifié**: le visiteur s’est connecté ou est arrivé avec des revendications de visiteur signées.
* **Anonyme**: le visiteur est arrivé sans identification signée. Les revendications transmises dans les paramètres d’URL ou via un cookie public de visiteur ne sont pas signées.
* **Inconnu**: GitBook a enregistré l’événement avant le début du suivi de l’authentification des visiteurs, en août 2026.

{% hint style="info" %}
Pour isoler les retours d’un client ou d’un segment, filtrez par un attribut que vous transmettez via le contenu adaptatif. Par exemple, filtrez par un attribut client, forfait, rôle ou accès à une fonctionnalité. Cela n’affiche que les retours des visiteurs dont les événements incluent cette valeur d’attribut.

Les filtres de revendications utilisent uniquement celles qui sont configurées pour votre site. Ils ne déduisent pas l’identité des clients à partir du contenu des pages, des sections ou des variantes. Consultez [activer le contenu adaptatif](https://gitbook.com/docs/documentation/fr/publish/adaptive-content/enabling-adaptive-content.md) pour configurer les revendications des visiteurs.
{% endhint %}

Les filtres de retours vous aident à transformer les évaluations et les commentaires en mises à jour ciblées. Par exemple, vous pouvez :

* Identifier les pages ou sections ayant des notes plus faibles, puis examiner leurs commentaires.
* Comparer les retours des visiteurs authentifiés et anonymes afin d’identifier les lacunes spécifiques à votre audience.
* Vérifier les notes des pages qui varient selon l’attribut client, puis améliorer le contenu pour ce segment.

Pour utiliser ou analyser ces données en dehors de GitBook, ouvrez le menu de la carte et cliquez sur **Télécharger le fichier CSV**. L’export contient une ligne par note, avec le commentaire, un lien vers la page et l’heure à laquelle la note a été laissée.

## Recherche

La carte **Recherche** affiche les termes saisis par les lecteurs dans la recherche de votre site. Utilisez-la pour découvrir ce que les internautes s’attendent à trouver et quelles recherches votre contenu ne couvre pas encore. C’est un bon indicateur des prochains sujets à traiter ou des contenus qui existent, mais sont difficiles à trouver.

## D’où viennent vos lecteurs

Le reste du rapport décompose votre audience :

* **Plateforme**, **Pays**, et **Langues** : qui sont vos lecteurs et dans quelles langues ils lisent.
* **Sources de trafic** : les domaines et les URL qui vous envoient des visiteurs.
* **Campagnes** : répartition du trafic par `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, ou `utm_content`.
* **Heures d’activité**: les moments où votre site est le plus fréquenté, sous forme de carte thermique hebdomadaire.
* **Robots**: les pages vues par les robots d’exploration, exclues des chiffres relatifs aux lecteurs dans ce rapport.

Les sites qui utilisent [le contenu adaptatif](https://gitbook.com/docs/documentation/fr/publish/adaptive-content/enabling-adaptive-content.md) bénéficient également d’une carte **Attributs des visiteurs** qui présente le trafic selon les attributs que vous transmettez, par exemple un client, une formule ou un rôle.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/analytics/insights/traffic.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
