> 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](/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](/docs/documentation/fr/analytics/insights/agents-and-mcp.md): les LLM, les agents de codage et les robots d’exploration qui lisent votre site via Markdown, `llms.txt`, et le serveur MCP de votre site.
* [Assistant IA](/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 voir une vue d’ensemble de haut niveau de vos analyses sur l’ **Vue d’ensemble** écran, avec un globe qui montre les vues de la dernière heure par localisation.

Les liens entrants qui aboutissent sur une « page introuvable » sont signalés dans [Liens cassés](/docs/documentation/fr/analytics/broken-links.md), sous **Améliorer** dans la barre latérale du site, à côté des redirections que GitBook leur suggère.

{% 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 d’analyse**](/docs/documentation/fr/manage-your-site/site-settings.md#analytics-cookie) et désactivez ou supprimez l’ **Google Analytics** .
{% 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 [contenu adaptatif](/docs/documentation/fr/publish/adaptive-content/enabling-adaptive-content.md) peuvent également filtrer par revendications du visiteur, comme un client, un forfait, un rôle ou l’accès à une fonctionnalité, afin que vous puissiez voir comment un segment lit votre documentation.

## Périodes et comparaisons

Utilisez le filtre de temps dans n’importe quel rapport pour basculer entre les dernières 24 heures, les 7 derniers jours, les 30 derniers jours ou les 3 derniers mois. Cliquez sur **Plage personnalisée** pour choisir votre propre période dans le calendrier. Les rapports incluent les données d’aujourd’hui au fur et à mesure qu’elles arrivent.

Chaque indicateur en haut d’un rapport se compare à la période précédente, afin que vous puissiez voir ce qui évolue sans rien configurer. Pour comparer l’ensemble d’un rapport, ouvrez le sélecteur de comparaison à côté du filtre de temps et choisissez **Période précédente** ou **Même période l’an dernier**. Avec une comparaison 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 fenêtre de 12 mois vers l’arrière et s’arrête là où commence la fenêtre actuelle, afin qu’une plage de plus d’un an ne compte jamais un événement deux fois. La comparaison est enregistrée dans l’URL du rapport avec vos autres filtres, afin que vous puissiez partager une vue comparée.

## Exporter les données

Pour analyser les données en dehors de GitBook, ouvrez le menu sur 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](/docs/guides/docs-analytics/track-advanced-analytics-with-gitbooks-events-aggregation-api.md).

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

Dans le contexte des vues de page, Events correspondrait au nombre total de vues de page, et Visitors au nombre de visiteurs distincts effectuant une vue de page.
{% endhint %}

## Publicités et sponsoring

Les sites sur le [forfait de site sponsorisé](/docs/documentation/fr/account-and-billing/plans/community/sponsored-site-plan.md) bénéficient d’un rapport supplémentaire **Publicités et sponsoring** rapport, montrant les impressions, les clics, le taux de clics et les revenus, ainsi que les annonceurs et les pages correspondants.

## FAQ

<details>

<summary>Qui peut consulter les statistiques 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 le public auquel ils appartiennent. Search et les retours sur les pages font partie de [Trafic](/docs/documentation/fr/analytics/insights/traffic.md), l’activité MCP fait partie de [Agents et MCP](/docs/documentation/fr/analytics/insights/agents-and-mcp.md), et les questions posées à Ask AI font partie de [Assistant IA](/docs/documentation/fr/analytics/insights/ai-insights.md). Le rapport Broken URLs fait partie de [Liens cassés](/docs/documentation/fr/analytics/broken-links.md), sous **Améliorer**, à côté des redirections que GitBook suggère pour ces URL.

</details>

<details>

<summary>Pourquoi mes données de statistiques 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 not found » signifie que des visiteurs ont essayé d’ouvrir une page inexistante sur votre site. Pour voir quelles URL sont cassées, ouvrez [Liens cassés](/docs/documentation/fr/analytics/broken-links.md). De là, vous pouvez voir combien de visiteurs chaque lien cassé a eus et [créer des redirections](/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 que le suivi de l’authentification des visiteurs ne commence en août 2026.

GitBook étiquette ces événements plus anciens comme « Inconnu » plutôt que d’en déduire leur statut. Les rapports couvrant les périodes antérieures affichent donc la plupart 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
