Docsbook
Übersicht

Analytics-Übersicht

Ein Dashboard für Dokumentation lässt sich leicht beeindruckend gestalten, aber nur schwer benutzbar machen. Der Unterschied liegt darin, ob jede Zahl angibt, was sie nicht erfassen kann. Auf dieser Seite wird das Panel Kachel für Kachel und Tab für Tab durchgegangen; für jedes wird erläutert, was es zählt, woher die Daten stammen und welche Schlussfolgerung es nicht zulässt. Die zugrunde liegenden Definitionen — wer als Besucher zählt, wie Bots und das eigene Team ausgeschlossen werden und wie lange Daten aufbewahrt werden — finden sich unter Wie die Messung funktioniert und werden hier nicht wiederholt.

Was Sie erhalten#

Eine Seite, die die Fragen beantwortet, die ein Besitzer tatsächlich hat, und zwar aus einer einzigen Quelle. Sechs der sieben Übersichtskacheln sind Eigenschaften eines Besuchs, und alle sechs werden aus demselben rekonstruierten Ereignisstrom abgeleitet, statt aus sechs unabhängigen Zählern — die Absprungrate hier und die Absprungrate in der Ergebnisaufteilung sind also dieselbe Berechnung und nicht zwei Zahlen mit derselben Bezeichnung. Das Lesen all dieser Informationen belastet das Guthaben Ihres Projekts nicht, und keine davon ist durch den Tarif eingeschränkt.

Wie es aufgebaut ist#

Die sieben Kacheln#

Kachel Definition Als Diagramm darstellbar
Besucher Eindeutige Besucher mit mindestens einem menschlichen Besuch im Zeitraum, aufgeteilt in neue / wiederkehrende Besucher ja
Umsatz Conversions × dein durchschnittlicher Produktpreis nein
Ausgaben Was das Guthaben dieses Projekts verlassen hat — KI-Aufrufe plus MCP-Aufrufe ja
Conversion-Rate Conversions ÷ Besucher ja
Umsatz/Besucher Umsatz ÷ Besucher ja
Absprungrate Als Absprung klassifizierte Besuche ÷ Besuche ja
Sitzungsdauer Durchschnittliche Besuchsdauer ja

Umsatz ist eine Kachel, aber niemals ein Diagramm. Er entspricht den Conversions multipliziert mit einer Konstanten, daher wäre seine Linie die Conversion-Linie mit einer anderen Achsenbeschriftung: eine Tatsache, die zweimal dargestellt wird. Sein zeitlicher Verlauf lässt sich an der Conversion-Rate ablesen.

Eine Conversion ist ein Klick aus deiner Dokumentation zum Host deiner Call-To-Action-URL. Gematcht wird nach Host, wobei www. einbezogen wird und andere Subdomains bewusst nicht einbezogen werden — deine Dokumentation liegt normalerweise auf einer Subdomain, und das Einbeziehen würde „zur Dokumentation zurückgekehrt“ als Verkauf zählen. Ein Besucher, der fünfmal klickt, zählt als eine Conversion.

Beide Geldkacheln bleiben deaktiviert, bis zwei Einstellungen vorhanden sind: Die Call-To-Action-URL legt fest, welcher Klick eine Conversion ist, und der durchschnittliche Produktpreis bestimmt, was sie wert ist. Solange nicht beide festgelegt sind, zeigen sie einen Gedankenstrich und nennen die fehlende Einstellung — niemals $0. Ein fehlender Preis ist kein Preis von null, und der Umsatz ist die Zahl, auf deren Grundlage ein Inhaber handelt, ohne zu prüfen, wie sie zustande gekommen ist. Beide befinden sich im Branding. Ein gespeicherter Preis von 0 wird vom Validator aus demselben Grund abgelehnt.

