目標とファネル

ページビューでは、ドキュメントが役に立ったかどうかは分かりません。目標とは、プロジェクトにおいて「うまくいった」とは何を意味するのかを定めることです。ファネルとは、そこに至るまでの経路を定めることです。以下の内容はすべて、誰かほかの人が選んだデフォルトではなく、これらの定義に照らして測定されます。

得られるもの#

成果（reached_pricing、copied_the_install_snippet、left_for_signup）を指定すると、Docsbookはその期間中に完了した訪問数を、背後にある日次系列とともにレポートします。また、1件あたりの価値を定義していれば、その価値も確認できます。複数をルートとしてつなぐと、単に最も小さいステップではなく、最も問題のある遷移を示すステップごとのファネルが得られます。

新しい目標はすでに記録されている履歴に対して遡及的に照合されるため、今日宣言した目標でも、ゼロから始めるのではなく、すぐに先週の数値がレポートされます。

4種類の目標#

event 目標は、オプションのスコープを指定して1つのページに絞り込むことができます。これにより、1つのイベントを2つの異なる目標として扱えます。「クイックスタートのスニペットをコピーした」と「認証スニペットをコピーした」は、異なるページ上の同じイベントです。

どのように構築されているか#

イベントごとではなく、訪問ごとにカウントされます。 section 目標は、読者がその見出しを通過するたびに発火します。イベントごとにカウントすると、1人のユーザーを5件のコンバージョンとして報告してしまいます。ファネルの潜在的価値ではさらに、ユーザーごとにカウントするため、同じ読者が経路を2回たどっても、2人分ではなく1人分として扱われます。

順序は、所属ではなくヒット時刻を比較することで保証されます。 各ステップについて、Docsbookは前のステップのヒット時刻以降に発生した最初のヒットを探します。最初にステップ3へ到達し、その後で初めてステップ1を見た読者は、ステップ3に到達したものとして正しくカウントされません。

コンバージョン期間によって、後続ステップが有効な期間が制限されます。 空欄にすると、訪問自体が期間となります。これはドキュメントサイトにとって適切なデフォルトです。設定すると、実際に存在する履歴の期間に制限されます。保持期間を超える長さの期間では、決して観測できないコンバージョンを表すことになります。

データが少ない場合、率は表示されません。 ファネル全体のコンバージョン率は30回の訪問未満では表示されません。また、直前のステップの訪問数が30未満の場合、各ステップには lowSample のフラグが付けられます。そのため、ステップ2に十分なデータがあれば率が表示される一方、データの少ないステップ5では表示されません。コンバージョンまでの時間の中央値とp90は、5件未満のコンバージョンでは表示されません。コンバージョンしたユーザーの一覧自体が答えとなり、パーセンタイルを示す意味がないためです。

leak_index は最小のステップではなく、最も問題のある遷移を示します。 最小のステップはほとんどの場合、最後のステップです。実際に経路が途切れている箇所は、隣接する2つのステップ間で比例して最も大きく減少している部分です。

有効にしない限り、金額は表示されません。 目標値 0 は明確に拒否されます。null と 0 は異なる主張であり、収益の数値に使用できるのはそのうち一方だけです。値が宣言されていない場合、金額列は $0 ではなく空欄になります。

バリデーターが拒否するものと、警告のみを表示するもの#

これらは、パネルで目標を作成する場合でも、 MCP経由の場合でも、アシスタント経由の場合でも同じように適用されます。つまりルールは1つで、一方では拒否されるものを別の方法で受け入れることはありません。

目標を削除すると、完全に破棄されるのではなくアーカイブされます。これは、消失した目標を参照するファネルステップまで一緒に失われてしまうためです。

これを基盤に構築されるレポート#

コンバージョンまでの時間は、平均値ではなく、中央値とp90で報告されます。 ドキュメントサイトでのコンバージョンまでの時間は二峰性を示します。訪問時点ですでに準備ができている読者と、数週間かけて評価する読者がいるためです。平均値はこの2つの分布の間にある空白の谷に落ち込み、実際には存在しない訪問者を表すことになります。

逆ファネルに仮説は必要ありません。 あらかじめ定義したファネルで測定できるのは、想定した経路だけです。一方、成功した訪問から逆方向に分析すれば、読者が実際に見つけた経路が明らかになります。それは、誰も設計していなかった経路であることも少なくありません。その経路が実在するなら、ナビゲーションで入口を目立たせることが次のアクションになります。

潜在価値は準備度の割合であり、予測ではありません。 読者がまだコンバージョンしていない場合でも、Docsbookはその読者をランク付けできます。コンバージョンした人がコンバージョン前にどのような状態だったか――閲覧時間、ページ数、そして特に、コンバージョンした人が他の全員より多く開くページ――のプロファイルを作成し、それぞれの読者をそのプロファイルと照合してスコアを付けます。コンバージョンした人の80%と他の全員の8%が開いたページには示唆がありますが、92%と90%が開いたページには何の示唆もありません。プロファイルは5人以上のコンバージョンがある場合にのみ作成され、識別力のある経路は最大12個まで含まれます。

これが正しい方法である理由#

限界と未解決の問い#

• 訪問者はハッシュ化されたIPです。 ここでのすべてのカウントはこの影響を受けます。企業のNATでは読者がまとめられ、モバイルネットワークでは分割されます。目標訪問者の5行を読んで、誰があなたを評価しているかを把握してください。合計を人数として読まないでください。計測の仕組みを参照してください。
• ジャーニーに表示されるソースはラストタッチです。 そしてDirectを過大に評価します。ヒントとして扱い、決してアトリビューションとはみなさないでください。
• リテンションコホートは30日間の履歴によって上限が設定されます。 W4が存在するには30日間のウィンドウが必要です。24時間または7日間の期間では構造上ゼロとなり、意味を持ちません。前年比ビューはなく、また存在し得ません。
• リテンションには、普遍的に良い方向性はありません。 高い再訪率はリファレンスドキュメントにとっては健全ですが、オンボーディングにとっては失敗です。その数値だけでは、どのセクションを説明しているのか判断できません。
• 潜在価値は推論によるものであり、適合させたものではありません。 その重みは観測されたベースレートに対して較正されていないため、読者同士を正直に順位付けしますが、パイプラインの数値に合計しては決してなりません。
• ファネルは、あなたが定義した経路を測定します。 読者が記述していない経路で成功した場合、ファネルは失敗と報告しますが、逆ファネルは真実を報告します。両方を読んでください。

関連#

• 測定の仕組み — 訪問の定義、ボットフィルター、そしてここに記載されているすべての数値が受け継ぐサンプルの下限
• アナリティクスの概要 — ヘッドラインストリップに表示されるコンバージョン率と収益
• 追跡イベントリファレンス — event ゴールが照合できるイベント名
• MCP ツールリファレンス — create_goal、create_funnel、get_funnel、get_retention など