Docsbook
Aperçu

Pays et langues

Deux questions semblent n’en faire qu’une, mais ce n’est pas le cas. « Où se trouvent mes lecteurs ? » trouve sa réponse dans une recherche d’adresse IP et la réponse est fiable au niveau du pays. « Quelle langue souhaitent-ils ? » n’est indiqué nulle part dans ce produit, et cette page prend soin de le préciser — ce qui est mesuré à la place, c’est la traduction de votre documentation sur laquelle les lecteurs ont effectivement fini, ce qui constitue une donnée d’offre, et non une donnée de demande.

Le rapport utile est la combinaison des deux : un pays qui vous envoie des lecteurs, mais dont aucun n’arrive sur une page traduite, est un marché que vous attirez déjà et que vous perdez à la barrière linguistique.

Ce que vous obtenez#

Trois indicateurs, à deux endroits :

Indicateur Emplacement Ce qu’il répertorie
Onglet Pays Analytics → Audience Vos 15 principaux pays selon le nombre de lecteurs distincts, chacun avec le nombre de visiteurs, de vues et les revenus, et chacun pouvant être utilisé comme filtre du tableau de bord
Onglet Langues Analytics → Audience Les mêmes visites, classées selon la traduction qu’elles ont consultée
Liste des pays + carte des lecteurs Panneau des traductions Vos 30 principaux pays, chacun associé à la proportion de lecteurs de ce pays ayant consulté une page traduite, avec une couleur indiquant la qualité de leur prise en charge

La consultation de ces données ne déduit rien du solde de votre projet. Les onglets Pays et Langues sont disponibles avec tous les forfaits ; la page par langue et la carte zoomable des visiteurs sont payantes.

Comment le pays est déterminé#

À la périphérie, à partir de l’adresse IP, côté serveur. Le réseau qui diffuse votre documentation résout l’adresse IP de la requête en code pays et l’associe à la consultation de page avant son stockage, avec la région, la ville et les coordonnées déterminées. Rien n’est demandé au navigateur et aucune autorisation de localisation n’est jamais requise.

Lorsque la recherche ne renvoie rien, le champ est entièrement omis au lieu d’être enregistré comme vide. Cette distinction est déterminante : un champ explicitement vide est considéré comme présent mais vierge par la couche de requête, ce qui rendrait « nous ne savons pas » impossible à distinguer d’une valeur réelle. Une consultation de page sans pays reste une consultation de page et est toujours comptabilisée partout ailleurs.

Les coordonnées sont enregistrées en totalité ou pas du tout — une latitude sans longitude placerait un lecteur dans le golfe de Guinée — et leur plage est vérifiée avant leur stockage.

La région, la ville et les coordonnées sont collectées, mais utilisées par une seule interface : la carte des visiteurs avec zoom. Les affichages des pays utilisent le code pays et rien de plus précis.

Comment la langue est déterminée#

À partir du préfixe de langue de l’URL sur laquelle le lecteur est arrivé. C’est la seule source. Docsbook prend en charge 15 codes de langue ; lorsque le premier segment du chemin en est un et qu’il s’agit d’une langue que vous avez activée, cette langue est celle de la visite. En l’absence de préfixe, la visite n’a pas de langue et est comptabilisée comme une lecture de votre version originale.

Ce que ce n’est pas :

  • Pas Accept-Language. Docsbook ne lit jamais cet en-tête, où que ce soit.
  • Pas navigator.language.
  • Pas une préférence de lecteur enregistrée.

Docsbook ne redirige pas non plus les lecteurs selon leur langue et ne les achemine pas selon leur zone géographique ; un lecteur accède donc à une traduction en la choisissant — dans le sélecteur de langue, via un lien ou depuis un résultat de recherche. C’est ce qui rend le chiffre honnête, mais aussi ce qui le limite : il mesure quelle traduction a été lue, et non celle qui était souhaitée. Un lecteur qui aurait préféré l’allemand, n’aurait jamais trouvé la version allemande et aurait lu la version anglaise est comptabilisé comme un lecteur anglophone.

Les deux indicateurs de langue diffèrent sur un point important à connaître :

  • La liste des langues du panneau Traductions affiche uniquement le trafic des traductions — votre langue par défaut est exclue, car la langue d’origine d’un site n’est pas une traduction.
  • L’onglet Analytics → Audience → Langues inclut tout et classe les visites sans préfixe de langue sous Inconnu.

Comment les rapports sont créés#

L’onglet Pays (Analyses → Audience)#