Ausgaben sind in jeder Hinsicht die Ausnahme. Sie stellen Geld dar, das abfließt, und keine Eigenschaft eines Besuchs. Sie stammen aus dem Abrechnungsbuch und nicht aus dem Ereignisstream, und sie sind die einzige Zahl hier, deren 0 ein tatsächlicher Messwert ist. Wissenswerte Folgen:

  • Sie werden nicht saldiert. Eine Aufladung lässt sie nicht sinken; Ausgaben beantworten die Frage „Was hat dieses Projekt mich gekostet?“, und diese Frage kennt nur eine Richtung.
  • Sie ignorieren deine Filter. Ein Filter schränkt Besuche ein, und ein Übersetzungslauf ist kein Besuch — „Vereinigte Staaten“ hat nichts über einen Embedding-Job auszusagen.
  • Sie bleiben bei einem leeren Zeitraum erhalten. Ein Übersetzungslauf um 3 Uhr morgens ist eine echte Rechnung ohne Leser dahinter, und das ist oft das Nützlichste, was diese Kachel anzeigen kann. Jede andere Kachel zeigt über einem solchen Zeitraum „keine Besuche zu messen“ an.
  • Ihr Pfeil hat keine Farbe. Steigende Ausgaben, weil Leser mehr anfordern, bedeuten, dass das Produkt funktioniert; steigende Ausgaben, weil ein Job feststeckt, bedeuten einen Notfall. Jede andere Abweichung ist bei guten Nachrichten grün — eine sinkende Absprungrate ist grün —, und diese bleibt grau, weil das Panel keine Hinweise darauf hat, welcher Fall vorliegt.
  • Ein nicht lesbares Abrechnungsbuch deaktiviert die Kachel und sagt dies auch, statt $0 anzuzeigen. Was gezählt wird, steht unter KI-Nutzung und Kosten.

Jede Kachel zeigt außerdem die Veränderung gegenüber dem unmittelbar vorhergehenden Zeitraum gleicher Länge. Wachstum ausgehend von einem vorherigen Wert von null zeichnet überhaupt keinen Pfeil: Es ist undefiniert, nicht +100%.

Die vier Aufschlüsselungskarten#

Jede Karte ist ein scrollbarer Streifen aus Tabs; zehn der Tabs sind gerankte Dimensionen, die aus demselben Besuchsstrom wie die Kacheln stammen, und vier kommen aus einer anderen Quelle.

Karte Tabs Ein Wert pro Besuch?
Seiten Seiten, Überschriften, Einstieg, Ausstieg Einstieg und Ausstieg ja; Seiten und Überschriften nein
Quellen Verweisquellen, Kanäle, UTM, Suchbegriff Verweisquellen und Kanäle ja
Zielgruppe Geräte, Browser, Länder, Sprachen ja
Conversions CTA-Klicks, Feedback, Suchen pro Ereignis gezählt

Dimensionen mit einem Wert teilen das Zeitfenster auf — ihre Besucherzahlen ergeben zusammen die Gesamtsumme. Seiten und Überschriften tun das nicht: Die Conversion eines Besuchs wird jeder Seite gutgeschrieben, die er aufgerufen hat, daher handelt es sich bei diesen Zeilen um unterstützte Gutschriften, die absichtlich mehr als die Hauptzahl ergeben. Die Karte weist auf dem Bildschirm darauf hin.

Jede Zeile auf einem gerankten Tab enthält beide Werte — wie viele Besucher sie gebracht hat und welchen Wert diese hatten — mit zwei dahinterliegenden Balken: einer für das, wonach die Liste gerankt ist, und einer immer für den Umsatz. Die Zeilen werden serverseitig nach Besuchern geordnet und im Browser neu sortiert, denn ein Server, der „die obersten Zeilen nach Umsatz“ zurückgibt, würde je nach Umschalter ein anderes Set zurückgeben, und beim Umschalten würden Zeilen erscheinen und verschwinden.

Seiten und Überschriften bieten zwei zusätzliche Ranglisten, Views und Reading time. Sie haben für eine Zeile, die einen Ort in Ihrer Dokumentation bezeichnet, eine Bedeutung und für eine Zeile, die ein Land bezeichnet, keine. Daher werden sie dort und nirgendwo sonst angeboten. Eine Seite ohne Messwerte zur Lesezeit zeigt einen Gedankenstrich, niemals 0.

Filtern#

