Docsbook
Übersicht

Ziele und Trichter

Seitenaufrufe können Ihnen nicht sagen, ob die Dokumentation funktioniert hat. Ein Ziel bedeutet, dass Sie festlegen, was „funktioniert“ für Ihr Projekt bedeutet; ein Trichter bedeutet, dass Sie den Weg dorthin festlegen. Alles Folgende wird dann anhand dieser Festlegungen gemessen und nicht anhand eines Standardwerts, den jemand anderes gewählt hat.

Was Sie erhalten#

Benennen Sie ein Ergebnis — reached_pricing, copied_the_install_snippet, left_for_signup — und Docsbook meldet, wie viele Besuche es im Zeitraum abgeschlossen haben, einschließlich der zugrunde liegenden Tagesreihe und (falls Sie angegeben haben, wie viel eines wert ist) welchen Wert sie hatten. Fügen Sie mehrere zu einer Route zusammen, erhalten Sie einen schrittweisen Trichter, der den schlechtesten Übergang benennt, nicht nur den kleinsten Schritt.

Neue Ziele werden rückwirkend mit der bereits aufgezeichneten Historie abgeglichen, sodass ein heute definiertes Ziel sofort die Zahlen der letzten Woche meldet, anstatt bei null zu beginnen.

Die vier Arten von Zielen#

Art Entspricht Verwenden für
page Ein Seitenpfad „Sie haben die Preisseite erreicht“
event Einem der erfassten docs.*-Ereignisse „Sie haben einen Codeblock kopiert“, „sie haben den Assistenten gefragt“
section Einem Überschriftenanker, der in den sichtbaren Bereich gescrollt wurde, mit oder ohne # „Sie sind so weit auf der Seite nach unten gelangt wie bis zu den Installationsschritten“
outbound Einem Zielhost, zu dem sie weitergeleitet wurden „Sie sind zu Ihrer App, Ihrem Repository oder zur Registrierung gegangen“

Ein event-Ziel kann mit einem optionalen Bereich auf eine Seite eingegrenzt werden, wodurch ein einzelnes Ereignis zwei verschiedene Ziele sein kann – „den Quickstart-Schnipsel kopiert“ und „den Auth-Schnipsel kopiert“ sind dasselbe Ereignis auf verschiedenen Seiten.

Wie es aufgebaut ist#

Pro Besuch gezählt, nie pro Ereignis. Ein section-Ziel wird jedes Mal ausgelöst, wenn ein Leser über diese Überschrift hinaus scrollt; würde man Ereignisse zählen, würde eine Person als fünf Conversions gemeldet. Der potenzielle Wert des Funnels geht noch weiter und zählt pro Person, sodass ein Leser, der die Route zweimal durchlaufen hat, den Wert eines Lesers statt den von zwei beiträgt.

Die Reihenfolge wird durch den Vergleich der Trefferzeiten erzwungen, nicht durch die Zugehörigkeit. Für jeden Schritt sucht Docsbook nach dem ersten Treffer zum oder nach dem Treffer des vorherigen Schritts. Ein Leser, der zuerst bei Schritt 3 angekommen ist und erst später Schritt 1 gesehen hat, wird folgerichtig nicht als jemand gezählt, der Schritt 3 erreicht hat.

Das Conversion-Fenster begrenzt, wie lange ein späterer Schritt noch zählt. Lassen Sie es leer, ist der Besuch selbst das Fenster – die faire Standardeinstellung für eine Dokumentationsseite. Legen Sie es fest, wird es auf den tatsächlich vorhandenen Verlauf begrenzt – ein Fenster, das länger als die Aufbewahrungsdauer ist, beschreibt Conversions, die niemals beobachtet werden können.

Raten werden bei zu wenigen Daten unterdrückt. Die Gesamt-Conversion-Rate eines Funnels wird bei weniger als 30 Besuchen nicht angezeigt, und jeder Schritt wird mit lowSample gekennzeichnet, wenn der Schritt davor weniger als 30 hatte – daher wird für einen soliden Schritt 2 weiterhin eine Rate angegeben, während ein datenarmer Schritt 5 keine erhält. Die Zeit bis zur Conversion im Median und im p90-Perzentil wird bei weniger als 5 Conversions nicht angezeigt, da die Liste der Conversions die Antwort liefert und ein Perzentil dies nicht tut.

leak_index bezeichnet den schlechtesten Übergang, nicht den kleinsten Schritt. Der kleinste Schritt ist fast immer der letzte; beim größten proportionalen Rückgang zwischen zwei aufeinanderfolgenden Schritten bricht die Route tatsächlich ab.