Un pays par visite — le premier pays non vide dans les événements de cette visite — ce qui rend la dimension à valeur unique, de sorte que ses nombres de visiteurs répartissent la période et correspondent au total. Les visites sont interrompues après 30 minutes d’inactivité. Les robots et votre propre équipe sont exclus, comme partout sur cette page. La liste contient les 15 premiers, classés côté serveur par nombre de visiteurs, de sorte que changer la métrique réorganise une liste plutôt que d’en récupérer une autre. Les lignes pour lesquelles aucun pays n’a été déterminé apparaissent comme Inconnu ; il n’y a pas de catégorie « Autre », et les lignes au-delà de la limite ne sont tout simplement pas renvoyées.

Il n’y a aucune suppression liée à un échantillon minimal pour ces lignes : un pays comptant un lecteur est affiché comme un pays comptant un lecteur. La réponse est marquée comme une estimation, car un visiteur correspond à une adresse IP hachée.

La liste des pays et la carte des lecteurs (traductions)#

Les 30 premiers pays, classés selon le nombre de lecteurs distincts, avec pour chacun le nombre de visiteurs et le nombre de pages vues. À côté de chacun figure la part des lecteurs de ce pays qui ont consulté une page traduite, plafonnée afin de ne jamais dépasser 100 % — un lecteur qui a consulté deux langues est compté une fois par langue dans les chiffres bruts et ne doit donc pas apparaître comme ayant été servi à 150 %.

Une précaution lors de la comparaison des écrans. Le pourcentage affiché dans cette liste représente une part du sous-total des 30 premiers pays, tandis que les parts affichées sur les cartes de ventilation Analytics correspondent à l’ensemble de la période. Deux nombres corrects concernant le même pays peuvent donc différer pour cette seule raison.

Chaque pays est représenté par un marqueur sur la carte — son drapeau dans un anneau, dont la taille dépend du nombre de lecteurs qu’il a envoyés — et l’anneau indique la comparaison :

Anneau Règle Interprétation
Vert Votre documentation est déjà rédigée dans la langue de cette région, ou au moins 75 % de ses lecteurs ont consulté la traduction Servi
Ambre Entre 25 % et 75 % ont consulté la traduction La traduction existe et la plupart d’entre eux lisent encore l’original — un problème de découvrabilité, pas une traduction manquante
Rouge Moins de 25 % Les lecteurs arrivent et pratiquement aucun d’entre eux n’accède à une page traduite
Gris Docsbook ne propose aucune langue pour cette région, ou la part n’a pas pu être mesurée pour la période Rien à activer, ou rien de mesuré — jamais « rien ici »

Votre propre langue n’est jamais signalée comme une traduction manquante, et une période non mesurée apparaît en gris plutôt qu’en rouge ; une lacune de mesure ne peut donc jamais ressembler à une lacune de couverture.

La carte des visiteurs avec zoom#

Trois niveaux, choisis par le zoom : les pays, puis les régions, puis les lecteurs individuels. L’emplacement d’un marqueur dépend de ce que l’événement contenait réellement :

  • Une ligne qui nomme une région ou une ville et possède une coordonnée est dessinée à cette coordonnée.
  • Tout le reste est dessiné au centroïde de son pays, à partir d’une table statique de 125 codes de pays, et est indiqué comme approximatif.
  • Une ligne couvrant tout un pays se voit refuser le placement exact même lorsqu’elle possède une coordonnée, car la coordonnée moyenne d’un pays entier est un point situé en son milieu — pour les États-Unis, un champ au Kansas.
  • Un pays que la table ne connaît pas est comptabilisé, mais pas dessiné, et la carte indique combien de lecteurs s’y trouvent plutôt que de les supprimer silencieusement. Un code inconnu n’est jamais résolu en 0, 0 : « nous ne savons pas où cela se trouve » et « ils sont dans l’océan » doivent être deux réponses différentes.

Pourquoi c’est la bonne manière#

