> 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.md).

# Statistiques du site

Consultez les statistiques liées au trafic et à l’utilisation de votre documentation publiée

Les analyses du site vous donnent des informations sur le contenu que vous avez publié et sur ses performances. Elles sont réparties en rapports, chacun axé sur un public :

* [Trafic](https://gitbook.com/docs/documentation/fr/analytics/insights/traffic.md): les personnes qui lisent votre site, les pages sur lesquelles elles arrivent, ce qu’elles recherchent et les commentaires qu’elles laissent.
* [Agents et MCP](https://gitbook.com/docs/documentation/fr/analytics/insights/agents-and-mcp.md) : les LLM, les agents de programmation et les robots d’exploration qui consultent votre site au format Markdown, `llms.txt`, ainsi que le serveur MCP de votre site.
* [Assistant IA](https://gitbook.com/docs/documentation/fr/analytics/insights/ai-insights.md): ce que vos visiteurs demandent à GitBook Assistant, et dans quelle mesure votre contenu y répond.

Pour ouvrir un rapport, accédez à **Analyser** dans la barre latérale de votre site. Vous pouvez également consulter une vue d’ensemble de vos statistiques sur l’écran **Vue d’ensemble** de votre site, avec un globe indiquant les vues par emplacement au cours de la dernière heure.

Les liens entrants qui mènent à une page « Page introuvable » sont signalés dans [Liens cassés](https://gitbook.com/docs/documentation/fr/analytics/broken-links.md), sous **Améliorer** dans la barre latérale du site, avec les redirections que GitBook suggère pour ces liens.

{% hint style="info" %}
Si vous connectez **Google Analytics**, votre site peut afficher un avis relatif aux cookies. Pour le supprimer, ouvrez [**Paramètres du site → Cookie Analytics**](https://gitbook.com/docs/documentation/fr/manage-your-site/site-settings.md#analytics-cookie) et désactivez ou supprimez l’ **Google Analytics** intégration.
{% endhint %}

## Filtres

Chaque rapport comporte une barre de filtres en haut. Ajoutez un filtre pour restreindre un rapport aux données qui vous intéressent : une section, une variante ou une page précise du site, ou un public défini par le pays, la langue, l’appareil, le navigateur, le référent, la campagne ou le statut de visiteur authentifié. Les filtres s’appliquent à toutes les cartes du rapport en même temps.

Les sites utilisant le [contenu adaptatif](https://gitbook.com/docs/documentation/fr/publish/adaptive-content/enabling-adaptive-content.md) peuvent également filtrer les données selon les attributs des visiteurs, comme le statut de client, le forfait, le rôle ou l’accès aux fonctionnalités, afin d’analyser la façon dont un segment donné consulte votre documentation.

## Périodes et comparaisons

Utilisez le filtre temporel de n’importe quel rapport pour passer des dernières 24 heures aux 7 derniers jours, aux 30 derniers jours ou aux 3 derniers mois. Cliquez sur **Plage personnalisée** pour choisir une période dans le calendrier. Les rapports incluent les données du jour au fur et à mesure de leur arrivée.

Chaque valeur en haut d’un rapport est comparée à celle de la période précédente, ce qui vous permet de repérer les évolutions sans rien configurer. Pour comparer un rapport entier, ouvrez le sélecteur de comparaison à côté du filtre temporel et choisissez **Période précédente** ou **Même période l’an dernier**. Lorsqu’une comparaison est activée, le rapport change de trois façons :

* Les indicateurs affichent la variation et la valeur précédente dont ils proviennent.
* Les graphiques affichent la période précédente sous chaque série.
* Les lignes de répartition affichent une flèche de tendance, avec la variation et la valeur précédente dans son infobulle.

**Même période l’an dernier** décale la période de 12 mois vers le passé et s’arrête au début de la période actuelle, afin qu’une plage de plus d’un an ne comptabilise jamais deux fois le même événement. La comparaison est enregistrée dans l’URL du rapport, avec vos autres filtres, pour que vous puissiez partager une vue comparée.

## Interroger l’agent GitBook

Cliquez **Interroger l’agent GitBook**, à côté de **Filtrer** en haut d’un rapport, pour interroger [l’agent GitBook](https://gitbook.com/docs/documentation/fr/agent-gitbook/overview.md) sur les données de votre site. L’agent peut répondre à vos questions à partir de vos données analytiques et créer des graphiques au fil de la conversation pour étayer ses réponses, y compris pour des sujets couverts par aucun rapport prédéfini.

{% hint style="info" %}
Les réponses analytiques de l’agent GitBook sont disponibles avec les offres Ultimate et Enterprise.
{% endhint %}

## Exporter les données

Pour analyser les données en dehors de GitBook, ouvrez le menu d’une carte et cliquez sur **Télécharger le CSV**. Pour créer vos propres rapports à partir des événements sous-jacents, consultez le [Guide de l’API d’agrégation des événements](https://gitbook.com/docs/guides/docs-analytics/track-advanced-analytics-with-gitbooks-events-aggregation-api.md).

{% hint style="success" %}
Dans l’ensemble des statistiques du site, vous voyez les métriques **Événements** et **Visiteurs** . **Événements** indique le nombre total d’occurrences pour une catégorie donnée, tandis que **Visiteurs** indique le nombre de visiteurs uniques qui effectuent les actions.

Dans le contexte des pages vues, les événements correspondraient au nombre total de pages vues, et les visiteurs au nombre de visiteurs distincts effectuant une page vue.
{% endhint %}

## Publicités et sponsoring

Les sites utilisant le forfait [site sponsorisé](https://gitbook.com/docs/documentation/fr/compte-et-facturation/plans/community/sponsored-site-plan.md) disposent également d’un rapport **Publicités et parrainages** qui présente les impressions, les clics, le taux de clics et les revenus, ainsi que les annonceurs et les pages associés.

## FAQ

<details>

<summary>Qui peut consulter les données analytiques du site ?</summary>

Toute personne ayant accès au site peut consulter ses analyses — y compris les lecteurs, les relecteurs et les éditeurs. Les créateurs et les administrateurs peuvent également accéder aux paramètres et à la personnalisation du site.

</details>

<details>

<summary>Où sont passés Search, Pages &#x26; feedback, MCP, Ask AI et Broken URLs ?</summary>

Ils sont toujours là, regroupés avec l’audience à laquelle ils appartiennent. La recherche et les commentaires sur les pages font partie de [Trafic](https://gitbook.com/docs/documentation/fr/analytics/insights/traffic.md), l’activité MCP fait partie de [Agents et MCP](https://gitbook.com/docs/documentation/fr/analytics/insights/agents-and-mcp.md), et les questions posées à Ask AI font partie de [Assistant IA](https://gitbook.com/docs/documentation/fr/analytics/insights/ai-insights.md). Le rapport sur les URL brisées fait partie de [Liens cassés](https://gitbook.com/docs/documentation/fr/analytics/broken-links.md), dans **Améliorer**, à côté des redirections que GitBook suggère pour ces URL.

</details>

<details>

<summary>Pourquoi mes données analytiques ne se chargent-elles pas ?</summary>

Si le tableau de bord d’analyses ne se charge pas, c’est généralement parce qu’un bloqueur de publicité ou une extension de confidentialité bloque les scripts d’analyse. Désactivez temporairement l’extension et rechargez la page, ou ajoutez GitBook et les services qu’il utilise à la liste d’autorisation de l’extension.

</details>

<details>

<summary>Que signifie « Page not found » ?</summary>

« Page introuvable » signifie que des visiteurs ont essayé d’ouvrir une page de votre site qui n’existe pas. Pour voir quelles URL sont brisées, ouvrez [Liens cassés](https://gitbook.com/docs/documentation/fr/analytics/broken-links.md). Vous pouvez alors voir combien de visiteurs ont utilisé chaque lien brisé et [créer des redirections](https://gitbook.com/docs/documentation/fr/publish/site-redirects.md) si nécessaire.

</details>

<details>

<summary>Que signifie « Not set » dans les données de référent ?</summary>

Les référents « Not set » indiquent un trafic direct — les visiteurs ont saisi votre URL directement, utilisé un marque-page ou cliqué sur des liens provenant d’e-mails et d’applications qui ne transmettent pas les données de référent.

</details>

<details>

<summary>Que signifie « Authenticated visitor » ?</summary>

Le filtre « Authenticated visitor » indique si GitBook a pu identifier un visiteur au moment où l’événement s’est produit.

Les visiteurs sont comptés comme « Authenticated » lorsqu’ils se sont connectés via l’authentification des visiteurs ou qu’ils sont arrivés avec des attributs de visiteur signés, par exemple sur des sites utilisant du contenu adaptatif. Les attributs de personnalisation transmis via des paramètres d’URL ou le cookie public du visiteur ne sont pas signés, donc ces visiteurs sont comptés comme « Anonymous ».

</details>

<details>

<summary>Que signifie « Unknown » pour les visiteurs authentifiés ?</summary>

« Inconnu » signifie que GitBook a enregistré l’événement avant le début du suivi de l’authentification des visiteurs, en août 2026.

GitBook attribue la valeur « Inconnu » à ces événements antérieurs plutôt que d’en déduire le statut. Les rapports couvrant des périodes antérieures affichent donc la majeure partie du trafic comme « Inconnu ». La répartition entre « Authentifié » et « Anonyme » est pertinente à partir d’août 2026.

</details>


---

# 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.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.
