Objectifs et entonnoirs

Les pages vues ne peuvent pas vous dire si la documentation a été utile. Un objectif consiste à définir ce que signifie « fonctionner » pour votre projet ; un entonnoir consiste à définir le parcours pour y parvenir. Tout ce qui suit est ensuite mesuré par rapport à ces définitions plutôt qu'à une valeur par défaut choisie par quelqu'un d'autre.

Ce que vous obtenez#

Nommez un résultat — reached_pricing, copied_the_install_snippet, left_for_signup — et Docsbook indique combien de visites l'ont accompli sur la période, avec la série quotidienne correspondante et (si vous avez indiqué la valeur de l'un d'eux) ce qu'elles valaient. Enchaînez-en plusieurs dans un parcours et vous obtenez un entonnoir étape par étape qui identifie la transition la plus problématique, et pas seulement l'étape la plus petite.

Les nouveaux objectifs sont comparés rétroactivement à l'historique déjà enregistré, de sorte qu'un objectif que vous déclarez aujourd'hui affiche immédiatement les chiffres de la semaine dernière au lieu de partir de zéro.

Les quatre types d’objectif#

Type	Correspond à	Utilisez-le pour
`page`	Un chemin de page	"Ils ont atteint la page des tarifs"
`event`	L’un des événements `docs.*` suivis	"Ils ont copié un bloc de code", "ils ont interrogé l’assistant"
`section`	Une ancre de titre affichée à l’écran, avec ou sans le `#`	"Ils sont descendus suffisamment loin dans la page pour atteindre les étapes d’installation"
`outbound`	Un hôte de destination vers lequel ils sont partis	"Ils sont allés vers votre application, votre dépôt ou l’inscription"

Un objectif event peut être limité à une seule page grâce à un périmètre facultatif, ce qui permet à un même événement de correspondre à deux objectifs différents — "ils ont copié l’extrait de démarrage rapide" et "ils ont copié l’extrait d’authentification" sont le même événement sur des pages différentes.

Comment cela est construit#

Compté par visite, jamais par événement. Un objectif section se déclenche chaque fois qu'un lecteur fait défiler la page au-delà de ce titre ; compter les événements indiquerait qu'une personne a généré cinq conversions. La valeur potentielle de l'entonnoir va plus loin et compte par personne : un lecteur qui a parcouru le chemin deux fois contribue à hauteur d'un seul lecteur, et non de deux.

L'ordre est imposé en comparant les heures des hits, et non leur appartenance. Pour chaque étape, Docsbook recherche le premier hit survenu à partir du hit de l'étape précédente. Un lecteur qui est arrivé d'abord à l'étape 3 et n'a vu l'étape 1 que plus tard n'est donc pas compté à juste titre comme ayant atteint l'étape 3.

La fenêtre de conversion délimite la durée pendant laquelle une étape ultérieure est encore comptabilisée. Laissez-la vide et la visite elle-même constitue la fenêtre, ce qui est la valeur par défaut la plus fiable pour un site de documentation. Définissez-la, et elle est limitée à l'historique réellement disponible : une fenêtre plus longue que la durée de conservation décrit des conversions qui ne peuvent jamais être observées.

Les taux sont masqués lorsque les données sont insuffisantes. Le taux de conversion global d'un entonnoir n'est pas affiché en dessous de 30 visites, et chaque étape est marquée lowSample lorsque l'étape précédente comptait moins de 30 visites — ainsi, une étape 2 solide affiche toujours un taux, tandis qu'une étape 5 reposant sur trop peu de données n'en affiche pas. Le délai médian et le p90 jusqu'à la conversion ne sont pas affichés en dessous de 5 conversions : la liste des convertis constitue la réponse, pas un percentile.

leak_index désigne la pire transition, et non l'étape la plus réduite. La plus petite étape est presque toujours la dernière ; c'est la plus forte baisse proportionnelle entre deux étapes adjacentes qui révèle l'endroit où le parcours se rompt réellement.