Das Filtern nach einer Zeile schränkt alles ein – die anderen Karten und die Kacheln über dem Diagramm –, sodass ein Land, ein Gerät oder ein Referrer durchgängig verfolgt werden kann. Filter werden kombiniert und durch Klicken auf ihren Chip entfernt. Karten und Kacheln wenden dasselbe Prädikat auf dieselben rekonstruierten Besuche an. Dadurch wird verhindert, dass „Vereinigte Staaten“ in einer Karte etwas anderes bedeutet als im Diagramm darüber.

Tabs, die pro Ereignis statt pro Besuch gezählt werden – Überschriften, UTM, KI-Aufrufe, CTA- Klicks, Feedback und Suchanfragen –, können auf diese Weise nicht eingeschränkt werden. Während ein Filter aktiv ist, wird dies oberhalb ihrer Zeilen angezeigt, anstatt ungefilterte Zahlen unter einer gefilterten Überschrift zu zeigen.

Die vier Tabs, die nicht von Ihren Besuchern stammen#

  • Schlüsselwort stammt aus der Google Search Console. Eine Impression, die nie zu einem Klick wurde, ist für alles, was auf Ihrer Website läuft, unsichtbar – daher stammen diese Daten von Google: Suchanfragen, Position, Impressionen, Klicks und CTR. Verbinden Sie zuerst die Search Console. Die Umsatzspalte ist ausdrücklich eine Schätzung – Klicks × Ihr websiteweiter Umsatz pro Besucher – und entsprechend gekennzeichnet und dargestellt, weil eine modellierte Zahl neben gemessenen Werten nicht wie ein solcher aussehen darf.
  • CTA-Klicks listet jedes Ziel auf, zu dem Leser Ihre Dokumentation verlassen haben, und von welcher Seite aus.
  • Feedback listet Seiten nach den erhaltenen Daumenbewertungen auf, negative zuerst: Die Seite, die von den Lesern abgewertet wurde, ist diejenige, die überarbeitet werden sollte. Beide Bewertungs-Widgets werden zusammengezählt – die Bewertung am Seitenende und die Daumen bei einer dort gegebenen KI-Antwort –, denn entscheidend ist, welche Seite die Leser gutheißen, nicht welchen Button sie gedrückt haben. Nullen werden immer angezeigt.
  • Suchanfragen listet auf, was Leser in Ihr seiteninternes Suchfeld eingegeben haben, wie oft dabei etwas gefunden wurde und wie oft die Suche leer blieb – dieselben Wörter können in beide Zählungen eingehen. Eine Suchanfrage ohne Ergebnisse teilt Ihnen in den eigenen Worten des Lesers mit, welche Inhalte die Dokumentation abdecken sollte. Dafür gibt es kein Metrikmenü: Diese Zeilen gelten pro Suche, nicht pro Besuch, daher gibt es keinen Umsatz, nach dem sortiert werden könnte.

Kanäle und warum eine Kanalzeile nicht ausreicht#

Die Registerkarte „Kanäle“ gruppiert Besuche nach der Art der Quelle — organische Suche, bezahlte Suche, soziale Netzwerke, KI-Assistent, Verweis, direkt, intern — und klassifiziert sie, wenn das Ereignis geschrieben und nicht gelesen wird. Das ist aus zwei Gründen wichtig: KI-Verweise kommen mit einem leeren Referrer an, sodass sie bei einer Gruppierung allein nach Referrer unter „Direkt“ landen; und ein bezahlter Google-Klick und ein organisches Google-Ergebnis verwenden denselben Referrer, sodass ein bezahlter utm_medium Vorrang haben muss. Wenn Sie den Mauszeiger über einen Kanal bewegen, werden die drei Websites genannt, aus denen er tatsächlich besteht, samt ihren Anteilen — eine Zeile für die organische Suche, die fast vollständig aus Google besteht, und eine, die sich auf fünf Suchmaschinen verteilt, sind unterschiedliche Situationen.

KI-Ansichten#

Drei Tabs, jeweils einer für den Grund, aus dem ein Crawler gekommen ist, da sie völlig unterschiedliche Entscheidungen unterstützen:

