Vue d’ensemble des statistiques

Un tableau de bord de documentation est facile à rendre impressionnant et difficile à rendre utilisable. La différence tient à la question de savoir si chaque chiffre précise ce qu’il ne peut pas voir. Cette page parcourt le panneau vignette par vignette et onglet par onglet et indique, pour chacun, ce qu’il compte, d’où il provient et quelle interprétation il ne permet pas de faire. Les définitions sous-jacentes — qui est compté comme visiteur, comment les robots et votre propre équipe sont exclus, combien de temps les données sont conservées — se trouvent dans le fonctionnement de la mesure et ne sont pas répétées ici.

Ce que vous obtenez#

Une page qui répond aux questions qu’un propriétaire se pose réellement, à partir d’une seule source. Six des sept tuiles principales sont des propriétés d’une visite, et toutes les six sont dérivées du même flux d’événements reconstruit plutôt que de six compteurs indépendants — ainsi, le taux de rebond ici et le taux de rebond dans la répartition des résultats correspondent au même calcul, et non à deux nombres portant le même nom. La consultation de ces données ne coûte rien sur le solde de votre projet, et aucune n’est soumise à une formule particulière.

Comment c’est construit#

Les sept vignettes#

Les revenus sont une vignette, mais jamais un graphique. Il s’agit des conversions multipliées par une constante, donc leur courbe serait la courbe des conversions avec une autre étiquette d’axe : un même fait représenté deux fois. Son évolution dans le temps se lit à partir du taux de conversion.

Une conversion est un clic depuis votre documentation vers l’hôte de votre URL d’appel à l’action. La correspondance se fait par hôte, avec www. inclus, tandis que les autres sous-domaines ne sont délibérément pas inclus — vos documents se trouvent généralement sur un sous-domaine, et cette inclusion compterait comme une vente le fait d’« être retourné à la documentation ». Un visiteur qui clique cinq fois est une seule conversion.

Les deux vignettes monétaires restent inactives tant que deux paramètres ne sont pas définis : l’URL d’appel à l’action détermine quel clic constitue une conversion, et le prix moyen du produit détermine ce qu’elle vaut. Tant que les deux ne sont pas définis, elles affichent un tiret et indiquent celui qui manque — jamais $0. Un prix manquant n’est pas un prix égal à zéro, et les revenus sont le chiffre sur lequel un propriétaire agit sans vérifier comment il a été produit. Les deux paramètres se trouvent dans Branding. Un prix enregistré de 0 est refusé par le validateur pour la même raison.

Les dépenses font exception à tous les égards. Il s’agit d’argent qui sort plutôt que d’une propriété d’une visite, elles proviennent du registre de facturation plutôt que du flux d’événements, et c’est le seul chiffre présenté ici dont 0 constitue une mesure réelle. Voici les conséquences à connaître :

• Elles ne sont pas compensées. Un approvisionnement supplémentaire ne les fait pas baisser ; les dépenses répondent à la question « combien ce projet m’a-t-il coûté ? », et cette question n’a qu’un seul sens.
• Elles ignorent vos filtres. Un filtre réduit les visites, et une exécution de traduction n’est pas une visite — « États-Unis » n’a rien à dire sur une tâche d’intégration.
• Elles subsistent lorsque la période est vide. Une exécution de traduction à 3 h du matin constitue une véritable facturation sans lecteur derrière, et c’est souvent l’information la plus utile que cette vignette puisse afficher. Toutes les autres vignettes affichent « aucune visite à mesurer » pour une telle période.
• Leur flèche n’a pas de couleur. Une hausse des dépenses parce que les lecteurs en demandent davantage signifie que le produit fonctionne ; une hausse parce qu’une tâche est bloquée signale un incendie. Toutes les autres variations sont vertes lorsqu’elles sont positives — une baisse du taux de rebond est verte — et celle-ci reste grise, car le panneau ne dispose d’aucun élément permettant de distinguer ces deux cas.
• Un registre illisible désactive la vignette et l’indique, plutôt que d’afficher $0. Ce qui est comptabilisé est expliqué dans Utilisation et coût de l’IA.

Chaque vignette affiche également l’évolution par rapport à la période immédiatement précédente de même durée. Une croissance à partir d’une valeur précédente de zéro n’affiche aucune flèche : elle est indéfinie, et non +100%.

Les quatre cartes de ventilation#

Chaque carte est une bande d’onglets à faire défiler ; dix des onglets correspondent à des dimensions classées issues du même flux de visites que les vignettes, et quatre proviennent d’ailleurs.

Les dimensions à valeur unique partitionnent la période — leurs nombres de visiteurs totalisent le total. Pages et Titres ne le font pas : la conversion d’une visite est attribuée à chaque page qu’elle a consultée ; ces lignes correspondent donc à un crédit assisté et totalisent délibérément plus que le total principal. La carte l’indique à l’écran.