Les données financières restent désactivées tant que vous ne les activez pas. Une valeur d'objectif égale à 0 est refusée sans ambiguïté — null et 0 sont des affirmations différentes, et une seule d'entre elles a sa place dans un chiffre d'affaires. Lorsqu'aucune valeur n'est déclarée, les colonnes monétaires restent vides plutôt que $0.

Ce que le validateur refuse et ce contre quoi il se contente de vous avertir#

Ces règles sont appliquées de manière identique, que vous créiez un objectif dans le panneau, via MCP, ou par l’intermédiaire de l’assistant — une seule règle, afin qu’aucune interface n’accepte ce qu’une autre rejette.

Règle	Niveau	Justification fournie
Un objectif `event` nommant un événement que cette documentation n’émet pas	Refusé	Il ne pourrait jamais se déclencher, et un objectif qui ne se déclenche jamais ressemble exactement à un objectif avec 100 % d’abandon
Une valeur d’objectif de `0`	Refusé	`$0` est interprété comme une mesure plutôt que comme une déclaration absente
Un entonnoir comportant moins de 2 étapes	Refusé	Avec une seule étape, il n’y a aucune transition à mesurer — c’est un objectif
Une étape d’entonnoir nommant un objectif qui n’existe pas	Refusé	Un entonnoir qui ignore silencieusement une étape affiche un taux de conversion meilleur que le taux réel
Plus de 8 étapes	Refusé	Divisez-le en deux afin que chaque moitié ait un dénominateur utile à interpréter
Plus de 5 étapes	Avertissement	Même avec 60 % par étape, moins de 8 % atteignent la fin
Une page unique comme étape 1	Avertissement	La plupart des lecteurs de la documentation arrivent directement à une section depuis une recherche ou une réponse d’IA : une entrée trop étroite exclut la majorité du trafic avant même toute mesure
Un entonnoir se terminant par un défilement ou une consultation de section	Avertissement	Il mesure l’attention, pas le résultat
Un nom d’objectif contenant un chemin, un identifiant, `@` ou un long nombre	Avertissement	Il s’agit à la fois d’un problème de cardinalité et de confidentialité — les noms d’objectifs apparaissent dans les exports et les réponses de chat
Plus de 6 objectifs actifs	Avertissement	Au-delà de six, la liste cesse de classer les éléments et devient un journal

La suppression d’un objectif l’archive plutôt que de le détruire, car une étape d’entonnoir pointant vers un objectif disparu entraînerait sinon la suppression de l’étape elle-même.

Les rapports construits par-dessus#

Rapport	Ce qu’il permet de savoir
Vue d’ensemble des objectifs	Conversions par objectif sur la période, ainsi que la série quotidienne
Entonnoir	Achèvement étape par étape, part des visiteurs de l’étape précédente qui ont continué, principales sources et principaux pays à chaque étape, ainsi que `leak_index`
Parcours des objectifs	Toutes les personnes ayant atteint un objectif, et le temps qu’elles ont mis entre leur première visite et leur conversion
Visiteurs des objectifs	Lecteurs récents et objectifs atteints par chacun
Résultats des visites	Répartition entre réussite / impasse / rebond / partielle pour chaque visite, sans qu’aucun objectif ne soit déclaré
Entonnoir inversé	Remonte depuis les visites qui se sont bien terminées : quelles pages d’entrée mènent à la réussite et en combien d’étapes
Rétention	Taux de retour en S1/S4 par cohorte hebdomadaire

Le temps avant conversion est présenté sous forme de médiane et de p90, jamais de moyenne. Le temps avant conversion sur un site de documentation est bimodal — les lecteurs qui arrivent prêts à agir et ceux qui évaluent pendant des semaines — et la moyenne tombe dans la vallée vide entre ces deux modes, décrivant un visiteur qui n’existe pas.

L’entonnoir inversé ne nécessite aucune hypothèse. Un entonnoir déclaré ne peut mesurer que le parcours auquel vous avez pensé ; remonter depuis les visites réussies décrit le parcours réellement trouvé par les lecteurs, qui est souvent un parcours que personne n’a conçu. Lorsque ce parcours est réel, il faut promouvoir son point d’entrée dans la navigation.

