国と言語

一見すると一つに見える二つの質問は、実際には別のものです。「読者はどこにいるのか？」にはIPルックアップで答えられ、国レベルでは信頼性があります。「読者はどの言語を求めているのか？」については、この製品のどこにも答えがなく、このページでもその点を慎重に明示しています。実際に測定しているのは、ドキュメントの読者が最終的にどの翻訳版にたどり着いたかであり、需要の数値ではなく、供給の数値です。

有用なレポートはこの二つを組み合わせたものです。読者を送り込んでいるのに、そのうち誰も翻訳ページにたどり着いていない国は、すでに獲得しているものの、言語の壁で失っている市場です。

得られるもの#

2か所で、3つのデータを確認できます。

これらを確認しても、プロジェクトの残高は消費されません。国と言語のタブはすべてのプランで利用できますが、言語別ページとズーム可能な訪問者マップは有料です。

国がどのように判定されるか#

エッジで、IPアドレスからサーバー側で。 ドキュメントを配信するネットワークは、リクエスト元のIPアドレスを国コードに変換し、解決した地域、都市、座標とともに、保存する前のページビューに付加します。ブラウザに何かを要求することはなく、位置情報の許可を求めることもありません。

ルックアップで何も得られない場合、そのフィールドは空として書き込まれるのではなく、完全に省略されます。この違いは重要です。明示的に空のフィールドは、クエリーレイヤーでは存在するが空白であると解釈されるため、「不明」と実際の値を区別できなくなります。国がないページビューもページビューであり、その他のあらゆる場所では引き続きカウントされます。

座標は両方そろっている場合のみ書き込まれます。経度が欠けた緯度だけでは、読者をギニア湾に配置することになるためです。また、保存前に範囲チェックが行われます。

地域、都市、座標は取得されますが、使用されるのは1つの画面、ズーム可能な訪問者マップだけです。Countries の表示では国コードのみを使用し、それより詳細な情報は使用しません。

言語の判定方法#

読者がアクセスしたURLのロケールプレフィックスから判定されます。これだけが情報源です。 Docsbookは15個の言語コードに対応しています。パスの最初のセグメントがそのいずれかで、かつ有効にしている言語である場合、そのアクセスの言語になります。プレフィックスがない場合、そのアクセスには言語がなく、オリジナルを読んだものとしてカウントされます。

該当しないもの:

• Accept-Language ではありません。Docsbookはどこでもそのヘッダーを読み取りません。
• navigator.language ではありません。
• 保存された読者の設定ではありません。

Docsbookは言語に基づいて読者をリダイレクトしたり、地理情報に基づいて読者を振り分けたりすることもありません。そのため、読者は言語ピッカー、リンク、検索結果のいずれかから言語を選んで翻訳版にアクセスします。これにより、この数値は正確なものになりますが、同時に限界もあります。測定しているのはどの翻訳が読まれたかであり、どの翻訳が望まれていたかではありません。 ドイツ語を希望していたものの、ドイツ語版を見つけられず英語版を読んだ読者は、英語の読者としてカウントされます。

2つの「言語」表示には、知っておくべき違いが1つあります:

• 翻訳パネルの言語リストには、翻訳のトラフィックのみが表示されます。サイト独自の言語は翻訳ではないため、デフォルト言語は除外されます。
• 分析 → オーディエンス → 言語タブにはすべてが含まれ、ロケールプレフィックスのないアクセスは不明として分類されます。

レポートの作成方法#

国タブ（分析 → オーディエンス）#

1回の訪問につき1か国 — その訪問のイベントにおける最初の空でない国 — が割り当てられるため、このディメンションは単一値となり、訪問者数は期間全体を構成して合計値になります。訪問は30分間の非アクティブ時間が空くと区切られます。 ボットと自社チームは、そのページのあらゆる場所で除外されています。 一覧は上位15件で、サーバー側で訪問者数順に並べられているため、指標を切り替えると別の一覧を取得するのではなく、一覧の順序が変更されます。 国を特定できなかった行は不明として表示されます。「その他」バケットはなく、上限を超えた行は単純に返されません。

これらの行に最小サンプル数による抑制はありません。1人の読者しかいない国は、1人の読者がいる国として表示されます。 訪問者はハッシュ化されたIPアドレスであるため、レスポンスには推定値であることが示されます。

国別リストと読者マップ（翻訳）#

固有の読者数による上位30か国を、それぞれの訪問者数とページビュー数とともに表示します。各国について、その国の読者のうち翻訳ページに到達した割合も示します。この割合には100%を超えないよう上限が設定されています — 2つの言語を閲覧した読者は生の集計では言語ごとに1回ずつ数えられますが、そのために提供率が150%に見えてはなりません。