Tab Was es ist Die Entscheidung, die es unterstützt
Antworten Ein Live-Abruf, der durchgeführt wurde, während jemandem eine Antwort gegeben wurde Ihre Seite wurde einer Person gegenüber zitiert. Einen Link und einen aktuellen Preis darauf ist sie wert
Indexierung Aufbau des Korpus, aus dem ein Assistent später abruft Die Voraussetzung dafür, jemals zitiert zu werden
Training Massensammlung zum Trainieren von Modellen Nur eine: ob es zugelassen werden soll

Innerhalb jedes Tabs können Sie nach Seiten (welche Seiten Assistenten lesen) oder nach Crawlern (eine Zeile pro Bot, mit Angabe seines Anbieters) gruppieren. Die Klassifizierung erfolgt anhand des User-Agents gegen eine Tabelle mit 23 benannten Bots, wobei der erste Treffer gewinnt — daher wird Applebot-Extended niemals von Applebot verschluckt — und ein nicht erkannter KI-Bot wird als Training behandelt, die Einstufung, die Ihnen am wenigsten verspricht.

Zeitbereiche#

Zeitraum Was er umfasst
Jetzt Eine fortlaufende Stunde, nach Minuten gruppiert und live aktualisiert
Heute Der bisherige aktuelle UTC-Kalendertag
Gestern Der vollständige vorherige UTC-Kalendertag
Letzte 24 Stunden Ein fortlaufender Tag rückwärts ab jetzt
Letzte 7 Tage Eine fortlaufende Woche
Letzte 30 Tage Ein fortlaufender Monat — das längste verfügbare Zeitfenster

Heute und Gestern sind Kalendertage in UTC, nicht in deiner lokalen Zeitzone, und keine fortlaufenden 24 Stunden: Zu Beginn des UTC-Tages umfasst Heute weniger als Letzte 24 Stunden. Nach dreißig Tagen enden die Daten.

Jetzt ist ein eigenes Zeitfenster und kein umbenannter Tag — eine Live-Ansicht ist nur mit einer Auflösung von einer Minute sinnvoll lesbar, und ein ganzer, nach Minuten gruppierter Tag umfasst 1.440 Punkte. Bei Jetzt werden die Kacheln und das Diagramm alle 5 Sekunden und die Karten alle 30 Sekunden aktualisiert; wechsle zu einem anderen Zeitraum, wird die Aktualisierung beendet, sodass ein historischer Zeitraum, den du nicht beobachtest, niemals unbemerkt im Hintergrund neu geladen wird.

Jetzt online — Leser, die in den letzten 5 Minuten aktiv waren — ist keine der sieben Kacheln. Es ist ein Echtzeitindikator und keine Summe über das von dir ausgewählte Zeitfenster und steht daher als eigener Chip neben dem Panel-Titel; würde er in der Leiste stehen, würde das dazu verleiten, ihn mit einem Zeitraum zu vergleichen, zu dem er nicht gehört.

Ein Bericht, für den Sie noch keine Daten haben#

Eine Registerkarte ohne eigene Zeilen wird über verblassten Beispielzahlen mit „Registerkarte aktivieren“ angezeigt. Wenn Sie darauf klicken, wird ein kurzer Leitfaden über dieselben Zahlen eingeblendet. Das gilt pro Registerkarte, nicht pro Karte – Entry benennt bei jedem Besuch eine Seite, während Pages jeder Seite, die bei einem Besuch aufgerufen wurde, einen Anteil zuweist, und jede Einschränkung zu der Registerkarte gehört, um die es geht. Der Schalter schränkt nichts ein: Jede Zahl wurde die ganze Zeit erfasst, und die Auswahl wird in Ihrem Browser pro Arbeitsbereich gespeichert.

Warum dies der richtige Weg ist#

