Insights du site

Consultez les analyses et informations liées au trafic de votre documentation publiée

This feature is available on Premium and Ultimate site plans.

Les Insights vous fournissent des informations sur le contenu que vous avez publié et sur ses performances. Ils sont répartis entre différentes sections — Trafic, Pages et retours, Recherche, Demander à l’IA, Liens, et OpenAPI.

Vous pouvez voir un aperçu de haut niveau de vos insights sur l’ Aperçu onglet du tableau de bord de votre site, avec un globe qui montre les vues de la dernière heure par emplacement.

Cliquez sur le onglet Insights dans l’en-tête du site pour trouver des insights plus détaillés pour votre site.

A GitBook screenshot showing the site insights dashboard
Le tableau de bord des insights du site.

Filtres et groupes

Vous pouvez ajouter des filtres ou regrouper vos données pour les visualiser de façons spécifiques. 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 les données analytiques précises pour suivre les événements qui sont importants pour vous.

Afficher par périodes personnalisées

Vous pouvez utiliser le menu déroulant à droite de l’écran Insights pour changer 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 le Sélectionner une plage de dates personnalisée bouton à droite du menu et choisissez votre période personnalisée à l’aide du calendrier qui apparaît.

Types de données

L’onglet Insights est divisé en six sections, chacune centrée sur un type de données spécifique.

Trafic

GitBook suit les vues de pages pour vous aider à comprendre la popularité et la portée de votre contenu. Chaque fois qu’un utilisateur visite une page de votre site de documentation, cela est comptabilisé 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, y compris les pays, les langues, les navigateurs et plus encore.

Pages et retours

Pages et retours vous permettent de voir une représentation générale de la façon 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 dans le Personnaliser menu pour un site, vous pouvez voir la note moyenne de retour de chaque page.

Si vous souhaitez utiliser ou analyser ces données en dehors de GitBook, cliquez sur Télécharger CSV pour télécharger un .csv fichier sur votre appareil.

Vous pouvez également voir une liste de commentaires laissés par des visiteurs qui évaluent vos pages, afin d’obtenir des insights exploitables sur la façon d’améliorer votre documentation.

Pourquoi ne puis‑je pas voir de données de retours pour mon site ? Nous n’affichons les données que pour les sites publiés avec les évaluations de pages activées. Si votre site n’est pas publié ou n’a pas les évaluations de pages activées, vous ne verrez aucun insight.

URL cassées

Les URL cassées montrent les liens entrants provenant de sources externes qui entraînent une erreur « Page non trouvée ». Il peut s’agir d’URL mal tapées, de liens obsolètes sans redirections, ou de liens de spam.

Si un lien cassé pointe vers un sujet qui existe ailleurs dans votre documentation, ou si vous voulez simplement diriger le trafic vers votre documentation principale, vous pouvez configurer des redirections de site pour orienter correctement ces visiteurs.

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 performent le mieux et lesquels vous pourriez améliorer.

Les informations ici peuvent être utiles pour informer votre architecture de 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 vos visiteurs recherchent.

Demander à l’IA

La Demander à l’IA section vous permet de voir ce que vos utilisateurs demandent lorsqu’ils utilisent GitBook AI. Cet insight vous aide à identifier les questions fréquentes, découvrir 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 fournies par l’IA à leurs questions. En examinant ces requêtes et leurs évaluations, vous pouvez affiner la structure de votre documentation, améliorer la découvrabilité et identifier les domaines qui bénéficieraient d’informations supplémentaires 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 insights sur les liens externes, leurs domaines et leur emplacement au sein de vos docs, 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

La OpenAPI La vue analytics dans GitBook fournit des insights sur la façon dont les utilisateurs interagissent avec votre documentation API.

Elle suit des interactions telles que les vues d’endpoints, les recherches de paramètres et les explorations de 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 insights vous permettent d’affiner votre documentation, d’améliorer l’expérience des développeurs et de garantir que le contenu de votre API répond efficacement aux besoins des utilisateurs.

Mis à jour

Ce contenu vous a-t-il été utile ?