Länder und Sprachen
Zwei Fragen wirken wie eine, sind es aber nicht. „Wo sind meine Leser?“ wird durch eine IP-Abfrage beantwortet und ist auf Länderebene zuverlässig. „Welche Sprache wünschen sie?“ wird in diesem Produkt nirgendwo beantwortet, und diese Seite achtet darauf, dies klar zu sagen – gemessen wird stattdessen, auf welcher Übersetzung Ihrer Dokumentation Ihre Leser tatsächlich gelandet sind; das ist eine Angebotskennzahl, keine Nachfragekennzahl.
Der nützliche Bericht ist die Kombination aus beidem: Ein Land, das Ihnen Leser schickt und keinen davon auf eine übersetzte Seite bringt, ist ein Markt, den Sie bereits anziehen und an der Sprachbarriere verlieren.
Was Sie erhalten#
Drei Auswertungen an zwei Stellen:
| Auswertung | Wo | Was sie auflistet |
|---|---|---|
| Länder-Tab | Analysen → Zielgruppe | Ihre 15 Länder mit den meisten eindeutigen Lesern, jeweils mit Besuchern, Aufrufen und Umsatz sowie jeweils als Dashboard-Filter verwendbar |
| Sprachen-Tab | Analysen → Zielgruppe | Dieselben Besuche, aufgeschlüsselt nach der Übersetzung, die gelesen wurde |
| Länderliste + Leserkarte | Übersetzungsbereich | Ihre 30 Länder mit den meisten Lesern, jeweils zusammen mit dem Anteil der Leser dieses Landes, die auf einer übersetzten Seite gelandet sind, farblich danach gekennzeichnet, wie gut sie abgedeckt sind |
Das Lesen dieser Auswertungen wird nicht vom Guthaben Ihres Projekts abgezogen. Die Tabs „Länder“ und „Sprachen“ sind in jedem Tarif verfügbar; die Seite pro Sprache und die zoombare Besucherkarte sind kostenpflichtig.
Wie das Land bestimmt wird#
Am Edge anhand der IP, serverseitig. Das Netzwerk, das Ihre Dokumentation ausliefert, ermittelt aus der IP-Adresse der Anfrage einen Ländercode und fügt ihn dem Seitenaufruf hinzu, bevor dieser zusammen mit der ermittelten Region, Stadt und Koordinate gespeichert wird. Im Browser wird nichts abgefragt, und es wird niemals eine Standortberechtigung angefordert.
Wenn die Abfrage kein Ergebnis liefert, wird das Feld vollständig weggelassen, anstatt als leer geschrieben zu werden. Dieser Unterschied ist entscheidend: Ein ausdrücklich leeres Feld wird von der Abfrageschicht als vorhanden, aber leer interpretiert, wodurch „wir wissen es nicht“ nicht von einem tatsächlichen Wert unterschieden werden könnte. Ein Seitenaufruf ohne Land ist weiterhin ein Seitenaufruf und wird überall sonst weiterhin gezählt.
Koordinaten werden nach dem Prinzip alles oder nichts geschrieben — ein Breitengrad ohne Längengrad würde einen Leser im Golf von Guinea platzieren — und vor der Speicherung auf ihren gültigen Wertebereich geprüft.
Region, Stadt und Koordinate werden erfasst, aber von einer Oberfläche verwendet, der zoombaren Besucherkarte. Die Länderanzeigen verwenden den Ländercode und nichts Genauigeres.
Wie die Sprache bestimmt wird#
Aus dem Gebietsschema-Präfix der URL, auf der der Leser gelandet ist. Das ist die einzige Quelle. Docsbook unterstützt 15 Sprachcodes. Wenn das erste Segment des Pfads einem davon entspricht und es sich um eine von Ihnen aktivierte Sprache handelt, ist dies die Sprache des Besuchs. Gibt es kein Präfix, hat der Besuch keine Sprache und wird als Lesen Ihrer Originalsprache gezählt.
Was es nicht ist:
- Nicht
Accept-Language. Docsbook liest diesen Header nirgendwo aus. - Nicht
navigator.language. - Keine gespeicherte Leserpräferenz.
Docsbook leitet Leser außerdem weder nach Sprache weiter noch weist es ihnen eine Region zu. Ein Leser gelangt also zu einer Übersetzung, indem er sie auswählt – über die Sprachauswahl, einen Link oder ein Suchergebnis. Das macht die Kennzahl aussagekräftig, schränkt sie aber auch ein: Sie misst, welche Übersetzung gelesen wurde, nicht, welche gewünscht war. Ein Leser, der Deutsch bevorzugt hätte, die deutsche Version nie gefunden und die englische Version gelesen hat, wird als englischsprachiger Leser gezählt.
Die beiden Sprachanzeigen unterscheiden sich in einem wichtigen Punkt:
- Die Sprachenliste im Bereich Übersetzungen zeigt ausschließlich den Traffic der Übersetzungen – Ihre eigene Standardsprache wird ausgeschlossen, da die eigene Sprache einer Website keine Übersetzung ist.
- Der Tab Analytics → Audience → Languages umfasst alles und führt Besuche ohne Gebietsschema-Präfix unter Unbekannt auf.
Wie die Berichte erstellt werden#
Der Tab „Länder“ (Analytics → Zielgruppe)#
Ein Land pro Besuch – das erste nicht leere Land in den Ereignissen dieses Besuchs – wodurch die Dimension einen einzigen Wert hat, sodass sich die Besucherzahlen für den Zeitraum aufteilen und zur Gesamtsumme addieren. Besuche werden bei einer Inaktivitätslücke von 30 Minuten getrennt. Bots und das eigene Team werden ausgeschlossen, da sie auf dieser Seite überall vorkommen. Die Liste enthält die Top 15, serverseitig nach Besuchern sortiert, sodass beim Wechsel der Metrik die Liste neu sortiert wird, anstatt eine andere Liste abzurufen. Zeilen, für die kein Land ermittelt wurde, erscheinen als Unbekannt; es gibt keinen Bucket „Andere“, und Zeilen jenseits des Limits werden einfach nicht zurückgegeben.
Für diese Zeilen gibt es keine Unterdrückung aufgrund einer Mindeststichprobengröße: Ein Land mit einem Leser wird als Land mit einem Leser angezeigt. Die Antwort wird als Schätzung gekennzeichnet, da ein Besucher durch eine gehashte IP-Adresse identifiziert wird.
Die Länderliste und die Leserkarte (Übersetzungen)#
Die 30 führenden Länder, sortiert nach eindeutigen Lesern, jeweils mit ihrer Besucherzahl und der Anzahl ihrer Seitenaufrufe. Daneben wird der Anteil der Leser dieses Landes angezeigt, die auf einer übersetzten Seite gelandet sind. Dieser Anteil wird begrenzt, sodass er niemals 100 % überschreiten kann — ein Leser, der zwei Sprachen ausprobiert hat, wird in den Rohdaten einmal pro Sprache gezählt und darf daher nicht als mit 150 % versorgt erscheinen.
Ein Hinweis beim Vergleichen der Ansichten. Der in dieser Liste angezeigte Prozentsatz ist ein Anteil der Zwischensumme der 30 führenden Länder, während sich die Anteile auf den Analyse-Aufschlüsselungskarten auf das gesamte Zeitfenster beziehen. Zwei korrekte Zahlen für dasselbe Land können allein aus diesem Grund voneinander abweichen.
Jedes Land ist auf der Karte als Markierung dargestellt — seine Flagge befindet sich in einem Ring, dessen Größe davon abhängt, wie viele Leser es gesendet hat — und der Ring zeigt den Vergleich:
| Ring | Regel | Interpretation |
|---|---|---|
| Grün | Ihre Dokumentation ist bereits in der Sprache dieser Region verfasst, oder mindestens 75 % der Leser dieser Region haben die Übersetzung gelesen | Versorgt |
| Bernsteinfarben | Zwischen 25 % und 75 % haben die Übersetzung gelesen | Die Übersetzung ist vorhanden und die meisten von ihnen lesen weiterhin das Original — ein Auffindbarkeitsproblem, keine fehlende Übersetzung |
| Rot | Unter 25 % | Leser kommen an, und praktisch keiner von ihnen erreicht eine übersetzte Seite |
| Grau | Docsbook verfügt für diese Region über keine Sprache, oder der Anteil konnte für das Zeitfenster nicht gemessen werden | Nichts zu aktivieren oder nichts gemessen — niemals „nichts vorhanden“ |
Ihre eigene Sprache wird niemals als fehlende Übersetzung gemeldet, und ein nicht gemessenes Zeitfenster erscheint grau statt rot. So kann eine Messungslücke niemals wie eine Abdeckungslücke aussehen.
Die zoombare Besucherkarte#
Drei Ebenen, ausgewählt durch die Zoomstufe: Länder, dann Regionen, dann einzelne Leser. Wo ein Marker eingezeichnet wird, hängt davon ab, welche Daten das Ereignis tatsächlich enthielt:
- Eine Zeile, die eine Region oder eine Stadt benennt und Koordinaten enthält, wird an dieser Koordinate eingezeichnet.
- Alles andere wird am geografischen Mittelpunkt des Landes eingezeichnet, aus einer statischen Tabelle mit 125 Ländercodes, und als ungefähr gekennzeichnet.
- Bei einer landesweiten Zeile wird die exakte Platzierung selbst dann verweigert, wenn sie Koordinaten enthält, da die durchschnittliche Koordinate eines ganzen Landes ein Punkt in seiner Mitte ist – für die Vereinigten Staaten ein Feld in Kansas.
- Ein Land, das die Tabelle nicht kennt, wird gezählt, aber nicht eingezeichnet, und die Karte
gibt an, wie viele solcher Leser es gibt, anstatt sie stillschweigend fallen zu lassen. Ein
unbekannter Code wird nie zu
0, 0aufgelöst: „wir wissen nicht, wo das ist“ und „sie befinden sich im Meer“ müssen unterschiedliche Antworten sein.
Warum dies der richtige Weg ist#
| Regel | Warum es funktioniert | Quelle |
|---|---|---|
| Der IP-Geolokalisierung auf Länderebene vertrauen und nicht darunter | MaxMind erklärt, dass seine Produkte „Nutzer auf Länderebene mit einer Genauigkeit von 99,8 % identifizieren können“, gegenüber „etwa 80 % Genauigkeit auf Ebene von Bundesstaaten/Regionen“ und „66 % Genauigkeit für Städte (innerhalb eines Radius von 50 km um diese Stadt)“ bei US-Adressen | MaxMind: Genauigkeit der Geolokalisierung |
| Eine lokalisierte IP niemals als eine lokalisierte Person darstellen | Wenn ein Besucher „einen anonymisierenden Proxy wie ein VPN“ verwendet, kann der Anbieter den Server geolokalisieren, „wird jedoch nicht in der Lage sein, den Endnutzer zu geolokalisieren“; bei Unternehmens-VPNs bedeutet dies, dass „sich der Endnutzer irgendwo innerhalb einer Region befinden kann“ | MaxMind: Genauigkeit der Geolokalisierung |
Die Sprache eines Lesers nicht aus Accept-Language ableiten |
Das W3C stellt ausdrücklich fest, dass es „keine gute Idee ist, den HTTP-Header Accept-Language allein zu verwenden, um das Gebietsschema des Nutzers zu bestimmen“: „Viele Nutzer ändern die Standardeinstellungen nie … Sie werden festgelegt, wenn der User-Agent installiert wird“, und „Menschen leihen sich Geräte von Freunden, sie mieten sie in Internetcafés“ | W3C: Accept-Language für Gebietsschemaeinstellungen |
| Ohnehin damit rechnen, dass der Header fehlt oder generisch ist | RFC 9110 besagt: „Ein User-Agent SOLLTE kein Accept-Language-Feld erzeugen, wenn der Nutzer keine Präferenz für sprachliche Inhalte angegeben hat“, und betrachtet sprachliche Präferenzen als Oberfläche für Fingerprinting | RFC 9110 §12.5.4 |
| Eine ungefähre Position als ungefähr darstellen | Die durchschnittliche Koordinate eines Landes ist eine reelle Zahl, die niemanden beschreibt; sie als Schwerpunkt zu kennzeichnen, ist der Unterschied zwischen einer Karte und einer Karte, die Städte erfindet | Mechanismus, diese Seite |
Grenzen und offene Fragen#
- Die Sprachangabe beschreibt das Angebot, nicht die Nachfrage. Sie beantwortet die Frage „Bei welcher Übersetzung sind Leser letztendlich gelandet?“ und kann nicht beantworten, „Welche Übersetzung wünschen sich Leser?“. Jede Produktoberfläche, die diese Liste als Browsereinstellung beschreibt, stellt etwas dar, was Docsbook nicht erfasst.
- Ein Land ist ein Netzwerk, keine Person. Ein Unternehmens-VPN ordnet alle Mitarbeiter dort zu, wo der Tunnel endet; ein Mobilfunknetz kann hundert Kilometer entfernt sein; eine gehashte IP-Adresse fasst alle Personen hinter einem einzelnen NAT zu einem Leser zusammen. Betrachten Sie Länderzeilen als Rangfolge, niemals als Anzahl von Personen.
- Die Geografie innerhalb eines Landes ist lückenhaft. Die meisten gespeicherten Seitenaufrufe enthalten überhaupt keine Koordinaten, daher besteht die Besucherm Karte größtenteils aus Länderzentroiden mit einem kleineren Anteil präziser Positionen. Das wird auf der Karte angegeben, statt geglättet zu werden.
- Für diese Zeilen wird keine Mindeststichprobe erzwungen. Ein Land mit drei Lesern wird neben einem mit dreitausend angezeigt, und der Prozentsatz neben dem kleineren Land verändert sich pro Leser um ganze Prozentpunkte.
- Die Farbskala benötigt mindestens eine aktivierte Übersetzungssprache, um etwas Aussagekräftiges anzuzeigen. Wenn keine aktiviert ist, sind alle Länder korrekt grau.
- Die dreißig Tage umfassen die gesamte Historie. Aus diesen Daten lässt sich kein saisonaler oder jahresübergreifender Verlauf eines Marktes ablesen.
- Offene Frage: „Nicht bedienter Markt“ ist eine Hypothese, kein Ergebnis. Nachprüfbar ist, dass Leser aus Land X ankamen und nicht auf einer übersetzten Seite landeten. Nicht nachprüfbar ist der Grund dafür — es gab keine Übersetzung, eine Übersetzung war vorhanden, aber nicht auffindbar, oder diese Leser lasen bevorzugt auf Englisch. Die Farbskala unterscheidet die ersten beiden Fälle danach, ob die Sprache überhaupt aktiviert ist; den dritten Fall kann sie von keinem der beiden unterscheiden. Betrachten Sie ein rotes Land als Frage, die mit einer Übersetzung geprüft werden sollte, nicht als gemessenen Verlust.
So öffnen Sie sie#
- Tabs „Länder“ und „Sprachen“ — Float Widget → Analysen → die Publikum-Karte und dann den Tab auswählen.
- Länderliste und Lesermap — Float Widget → Übersetzungen. Bewegen Sie den Mauszeiger über einen Marker, um die Leser dieses Landes, den Anteil an einer Übersetzung und die meistgelesene Sprache anzuzeigen. Wenn Sie den Mauszeiger über eine Zeile in der Liste bewegen, wird dasselbe Land auf der Karte hervorgehoben. Ziehen Sie die Karte zum Verschieben; mit den Steuerelementen in der Ecke können Sie die Ansicht vergrößern und zurücksetzen, sodass nur die Länder angezeigt werden, aus denen Sie tatsächlich Leser haben.
- Eine Sprache nach der anderen — Öffnen Sie Übersetzungen und wählen Sie eine Sprache in der Seitenleiste aus, um zu sehen, wie viel ihres eigenen Publikums sie erreicht und was sie gekostet hat.
Verwandte Inhalte#
- Wie Messungen funktionieren — Besucheridentität, Bot-Filterung und warum jede Zählung hier eine Schätzung ist
- Analytics-Übersicht — die Karte „Zielgruppe“, in der sich diese Tabs befinden, und das Filtern des Dashboards nach einem Land
- Übersetzungseinstellungen — Aktivieren einer Sprache für eine Region, die in diesem Bericht rot markiert ist
- Wie KI-Übersetzungen funktionieren — was ein Übersetzungslauf bewirkt und was er kostet
- Erfasste Ereignisse —
docs.language_switch, das eine Ereignis, das festhält, dass ein Leser die Sprache bewusst geändert hat