Geld bleibt außen vor, solange Sie es nicht aktivieren. Ein Zielwert von 0 wird grundsätzlich abgelehnt – null und 0 sind unterschiedliche Aussagen, und nur eine davon gehört in eine Umsatzkennzahl. Wenn kein Wert angegeben ist, bleiben die Geldspalten leer, statt $0 zu enthalten.

Was der Validator ablehnt und worauf er nur hinweist#

Diese Regeln werden identisch durchgesetzt, egal ob Sie ein Ziel im Panel, über MCP oder über den Assistenten erstellen – eine Regel, sodass keine Oberfläche etwas akzeptiert, das eine andere ablehnt.

Regel Ebene Begründung
Ein event-Ziel, das ein Ereignis benennt, das diese Dokumentation nicht auslöst Abgelehnt Es könnte niemals ausgelöst werden, und ein Ziel, das nie ausgelöst wird, sieht genauso aus wie ein Ziel mit 100 % Abbruchrate
Ein Zielwert von 0 Abgelehnt $0 wird als Messwert statt als fehlende Deklaration interpretiert
Ein Trichter mit weniger als 2 Schritten Abgelehnt Bei einem Schritt gibt es keinen zu messenden Übergang – das ist ein Ziel
Ein Trichterschritt, der ein nicht vorhandenes Ziel benennt Abgelehnt Ein Trichter, der einen Schritt stillschweigend auslässt, meldet eine bessere Konversionsrate als die tatsächliche
Mehr als 8 Schritte Abgelehnt Teilen Sie ihn in zwei, damit jeder Teil einen aussagekräftigen Nenner hat
Mehr als 5 Schritte Warnung Selbst bei 60 % pro Schritt kommen weniger als 8 % am Ende an
Eine einzelne Seite als Schritt 1 Warnung Die meisten Leser der Dokumentation gelangen über die Suche oder eine KI-Antwort direkt zu einer tieferen Seite; ein enger Einstieg schließt den Großteil des Traffics aus, bevor überhaupt etwas gemessen wird
Ein Trichter, der mit einem Scroll- oder Abschnittsansichtsereignis endet Warnung Es misst Aufmerksamkeit, nicht das Ergebnis
Ein Zielname, der einen Pfad, eine ID, @ oder eine lange Zahl enthält Warnung Sowohl ein Kardinalitäts- als auch ein Datenschutzproblem – Zielnamen gelangen in Exporte und Chat-Antworten
Mehr als 6 aktive Ziele Warnung Ab sechs Einträgen hört die Liste auf zu ordnen und wird zu einem Protokoll

Beim Löschen eines Ziels wird dieses archiviert, anstatt zerstört zu werden, da ein Trichterschritt, der auf ein verschwundenes Ziel verweist, sonst ebenfalls mit ihm verschwinden würde.

Die darauf aufbauenden Berichte#

Bericht Welche Frage er beantwortet
Zielübersicht Abschlüsse pro Ziel im Zeitraum sowie die tägliche Entwicklung
Trichter Schrittweise Abschlüsse, der Anteil des vorherigen Schritts, der fortgesetzt wurde, die wichtigsten Quellen und Länder bei jedem Schritt sowie leak_index
Zielpfade Alle, die ein Ziel erreicht haben, und wie lange sie vom ersten Besuch bis zur Conversion gebraucht haben
Zielbesucher Aktuelle Leser und welche Ziele die einzelnen Leser erreicht haben
Besuchsergebnisse Die Aufteilung jedes Besuchs in Erfolg / Sackgasse / Absprung / Teilabschluss, ohne dass überhaupt ein Ziel festgelegt wurde
Umgekehrter Trichter Geht von erfolgreich beendeten Besuchen rückwärts aus: Welche Einstiegsseiten führen zum Erfolg und in wie vielen Schritten?
Bindung W1/W4-Rückkehrrate nach wöchentlicher Kohorte

Die Zeit bis zur Conversion wird als Median und p90 angegeben, niemals als Mittelwert. Die Zeit bis zur Conversion auf einer Dokumentationsseite ist bimodal — Leser, die bereits bereit sind, und Leser, die wochenlang evaluieren — und der Mittelwert liegt im leeren Tal zwischen den beiden Modi und beschreibt einen Besucher, den es nicht gibt.