Regel Warum es funktioniert Quelle
Messen, ob der Besuch erfolgreich war, nicht wie viele Seiten er berührt hat „Wenn Nutzer ihre Zielaufgabe nicht erledigen können, ist alles andere irrelevant. Der Erfolg der Nutzer ist der entscheidende Maßstab für die Gebrauchstauglichkeit“ — Nielsen & Budiu, 2001, überprüft 2021 NN/g: Erfolgsrate
Crawler nach ihrem Zweck klassifizieren, nicht in einen einzigen „Bots“-Topf werfen Die Anbieter selbst ziehen die Grenze: GPTBot darf „Inhalte crawlen, die für das Training verwendet werden könnten“, OAI-SearchBot existiert, „um Websites in Suchergebnissen anzuzeigen“, und „ChatGPT-User wird nicht zum automatischen Crawlen des Webs verwendet“ OpenAI-Bots
Ein User-Agent ist eine Behauptung, keine Identität Google veröffentlicht eine Anleitung zur Überprüfung von Crawlern, weil Betreiber „besorgt sind, dass Spammer oder andere Störenfriede auf ihre Website zugreifen und dabei behaupten, von Google zu stammen“ Google Search Central: Googlebot überprüfen
Die Zahlen der Search Console stammen von Google und sind vorläufig Google erklärt: „Die neuesten Daten können vorläufig sein, das heißt, sie werden noch erfasst und können sich in den nächsten Stunden ändern“, und definiert Impressionen als „Wie oft Ihre Website in den Suchergebnissen erschienen ist“ — eine Zahl, die kein Tracker auf der Website sehen kann Google: Leistungsbericht
Eine modellierte Zahl darf nicht wie eine gemessene aussehen Der Umsatz im Tab „Keyword“ entspricht Klicks × websiteweitem Umsatz pro Besucher; er ist aus genau diesem Grund mit (est.) gekennzeichnet und durch einen gestrichelten Balken dargestellt Mechanismus, diese Seite

Grenzen und offene Fragen#

  • Jede Besucherzahl ist eine Schätzung, und das Produkt weist darauf hin. Ein Besucher ist eine gehashte IP-Adresse: Ein Unternehmensnetzwerk wird zu einem einzigen Leser zusammengefasst, ein Pendler auf mehrere aufgeteilt. Betrachten Sie sie als Trend, niemals als Anzahl der Personen.
  • Prozentsätze bei wenigen Besuchen geben eine Richtung vor, sind aber keine Messung. Bei weniger als 30 Besuchen weist das Panel unter den Zahlen darauf hin, statt eine scheinbar genaue Rate anzugeben.
  • Ein sehr großes Zeitfenster wird anhand einer Stichprobe ausgewertet, und das wird offengelegt. Die Sitzungsrekonstruktion liest höchstens 50.000 Ereignisse; wird dieses Limit erreicht, setzt sie ein truncated-Flag, das die Karte in Worten nennt, da aus einem gekürzten Zeitfenster berechnete Raten falsch sind.
  • Deltas verschwinden, statt zu täuschen. Wenn das Lesen des vorherigen Zeitfensters fehlschlug, werden überhaupt keine Deltas angezeigt. Die Zeilen „Seiten“ und „Überschriften“ ordnen absichtlich zu viel zu — sie stellen eine unterstützte Zuordnung dar; addieren Sie sie nicht.
  • Absprungrate ist eine Beschreibung, kein Urteil. Eine Seite, weniger als drei Sekunden, nichts Weiteres — genauso sieht auch ein Leser aus, der seine Antwort auf einen Blick gefunden hat.
  • Offene Frage: „Sitzungszeit“ ist nicht gleich Aufmerksamkeit. Überprüfbar ist der Mechanismus — Segmente, eine Untergrenze von drei Sekunden, ein Limit von 300 Sekunden pro Segment, gemittelt über die Besuche. Nicht anhand von Webanalysedaten überprüfbar ist, ob eine Person auf den Bildschirm sah, und dieses Panel suggeriert das nicht. Siehe Lesezeit.
  • Dreißig Tage bilden die gesamte Historie. Kein Jahresvergleich, keine Saisonalität, keine Kohorte über einen Zeitraum von mehr als vier Wochen.

So öffnen Sie es#

Öffnen Sie eine beliebige Seite Ihrer Dokumentationswebsite und klicken Sie auf die Registerkarte Analytik in der schwebenden Werkzeugleiste am unteren Rand. Die Übersicht wird mit dem zuletzt ausgewählten Zeitraum geladen, den sie sich sitzungsübergreifend merkt.

Updated

War diese Seite hilfreich?