画面を比較する際の注意点。 このリストに表示される割合は上位30か国の小計に占める割合ですが、Analyticsの内訳カードに表示される割合は期間全体に占める割合です。同じ国についての2つの数値が、それだけの理由で異なる場合があります。

各国は地図上のマーカーです — その国の旗がリング内に表示され、リングのサイズはその国から訪れた読者数に応じて変わります — そしてリングには比較結果が示されます。

自分の言語が翻訳不足として報告されることはありません。また、測定されていない期間は赤ではなく灰色で表示されるため、測定の空白がカバレッジの空白に見えることはありません。

ズーム可能な訪問者マップ#

ズームに応じて選ばれる3つのレベル：国、地域、そして個々の読者です。 マーカーが描画される場所は、イベントに実際に含まれていた情報によって決まります：

• 地域または都市を示し、座標を持つ行は、その 座標に描画されます。
• それ以外はすべて、125か国のコードを収録した静的テーブルに基づく、その国の重心に描画され、 おおよその位置であると表示されます。
• 国全体を対象とする行は、座標を持っている場合でも正確な位置への配置を拒否されます。 国全体の平均座標はその国の中央にある一点にすぎず、米国の場合はカンザス州の野原になるためです。
• テーブルに存在しない国は集計されますが描画されません。また、マップにはそのような読者が何人いるかが表示され、 黙って除外されることはありません。不明なコードが0, 0に解決されることは決してありません。「場所がわからない」と 「海上にいる」は、異なる答えでなければなりません。

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

限界と未解決の問題#

• 言語の指標は需要ではなく、供給を示します。「読者が最終的にどの翻訳にたどり着いたか」には答えられますが、「読者がどの翻訳を望んでいるか」には答えられません。この一覧をブラウザーの設定として説明するプロダクト画面は、Docsbook が収集していない情報を示しています。
• 国は人ではなく、ネットワークです。企業 VPN では、トンネルの終端がある場所に全従業員がいるように見えます。モバイルネットワークでは実際の場所から数百キロメートル離れることがあります。また、ハッシュ化された IP は、1 つの NAT の背後にいる全員を 1 人の読者としてまとめます。国別の行は人数ではなく、順位として読んでください。
• 国より細かい地理情報は限定的です。保存されているページビューの大半には座標がまったく含まれていないため、訪問者マップの大部分は国の重心を示し、正確な位置を示すものは一部に限られます。この点は曖昧にせず、マップ上に明記されています。
• これらの行には最小サンプル数が設定されていません。読者が 3 人の国も 3,000 人の国の隣に表示され、小規模な国の横に表示される割合は、読者 1 人ごとに整数ポイント単位で変動します。
• 色の尺度が有用な情報を示すには、少なくとも 1 つの翻訳言語を有効にする必要があります。有効な言語がない場合、すべての国が正しく灰色で表示されます。
• 履歴は 30 日分のみです。このデータから、市場の季節変動や前年比の状況を読み取ることはできません。
• 検討中：「未対応市場」は仮説であり、調査結果ではありません。確認できるのは、国 X の読者が訪れ、翻訳ページにはたどり着かなかったという事実です。確認できないのはその理由です。翻訳が存在しなかったのか、存在したものの見つけられなかったのか、それともその読者が好みで英語を読んだのかは分かりません。色の尺度は、その言語が有効になっているかどうかによって最初の 2 つを区別しますが、3 つ目をどちらとも区別することはできません。赤色の国は測定された損失ではなく、1 つの翻訳を使って検証すべき問いとして扱ってください。

開き方#

• 「国と言語」タブ — フロートウィジェット → アナリティクス → オーディエンスカードの順に開き、 国と言語タブを選択します。
• 国の一覧と読者マップ — フロートウィジェット → 翻訳。マーカーにカーソルを合わせると、その国の読者数、 翻訳の閲覧シェア、その翻訳を読んでいる上位言語が表示されます。一覧の行にカーソルを合わせると、マップ上で同じ国が ハイライトされます。ドラッグして移動できます。隅のコントロールでズームや表示のリセットができ、実際に読者がいる国だけを 表示できます。
• 一度に1つの言語 — 翻訳を開き、サイドバーから言語を選択すると、その言語が自身の読者にどの程度届いているか、 またその費用を確認できます。

関連#

• 測定の仕組み — 訪問者の識別、ボットの除外、そしてここに表示されるすべての数値が推定値である理由
• アナリティクスの概要 — これらのタブが表示されるオーディエンスカードと、国によるダッシュボードのフィルタリング
• 翻訳設定 — このレポートで赤色に表示される地域の言語を有効にする方法
• AI翻訳の仕組み — 翻訳の実行内容とその費用
• 追跡イベント — docs.language_switch、読者が意図的に言語を変更したことを記録する唯一のイベント