Der umgekehrte Trichter benötigt keine Hypothese. Ein festgelegter Trichter kann nur den Weg messen, den man sich vorgestellt hat; die Rückwärtsanalyse erfolgreicher Besuche zeigt den Weg, den Leser tatsächlich gefunden haben, und dieser wurde oft von niemandem geplant. Wenn dieser Weg real ist, besteht die Maßnahme darin, seinen Einstiegspunkt in der Navigation hervorzuheben.

Der potenzielle Wert ist ein Bereitschaftsanteil, keine Prognose. Wenn ein Leser noch nicht konvertiert hat, kann Docsbook ihn dennoch einordnen: Es erstellt ein Profil dessen, wie Konvertierende vor ihrer Conversion aussahen — Lesezeit, Seiten und vor allem die Seiten, die Konvertierende häufiger als alle anderen öffnen — und bewertet jeden Leser anhand dieses Profils. Eine Seite, die von 80 % der Konvertierenden und 8 % aller anderen geöffnet wird, liefert eine Erkenntnis; eine Seite, die von 92 % und 90 % geöffnet wird, liefert keine. Das Profil wird erst ab 5 oder mehr Konvertierenden erstellt und umfasst höchstens 12 unterscheidende Pfade.

Warum dies der richtige Weg ist#

Regel Warum es funktioniert Quelle
Aufgabenabschluss messen, nicht Traffic „Wenn Nutzer ihre Zielaufgabe nicht erledigen können, ist alles andere irrelevant. Der Erfolg der Nutzer ist das A und O der Gebrauchstauglichkeit“ — Nielsen & Budiu, 2001, 2021 überprüft NN/g: Erfolgsquote
Raten bei kleinen Nennern unterdrücken Die Untergrenze für die Unterdrückung ist dieselbe Grenze von 30 Besuchen, die für jede Rate im Produkt verwendet wird; sie wird pro Schritt angewendet, da die späteren Schritte eines Trichters immer die geringsten Werte aufweisen Wie die Messung funktioniert
Schritte müssen geordnet sein, nicht nur vorhanden Ein ungeordneter Bericht darüber, „ob diese Seiten aufgerufen wurden“, kann eine Journey nicht von drei unabhängigen Einstiegen unterscheiden — aus demselben Grund gibt es eine Routenanalyse und keine Liste der meistbesuchten Seiten Mechanismus, diese Seite
Ergebnisse pro Besuch zählen, Wert pro Person Ein wiederholtes Scrollen ist die zweimal ausgedrückte Absicht eines Lesers; es als Umsatz zu summieren, lässt einen Trichter aus einer Seitenaktualisierung Geld erfinden Mechanismus, diese Seite

Grenzen und offene Fragen#

  • Ein Besucher ist eine gehashte IP-Adresse. Jede Zählung hier übernimmt diese Eigenschaft: Unternehmens-NAT fasst Leser zusammen, während Mobilfunknetze sie aufteilen. Lesen Sie fünf Zeilen mit Zielbesuchern, um zu erfahren, wer Sie evaluiert; betrachten Sie die Gesamtsumme nicht als Anzahl der Personen. Siehe So funktioniert die Messung.
  • Die auf einer Journey angezeigte Quelle ist der letzte Kontaktpunkt und schreibt Direkt zu viel zu. Betrachten Sie sie als Hinweis, niemals als Attribution.
  • Retentionskohorten sind durch einen Verlauf von 30 Tagen begrenzt. W4 benötigt ein 30-Tage-Fenster, um überhaupt zu existieren; bei einem Zeitraum von 24 Stunden oder 7 Tagen ist es strukturell null und bedeutungslos. Es gibt keine Vorjahresansicht, und eine solche kann es auch nicht geben.
  • Retention hat keine universell gute Richtung. Eine hohe Rückkehrquote ist für Referenzdokumentation gesund und beim Onboarding ein Misserfolg — die Zahl kann nicht wissen, welchen Abschnitt sie beschreibt.
  • Der potenzielle Wert wird hergeleitet, nicht angepasst. Seine Gewichtungen sind nicht an einer beobachteten Basisrate kalibriert, daher ordnet er Leser ehrlich im Verhältnis zueinander ein und darf niemals zu einer Pipeline-Kennzahl summiert werden.
  • Ein Funnel misst den von Ihnen festgelegten Weg. Wenn Leser über einen Pfad erfolgreich sind, den Sie nicht beschrieben haben, meldet der Funnel einen Misserfolg, während der umgekehrte Funnel die Wahrheit zeigt. Lesen Sie beide.

Updated

War diese Seite hilfreich?