> 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/docs-site/insights.md).
# Analyses du site
{% hint style="info" %}
Cette fonctionnalité est disponible sur [les formules de site Premium et Ultimate](https://www.gitbook.com/pricing).
{% endhint %}
Les analyses du site vous fournissent des informations sur le contenu que vous avez publié et ses performances. Elles sont réparties en différentes sections — **Trafic**, **Pages et retours**, **Agents et LLM**, **Recherche**, **Demander à l’IA**, **Liens**, **MCP**, et **OpenAPI**.
Vous pouvez voir une vue d’ensemble de haut niveau de vos analyses sur l’écran de votre site, sous **Aperçu** dans **Général** dans la barre latérale du site, avec un globe qui affiche les vues de la dernière heure par lieu.
Cliquez sur **Analyses** dans l’en-tête du site pour ouvrir les analyses du site de votre site.
{% 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/docs-site/site-settings.md#analytics-cookie) et désactivez ou supprimez l’ **Google Analytics** intégration.
{% endhint %}
Le tableau de bord des analyses du site.
### Filtres et groupes
Vous pouvez ajouter des filtres ou regrouper vos données pour les visualiser de manière spécifique. Par exemple, vous pouvez consulter les données de recherche dans une section spécifique du site, ou filtrer vos données de trafic par pays, appareil, navigateur et plus encore.
En combinant filtres et groupes, vous pouvez approfondir des données d’analyse précises afin de suivre les événements qui sont importants pour vous.
### Afficher par périodes personnalisées
Vous pouvez utiliser le filtre de temps à droite de l’ **Analyses** écran pour modifier la période entre les dernières 24 heures, 7 jours, 30 jours ou 3 mois.
Pour afficher les données sur une période personnalisée, cliquez sur **Plage personnalisée** pour choisir votre période personnalisée dans le calendrier.
### Types de données
Les analyses du site sont réparties en sept sections, chacune axée sur un type de données spécifique.
#### Trafic
GitBook suit les vues de page pour vous aider à comprendre la popularité et la portée de votre contenu. Chaque fois qu’un utilisateur visite une page sur votre site de documentation, cela est compté comme une vue de page.
Les vues de page sont essentielles pour évaluer l’efficacité de votre stratégie de contenu et optimiser votre documentation en fonction de l’intérêt des utilisateurs. Elles sont réparties entre différentes vues et profils, notamment les pays, langues, navigateurs et plus encore.
{% hint style="success" %}
Dans l’ensemble des analyses du site, vous verrez les métriques Événements et Visiteurs. **Événements** indiquent le nombre total d’occurrences pour une catégorie donnée, tandis que **Visiteurs** indique les utilisateurs uniques effectuant les actions.
Dans le contexte des vues de page, les Événements correspondraient au nombre total de vues de page, et les Visiteurs au nombre d’utilisateurs distincts effectuant une vue de page.
{% endhint %}
#### Pages et retours
Pages et retours vous permettent de voir une représentation globale de la manière dont vos utilisateurs évaluent votre contenu. Vous verrez un aperçu de toutes les sections et variantes de votre site, et après avoir activé [l’évaluation des pages](/docs/documentation/fr/docs-site/site-settings.md#page-ratings-pro-and-enterprise-plans) dans le **menu Personnaliser** d’un site, vous pouvez voir la note moyenne de retour de chaque page.
Si vous souhaitez utiliser ou analyser davantage ces données en dehors de GitBook, cliquez sur **Télécharger le CSV** pour télécharger un `.csv` fichier sur votre appareil.
Vous pouvez également voir une liste de commentaires laissés par les visiteurs qui évaluent vos pages, afin d’obtenir des informations exploitables sur la manière d’améliorer votre documentation.
{% hint style="info" %}
**Pourquoi ne puis-je voir aucune donnée de retour pour mon site ?**\
Nous n’affichons des données que pour les sites publiés avec l’évaluation des pages activée. Si votre site n’est pas publié ou n’a pas l’évaluation des pages activée, vous ne verrez aucune donnée d’analyse.
{% endhint %}
#### Agents et LLM
Suivez le trafic provenant des LLM, des agents de codage et des robots.
Cette vue affiche les requêtes vers `llms.txt`, `llms-full.txt`, ainsi que les pages Markdown. Vous pouvez également examiner quels agents accèdent le plus souvent à votre contenu.
#### URL brisées
Les URL brisées affichent tous les liens entrants provenant de sources externes qui entraînent une erreur « Page introuvable ». Il peut s’agir d’URL mal saisies, de liens obsolètes sans redirection ou de liens indésirables.
Si un lien brisé pointe vers un sujet qui existe ailleurs dans votre documentation, ou si vous souhaitez simplement diriger le trafic vers votre documentation principale, vous pouvez configurer [des redirections du site](/docs/documentation/fr/docs-site/site-redirects.md) pour orienter ces visiteurs dans la bonne direction.
#### Recherche
Vous pouvez mesurer et améliorer votre documentation en vérifiant quels mots-clés sont le plus utilisés par les utilisateurs qui recherchent dans votre documentation. Cette vue vous permet de voir quels mots-clés donnent les meilleurs résultats et lesquels vous pourriez améliorer.
Les informations ici peuvent aider à orienter l’architecture de votre contenu, à rendre certaines parties de votre documentation plus faciles à trouver sans recherche, ou à ajouter du contenu supplémentaire aux pages existantes en fonction de ce que recherchent vos visiteurs.
#### Demander à l’IA
Le [Demander à l’IA](/docs/documentation/fr/creating-content/searching-your-content/gitbook-ai.md) section vous permet de voir ce que vos utilisateurs demandent lorsqu’ils utilisent GitBook AI. Cet aperçu vous aide à identifier les questions fréquentes, à repérer les lacunes de votre documentation et à améliorer le contenu pour mieux répondre aux besoins des utilisateurs.
Vous pouvez également voir comment les utilisateurs évaluent les réponses que l’IA donne à leurs questions. En examinant ces requêtes et leurs notes, vous pouvez affiner la structure de votre documentation, améliorer sa découvrabilité et identifier les domaines qui bénéficieraient de davantage d’informations documentées.
#### Liens
GitBook suit les liens pour vous aider à comprendre comment les utilisateurs interagissent avec les ressources externes dans votre documentation. Cette fonctionnalité fournit des informations sur les liens externes, leurs domaines et leur emplacement dans votre documentation, par exemple dans l’en-tête, le pied de page ou la barre latérale. L’analyse de l’utilisation des liens peut vous aider à optimiser la navigation, améliorer l’accessibilité du contenu et affiner votre stratégie de documentation en fonction de l’engagement des utilisateurs.
#### OpenAPI
Le [OpenAPI](/docs/documentation/fr/api-references/openapi.md) la vue d’analyse dans GitBook fournit des informations sur la façon dont les utilisateurs interagissent avec votre documentation d’API.
Elle suit des interactions telles que les vues de points de terminaison, les recherches de paramètres et l’exploration des requêtes, vous aidant à comprendre quelles parties de votre API sont les plus consultées et où les utilisateurs peuvent avoir besoin de plus de clarté. Ces informations vous permettent d’affiner votre documentation, d’améliorer l’expérience développeur et de vous assurer que le contenu de votre API répond efficacement aux besoins des utilisateurs.
#### MCP
Voyez comment le contenu de votre site est consulté via [MCP](/docs/documentation/fr/ia-et-recherche/mcp-servers-for-published-docs.md) des intégrations. Vous pouvez consulter les requêtes MCP au fil du temps et voir quels robots et agents accèdent au contenu de votre site.
### FAQ des analyses du site
#### Qui peut consulter les analyses du site ?
Toute personne ayant accès au site peut consulter ses analyses — y compris les lecteurs, les réviseurs et les éditeurs. Les créateurs et les administrateurs peuvent également accéder aux paramètres et à la personnalisation du site.
#### Pourquoi mes données d’analyse ne se chargent-elles pas ?
Si le tableau de bord d’analyse ne se charge pas, c’est généralement parce qu’un bloqueur de publicités 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.
#### Que signifie « Page introuvable » ?
« Page introuvable » signifie que les visiteurs ont essayé d’ouvrir une page de votre site qui n’existe pas. Le tableau ne compte que les visites sur votre page par défaut « Page introuvable ». Pour voir quelles URL sont brisées, ouvrez **URL brisées** dans les analyses du site — à partir de là, vous pouvez voir combien de visiteurs chaque lien brisé a reçus et [créer des redirections](/docs/documentation/fr/docs-site/site-redirects.md) si nécessaire.
#### Que signifie « Non défini » dans les données de référent ?
Les référents « Non défini » indiquent un trafic direct — les visiteurs ont saisi votre URL directement, ont utilisé un favori ou ont cliqué sur des liens depuis des e-mails et des applications qui ne transmettent pas de données de référent.
---
# 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/docs-site/insights.md?ask=&goal=
```
`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.