Chaque ligne d’un onglet classé comporte les deux chiffres — le nombre de visiteurs qu’elle a attirés et ce qu’ils ont rapporté — avec deux barres en arrière-plan : l’une pour le critère de classement de la liste, l’autre toujours pour les revenus. Les lignes sont triées côté serveur par nombre de visiteurs, puis reclassées dans le navigateur, car un serveur renvoyant « les premières lignes par revenus » fournirait un ensemble différent selon l’option sélectionnée, et les lignes apparaîtraient et disparaîtraient lorsque vous changeriez d’option.

Pages et Titres proposent deux classements supplémentaires, Views et Reading time. Ils ont un sens pour une ligne qui désigne un emplacement dans votre documentation et aucun pour une ligne qui désigne un pays ; ils sont donc proposés ici et nulle part ailleurs. Une page sans mesures du temps de lecture affiche un tiret, jamais 0.

Filtrage#

Filtrer par ligne restreint tout — les autres cartes et les tuiles au-dessus du graphique — afin qu’un pays, un appareil ou un référent puisse être suivi de bout en bout. Les filtres se cumulent et sont supprimés en cliquant sur leur puce. Les cartes et les tuiles appliquent le même prédicat aux mêmes visites reconstituées, ce qui empêche que « États-Unis » ait une signification dans une carte et une autre dans le graphique situé au-dessus.

Les onglets comptabilisés par événement plutôt que par visite — Titres, UTM, Vues IA, Clics sur CTA, Retours et Recherches — ne peuvent pas être filtrés de cette manière. Ils l’indiquent au-dessus de leurs lignes lorsqu’un filtre est actif, au lieu d’afficher des chiffres non filtrés sous un intitulé filtré.

Les quatre onglets qui ne proviennent pas de vos visiteurs#

• Mot-clé provient de Google Search Console. Une impression qui ne devient jamais un clic est invisible pour tout ce qui s'exécute sur votre site ; il s'agit donc des données de Google : requêtes, position, impressions, clics et CTR. Connectez d'abord Search Console. Sa colonne de revenus est explicitement une estimation — clics × vos revenus par visiteur à l'échelle du site — indiquée et représentée comme telle, car un chiffre modélisé placé à côté de données mesurées ne doit pas leur ressembler.
• Clics sur les CTA classe chaque destination vers laquelle les lecteurs ont quitté votre documentation, ainsi que la page depuis laquelle ils l'ont fait.
• Retours classe les pages selon les pouces qui leur ont été attribués, les avis négatifs en premier : la page que les utilisateurs ont évaluée négativement est celle à réécrire. Les deux widgets de vote sont comptabilisés ensemble — l'évaluation en bas d'une page et les pouces sur une réponse d'IA fournie à cet endroit — car la question est de savoir quelle page les lecteurs approuvent, et non quel bouton ils ont utilisé. Les zéros sont toujours affichés.
• Recherches classe les termes saisis par les lecteurs dans votre champ de recherche sur la page, en indiquant la fréquence à laquelle une recherche a trouvé un résultat et celle à laquelle elle est revenue vide — les mêmes mots peuvent figurer dans les deux décomptes. Une requête sans résultat indique, avec leurs propres mots, ce que les lecteurs attendent de la documentation. Elle ne dispose d'aucun menu de métriques : ces lignes correspondent à une recherche, et non à une visite ; il n'y a donc aucun revenu sur lequel trier.

Canaux, et pourquoi une ligne de canal ne suffit pas#

L’onglet Canaux regroupe les visites selon le type de source — recherche organique, recherche payante, réseaux sociaux, assistant IA, site référent, accès direct, interne — classées lors de l’écriture de l’événement plutôt que lors de sa lecture. Cela compte à deux égards : les visites issues d’IA arrivent avec un référent vide, donc les regrouper uniquement par référent les enfouit dans les accès directs ; et un clic Google payant et un résultat Google organique partagent le même référent, de sorte qu’un utm_medium payant doit l’emporter. Survoler un canal indique les trois sites qui le composent réellement, avec leurs parts — une ligne de recherche organique qui est presque entièrement composée de Google et une autre répartie entre cinq moteurs correspondent à des situations différentes.

Vues IA#

Trois onglets, un pour chaque raison pour laquelle un robot d’exploration est venu, car les trois prennent en charge des décisions complètement différentes :

Dans chaque onglet, vous pouvez regrouper par Pages (les pages que les assistants lisent) ou par Robots d’exploration (une ligne par robot, identifiée par son fournisseur). La classification se fait selon le User-Agent à partir d’une table de 23 robots nommés, la première correspondance l’emporte — ainsi Applebot-Extended n’est jamais absorbé par Applebot — et un robot IA non reconnu est traité comme un robot d’entraînement, l’affirmation qui vous promet le moins.

