> 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
La **Trafic** ce rapport couvre les personnes qui lisent votre documentation. Les machines qui lisent à leurs côtés, comme les LLM, les agents et les robots d’exploration, sont comptées séparément dans [Agents et MCP](/docs/documentation/fr/analytics/insights/agents-and-mcp.md), donc les chiffres ici reflètent les lecteurs humains.
Pour l’ouvrir, allez à **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 que vous avez sélectionnée, chacun comparé à la période précédente, suivi d’un graphique des lecteurs au fil du temps. Voir [Statistiques du site](/docs/documentation/fr/analytics/insights.md) pour les filtres, les périodes et la comparaison des périodes.
Le rapport Trafic.
## Pages et retours
**Pages principales** classe les pages que vos lecteurs ouvrent, afin que vous puissiez voir à quoi sert votre site.
À côté, **Retours sur la page** montre comment les lecteurs évaluent votre contenu une fois que vous avez activé [l’évaluation des pages](/docs/documentation/fr/manage-your-site/site-settings.md#page-ratings-pro-and-enterprise-plans) dans le **Personnaliser** le menu, ainsi que les commentaires qu’ils ont laissés. Les pages les moins bien notées, lues avec leurs commentaires, sont généralement le point de départ le plus rapide pour améliorer votre documentation.
{% hint style="info" %}
**Pourquoi ne vois-je aucune donnée de retour pour mon site ?**\
Nous n’affichons des données que pour les sites publiés avec les évaluations de page activées. Si votre site n’est pas publié ou n’a pas les évaluations de page activées, vous ne verrez aucune donnée de retour.
{% 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é.
La **visiteur authentifié** filtre indique si GitBook a identifié le visiteur lorsqu’il a laissé un retour :
* **Authentifié**: Le visiteur s’est connecté ou est arrivé avec des attributs de visiteur signés.
* **Anonyme**: Le visiteur est arrivé sans identification signée. Les attributs transmis via des paramètres d’URL ou un cookie public de visiteur ne sont pas signés.
* **Inconnu**: GitBook a enregistré l’événement avant que le suivi de l’authentification des visiteurs ne commence 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 d’attributs n’utilisent que les attributs configurés pour votre site. Ils n’inférent pas l’identité du client à partir du contenu, des sections ou des variantes de la page. Consultez [l’activation du contenu adaptatif](/docs/documentation/fr/publish/adaptive-content/enabling-adaptive-content.md) pour configurer les attributs du visiteur.
{% 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 CSV**. L’export comporte une ligne par évaluation, avec le commentaire, un lien vers la page et l’heure à laquelle l’évaluation a été laissée.
## Recherche
La **Recherche** La carte montre ce que les lecteurs ont saisi dans la recherche de votre site. Utilisez-la pour découvrir ce que les gens s’attendent à trouver, et quelles recherches votre contenu ne couvre pas encore. C’est un bon signal pour savoir quoi écrire ensuite, ou pour du contenu qui existe mais est difficile à trouver.
## D’où viennent vos lecteurs
Le reste du rapport décompose votre audience :
* **Plateforme**, **Pays**, et **Langues** : qui sont vos lecteurs et sur quoi ils lisent.
* **Sources de trafic** : les domaines et URL qui vous envoient des visiteurs.
* **Campagnes** : trafic ventilé par `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, ou `utm_content`.
* **Heures d’activité** : quand votre site est le plus fréquenté, sous forme de carte thermique sur la semaine.
* **Bots** : pages vues par les robots d’exploration, exclues des chiffres de lecteurs dans ce rapport.
Les sites utilisant [contenu adaptatif](/docs/documentation/fr/publish/adaptive-content/enabling-adaptive-content.md) obtiennent également une **Attributs des visiteurs** carte, montrant le trafic selon les déclarations que vous transmettez, par exemple un client, un forfait 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=&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.