La valeur potentielle est une part de préparation, pas une prévision. Lorsqu’un lecteur n’a pas converti, Docsbook peut tout de même le classer : l’outil établit un profil de ce à quoi ressemblaient les lecteurs convertis avant leur conversion — temps de lecture, pages consultées et, surtout, les pages que les lecteurs convertis ouvrent davantage que tous les autres — puis attribue un score à chaque lecteur en fonction de ce profil. Une page ouverte par 80 % des lecteurs convertis et 8 % de l’ensemble des lecteurs contient le signal ; une page ouverte par 92 % des lecteurs convertis et 90 % de l’ensemble ne révèle rien. Le profil n’est établi qu’à partir de 5 lecteurs convertis ou plus et comprend au maximum 12 parcours discriminants.

Pourquoi c'est la bonne méthode#

Règle	Pourquoi cela fonctionne	Source
Mesurer l'accomplissement des tâches, pas le trafic	"si les utilisateurs ne peuvent pas accomplir leur tâche cible, tout le reste est sans importance. La réussite de l'utilisateur est l'essentiel de l'utilisabilité" — Nielsen & Budiu, 2001, révisé en 2021	NN/g : taux de réussite
Masquer les taux lorsque les dénominateurs sont faibles	Le seuil de masquage est le même seuil de 30 visites que celui utilisé par tous les taux du produit ; il est appliqué à chaque étape, car les étapes ultérieures d'un entonnoir sont toujours les moins fournies	Comment fonctionne la mesure
Les étapes doivent être ordonnées, et pas seulement présentes	Un rapport non ordonné indiquant simplement « ces pages ont-elles été consultées ? » ne peut pas distinguer un parcours de trois arrivées indépendantes — c'est la même raison pour laquelle l'analyse des parcours existe plutôt qu'une liste des pages les plus consultées	Mécanisme, cette page
Compter les résultats par visite, attribuer la valeur par personne	Un défilement répété exprime deux fois l'intention d'un même lecteur ; l'additionner comme un revenu revient à faire inventer de l'argent à un entonnoir à partir d'un simple rechargement de page	Mécanisme, cette page

Limites et questions ouvertes#

Un visiteur correspond à une adresse IP hachée. Chaque décompte hérite de cette contrainte : le NAT d’entreprise regroupe les lecteurs, tandis que les réseaux mobiles les répartissent. Lisez les cinq lignes des visiteurs ayant un objectif pour savoir qui vous évalue ; ne considérez pas le total comme un nombre de personnes. Consultez Comment fonctionne la mesure.
La source affichée pour un parcours correspond au dernier contact et attribue trop de crédit à Direct. Considérez-la comme un indice, jamais comme une attribution.
Les cohortes de rétention sont limitées à un historique de 30 jours. W4 nécessite une fenêtre de 30 jours pour exister ; sur une période de 24 heures ou de 7 jours, sa valeur est structurellement nulle et ne signifie rien. Il n’existe pas de vue d’une année sur l’autre et il ne peut pas y en avoir.
La rétention n’a pas de direction universellement positive. Un retour élevé est bénéfique pour la documentation de référence et indique un échec pour l’intégration — le nombre ne peut pas savoir quelle section il décrit.
La valeur potentielle est déduite, et non ajustée. Ses pondérations ne sont pas calibrées sur un taux de base observé ; elle classe donc honnêtement les lecteurs les uns par rapport aux autres et ne doit jamais être additionnée pour constituer un indicateur de pipeline.
Un entonnoir mesure le parcours que vous avez déclaré. Si les lecteurs réussissent en empruntant un chemin que vous n’avez pas décrit, l’entonnoir indiquera un échec tandis que l’entonnoir inversé rapportera la vérité. Consultez les deux.

Fonctionnement de la mesure — la définition d’une visite, les filtres anti-bots et les seuils minimaux d’échantillon dont hérite chaque chiffre ici
Vue d’ensemble des analyses — le taux de conversion et les revenus dans la barre récapitulative
Référence des événements suivis — les noms d’événements auxquels un objectif event peut correspondre
Référence des outils MCP — create_goal, create_funnel, get_funnel, get_retention et le reste