Plages temporelles#

Aujourd’hui et Hier sont des jours calendaires en UTC, et non dans votre fuseau horaire local, et ne correspondent pas à une période glissante de 24 heures : au début de la journée UTC, Aujourd’hui couvre moins de temps que les Dernières 24 heures. Les données s’arrêtent au bout de trente jours.

Maintenant constitue sa propre période plutôt qu’un jour simplement renommé — une vue en direct n’est lisible qu’à la résolution de la minute, et une journée entière regroupée par minute représente 1 440 points. Dans Maintenant, les vignettes et le graphique sont actualisés toutes les 5 secondes et les cartes toutes les 30 secondes ; passez à toute autre période et l’actualisation s’arrête, de sorte qu’une période historique que vous ne consultez pas ne soit jamais récupérée de nouveau silencieusement sous vos yeux.

En ligne maintenant — les lecteurs actifs au cours des 5 dernières minutes — ne fait pas partie des sept vignettes. Il s’agit d’un indicateur de l’instant présent plutôt que d’un total sur la période choisie, il apparaît donc sous forme de pastille indépendante à côté du titre du panneau ; le placer dans la bande inciterait à le comparer à une période à laquelle il n’appartient pas.

Un rapport pour lequel vous n’avez pas encore de données#

Un onglet ne contenant aucune de vos propres lignes s’affiche sur des chiffres d’exemple estompés avec « Activer l’onglet » par-dessus, et le fait de cliquer dessus lance un court guide sur ces mêmes chiffres. Ce fonctionnement est propre à chaque onglet, et non à chaque carte — Entrée attribue une page par visite, tandis que Pages comptabilise chaque page consultée au cours d’une visite, et chaque réserve concerne l’onglet auquel elle se rapporte. L’activation ne bloque rien : tous les chiffres ont été collectés depuis le début, et votre choix est mémorisé dans votre navigateur pour chaque espace de travail.

Pourquoi est-ce la bonne méthode#

Limites et questions ouvertes#

• Chaque chiffre de visiteurs est une estimation, et le produit le précise. Un visiteur est une adresse IP hachée : un réseau d'entreprise se fond en un seul lecteur, un usager en déplacement se répartit sur plusieurs. Considérez-les comme une tendance, jamais comme un décompte.
• Les pourcentages fondés sur peu de visites indiquent une direction, pas une mesure. En dessous de 30 visites, le panneau le précise sous les chiffres plutôt que de citer un taux présenté avec assurance.
• Une fenêtre très large est lue à partir d'un échantillon, et cela est signalé. La reconstruction des sessions lit au maximum 50 000 événements ; atteindre cette limite active un indicateur truncated que la carte explicite en toutes lettres, car les taux calculés sur une fenêtre tronquée sont erronés.
• Les écarts disparaissent plutôt que de mentir. Si la lecture de la fenêtre précédente a échoué, aucun écart n'est affiché. Les lignes Pages et Titres attribuent volontairement trop de crédit — il s'agit d'un crédit assisté ; ne les additionnez pas.
• Le rebond est une description, pas un verdict. Une page, moins de trois secondes, rien d'autre — ce qui correspond aussi au comportement d'un lecteur qui a trouvé sa réponse en un coup d'œil.
• Point à éclaircir : le « temps de session » ne mesure pas l'attention. Ce qui est vérifiable, c'est le mécanisme — des segments, un seuil de trois secondes, un plafond de 300 secondes par segment, moyennés sur les visites. Ce qui n'est vérifiable à partir d'aucune donnée d'analyse web, c'est de savoir si une personne regardait l'écran, et ce panneau ne le laisse pas entendre. Voir le temps de lecture.
• Trente jours constituent tout l'historique. Pas de comparaison d'une année sur l'autre, pas de saisonnalité, pas de cohorte de plus de quatre semaines.

Comment l’ouvrir#

Ouvrez n’importe quelle page de votre site de documentation et cliquez sur l’onglet Analytique dans la barre d’outils flottante en bas. La vue d’ensemble se charge avec la plage que vous avez sélectionnée en dernier, dont elle se souvient d’une visite à l’autre.

Articles connexes#

• Fonctionnement de la mesure — identification des visiteurs, filtrage des robots et des propriétaires, conservation, confidentialité
• Événements suivis — chaque événement à l’origine de ces chiffres
• Utilisation et coût de l’IA — ce que comptabilise la tuile Spend
• Temps de lecture — le classement par temps de lecture, dans son intégralité
• Pays — les onglets Pays et Langues sous forme de rapport distinct
• Objectifs et entonnoirs — mesurer un résultat que vous avez défini plutôt qu’une valeur par défaut
• Image de marque — les deux paramètres qui activent Revenue