Règle Pourquoi cela fonctionne Source
Accorder sa confiance à la géolocalisation IP au niveau du pays, et pas en dessous MaxMind indique que ses produits « peuvent identifier les utilisateurs au niveau du pays avec une précision de 99,8 % », contre « environ 80 % de précision au niveau de l’État ou de la région » et « 66 % de précision pour les villes (dans un rayon de 50 km autour de cette ville) » pour les adresses américaines MaxMind : précision de la géolocalisation
Ne jamais présenter une IP localisée comme une personne localisée Lorsqu’un visiteur utilise « un proxy d’anonymisation comme un VPN », le fournisseur peut géolocaliser le serveur, mais « ne sera pas en mesure de géolocaliser l’utilisateur final » ; les VPN professionnels signifient que « l’utilisateur final peut se trouver n’importe où dans une région » MaxMind : précision de la géolocalisation
Ne pas déduire la langue d’un lecteur à partir de Accept-Language Le W3C précise explicitement que ce « n’est pas une bonne idée d’utiliser le seul en-tête HTTP Accept-Language pour déterminer la locale de l’utilisateur » : « De nombreux utilisateurs ne modifient jamais les paramètres par défaut … Ils sont définis lors de l’installation de l’agent utilisateur », et « Les gens empruntent des machines à leurs amis ou les louent dans des cybercafés » W3C : Accept-Language pour les paramètres de locale
S’attendre malgré tout à ce que l’en-tête soit absent ou générique La RFC 9110 indique qu’« un agent utilisateur NE DEVRAIT PAS générer de champ Accept-Language lorsque l’utilisateur n’a pas indiqué de préférence pour le contenu linguistique » et considère les préférences linguistiques comme une surface de fingerprinting RFC 9110 §12.5.4
Représenter une localisation approximative comme approximative La coordonnée moyenne d’un pays est un nombre réel qui ne décrit personne ; l’étiqueter comme un centroïde fait la différence entre une carte et une carte qui invente des villes Mécanisme, cette page

Limites et questions ouvertes#

  • L’indicateur de langue correspond à l’offre, pas à la demande. Il répond à la question « sur quelle traduction les lecteurs ont-ils finalement atterri », et ne peut pas répondre à « quelle traduction les lecteurs souhaitent-ils ». Toute interface produit qui décrit cette liste comme une préférence du navigateur décrit quelque chose que Docsbook ne collecte pas.
  • Un pays est un réseau, pas une personne. Un VPN d’entreprise place tous les employés là où le tunnel se termine ; un réseau mobile peut se trouver à une centaine de kilomètres ; une adresse IP hachée regroupe en un seul lecteur tous les utilisateurs derrière un même NAT. Considérez les lignes par pays comme un classement, jamais comme un décompte de personnes.
  • La géographie infranationale est peu précise. La plupart des pages vues enregistrées ne comportent aucune coordonnée, de sorte que la carte des visiteurs se compose principalement de centroïdes de pays, avec une minorité de localisations précises. Cela est indiqué sur la carte plutôt que masqué par un lissage.
  • Aucun échantillon minimal n’est imposé pour ces lignes. Un pays comptant trois lecteurs est affiché à côté d’un pays en comptant trois mille, et le pourcentage à côté du petit échantillon varie de plusieurs points entiers par lecteur.
  • L’échelle de couleurs nécessite qu’au moins une langue de traduction soit activée pour fournir des informations utiles. Si aucune langue n’est activée, tous les pays sont gris, à juste titre.
  • Trente jours constituent l’intégralité de l’historique. Ces données ne permettent aucune analyse saisonnière ou d’une année sur l’autre d’un marché.
  • Question en suspens : « marché non desservi » est une hypothèse, pas un constat. Ce qui est vérifiable, c’est que des lecteurs du pays X sont arrivés et n’ont pas atterri sur une page traduite. Ce qui n’est pas vérifiable, c’est pourquoi : aucune traduction n’existait, une traduction existait mais était introuvable, ou ces lecteurs lisaient l’anglais par préférence. L’échelle de couleurs distingue les deux premiers cas selon que la langue est activée ou non ; elle ne peut pas distinguer le troisième des deux autres. Considérez un pays rouge comme une question à tester avec une traduction, et non comme une perte mesurée.

Comment les ouvrir#

  • Onglets Pays et langues — Float Widget → Analyses → la Audience card, puis sélectionnez l’onglet.
  • Liste des pays et carte des lecteurs — Float Widget → Traductions. Survolez un marqueur pour voir les lecteurs de ce pays, la part d’une traduction et la langue principale dans laquelle ils lisent ; le survol d’une ligne de la liste met en évidence le même pays sur la carte. Faites glisser pour déplacer la carte ; les commandes dans le coin permettent de zoomer et de réinitialiser l’affichage sur les pays où vous avez effectivement des lecteurs.
  • Une langue à la fois — ouvrez Traductions et sélectionnez une langue dans la barre latérale pour voir quelle proportion de son audience elle atteint et ce qu’elle a coûté.

Updated

Cette page vous a-t-elle été utile ?

Propulsé par Docsbook