> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/fen-xi/insights.md).

# サイト分析

公開ドキュメントのトラフィックと利用状況に関する分析を確認します

サイト分析では、公開したコンテンツとそのパフォーマンスに関する情報を確認できます。次のようなさまざまなセクションに分かれています— **トラフィック**, **ページとフィードバック**, **エージェントとLLM**, **検索**, **AIに質問**, **リンク**, **MCP**、および **OpenAPI**.

サイトの分析のトップレベルの概要は、サイトの **概要** 画面の **全般** をサイトサイドバーで開くと、地球儀アイコンに場所ごとの直近1時間の閲覧数が表示されます。

クリック **アナリティクス** をサイトヘッダーでクリックすると、サイトの分析を開けます。

{% hint style="info" %}
接続すると **Google Analytics**、サイトにクッキー通知を表示できます。削除するには、 [**サイト設定 → Analytics cookie**](/docs/documentation/ja-gitbook-documentation/saitowosuru/site-settings.md#analytics-cookie) を開いて、 **Google Analytics** 連携を無効化または削除してください。
{% endhint %}

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FN4B1Zr9tOH4zy0ynbjuf%2F26_03_30_analytics%402x.png?alt=media&amp;token=55fa9a58-ea02-4f52-930c-2458dab9a6fa" alt="A GitBook screenshot showing the site analytics dashboard"><figcaption><p>サイト分析ダッシュボード。</p></figcaption></figure>

### フィルターとグループ

フィルターを追加したり、データをグループ化したりして、特定の方法で表示できます。たとえば、特定のサイトセクション内の検索データを確認したり、トラフィックデータを国、デバイス、ブラウザーなどで絞り込んだりできます。

フィルターとグループを組み合わせることで、詳細な分析データまで掘り下げて、あなたにとって重要なイベントを追跡できます。

### カスタム期間で表示

時間フィルターを使用できます <picture><source srcset="/files/5jbxDjfORqRZ8w1Ej45a" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F1g9fFv9V674Y7JGjHOGw%2Fcalendar.svg?alt=media&amp;token=d21fbc59-ac2a-46ab-82cc-2085e7d295df" alt=""></picture> の右側にある **アナリティクス** 画面で、期間を過去24時間、7日、30日、または3か月に変更できます。

カスタム期間のデータを表示するには、 **カスタム範囲** をクリックして、カレンダーでカスタム期間を選択してください。

### データの種類

サイト分析は7つのセクションに分かれており、それぞれが特定のデータタイプに焦点を当てています。

#### トラフィック

GitBook はページビューを追跡し、コンテンツの人気度と到達範囲を把握できるようにします。ユーザーがドキュメントサイトのページを訪問するたびに、1件のページビューとしてカウントされます。

ページビューは、コンテンツ戦略の効果を評価し、ユーザーの関心に基づいてドキュメントを最適化するために重要です。国、言語、ブラウザーなど、さまざまなビューとプロファイルに分かれています。

{% hint style="success" %}
サイト分析全体で、イベントと訪問者の指標が表示されます。 **イベント** は、任意のカテゴリにおける発生総数を示します。一方、 **訪問者** は、そのアクションを実行した一意のユーザー数を示します。

ページビューの場合、イベントはページビューの総数、訪問者はページビューを実行した個別ユーザーの数を表します。
{% endhint %}

#### ページとフィードバック

ページとフィードバックでは、ユーザーがコンテンツをどのように評価しているかを大まかに把握できます。サイト内のすべてのセクションとバリアントの概要が表示され、 [ページ評価](/docs/documentation/ja-gitbook-documentation/saitowosuru/site-settings.md#page-ratings-pro-and-enterprise-plans) サイトの **カスタマイズ** メニューでページ評価を有効にすると、各ページの平均フィードバック評価を確認できます。

**フィードバックデータのフィルターとグループ化**

フィルターを使って、評価やコメントの一部に絞り込みます。グループを使うと、そのデータを任意の次元で比較できます。利用できる次元は、選択したレポートによって異なります。

ページとフィードバックのデータは、次の条件でフィルターまたはグループ化できます：

* コンテンツ: セクション、バリアント、ページ。
* 訪問者の属性: 国、言語、デバイス、ブラウザー、リファラー、認証済み訪問者ステータス。
* 顧客、プラン、ロール、機能アクセスなど、アダプティブコンテンツ用に設定された訪問者クレーム。

コンテンツフィルターは、フィードバックの出所を特定します。訪問者の属性は、サイト分析の他の場所で利用できるのと同じオーディエンスコンテキストを追加します。たとえば、ページの評価を国で絞り込んだり、フィードバックをデバイスや認証済み訪問者ステータスでグループ化したりできます。

**訪問者クレームでフィルター**

この **認証済み訪問者** フィルターは、フィードバックを残したときにGitBookが訪問者を特定できたかどうかを示します：

* **認証済み**：訪問者はサインインしていたか、署名付き訪問者クレームとともに訪問しました。
* **匿名**：訪問者は署名付き識別情報なしで訪問しました。URL パラメータや公開訪問者クッキーを介して渡されたクレームは署名されていません。
* **不明**：GitBook がこのイベントを記録したのは、2026年8月に訪問者認証の追跡が始まる前でした。

この **認証済み** と **匿名** の値は2026年8月以降に意味を持ちます。詳細は [認証済み訪問者FAQ](#what-does-authenticated-visitor-mean).

{% hint style="info" %}
顧客またはセグメントからのフィードバックを分離するには、アダプティブコンテンツを通じて渡すクレームでフィルターします。たとえば、顧客、プラン、ロール、機能アクセスのクレームで絞り込めます。これにより、そのクレーム値を含むイベントを持つ訪問者からのフィードバックのみが表示されます。

クレームフィルターは、サイトに設定されたクレームのみを使用します。ページ内容、セクション、バリアントから顧客IDを推測することはありません。 [アダプティブコンテンツの有効化](/docs/documentation/ja-gitbook-documentation/suru-1/adaptive-content/enabling-adaptive-content.md) を使って訪問者クレームを設定してください。
{% endhint %}

**分かること**

ページとフィードバックのフィルターを使うと、評価やコメントを具体的な改善に変えられます。たとえば、次のことができます：

* 評価の低いページやセクションを特定し、そのコメントを確認する。
* 認証済み訪問者と匿名訪問者のフィードバックを比較して、オーディエンス固有の不足点を見つける。
* 顧客クレームによって変化するページの評価を確認し、そのセグメント向けにコンテンツを改善する。

このデータをGitBookの外でさらに利用または分析したい場合は、 **CSVをダウンロード** をクリックして、 `.csv` ファイルをデバイスにダウンロードしてください。

ページを評価した訪問者が残したコメントの一覧も確認できるため、ドキュメントをどのように改善できるかについて実践的な示唆を得られます。

{% hint style="info" %}
**サイトのフィードバックデータが表示されないのはなぜですか？**\
ページ評価が有効な公開済みサイトのデータのみを表示します。サイトが公開されていない場合、またはページ評価が有効でない場合は、分析データは表示されません。
{% endhint %}

#### エージェントとLLM

LLM、コーディングエージェント、ボットからのトラフィックを追跡します。

このビューでは、次へのリクエストを表示します： `llms.txt`, `llms-full.txt`、Markdownページ。どのエージェントがコンテンツに最も頻繁にアクセスしているかも確認できます。

#### 壊れたURL

壊れたURLでは、外部ソースからの流入リンクのうち、「ページが見つかりません」エラーにつながっているものを表示します。入力ミスのURL、リダイレクトのない古いリンク、スパムリンクなどが考えられます。

壊れたリンクが、ドキュメント内の別の場所に存在するトピックを指している場合や、単にトラフィックを主要なドキュメントへ誘導したい場合は、 [サイトリダイレクト](/docs/documentation/ja-gitbook-documentation/suru-1/site-redirects.md) を設定して、訪問者を適切な場所に誘導できます。

#### 検索

ドキュメント内を検索するユーザーが最もよく使用するキーワードを確認することで、ドキュメントを測定し改善できます。このビューでは、どのキーワードの成果が最も高いか、またどれを改善できるかを確認できます。

ここで得られる情報は、コンテンツ設計の判断に役立ち、ドキュメントの特定部分を検索なしでも見つけやすくしたり、訪問者が検索している内容に基づいて既存ページに追加コンテンツを加えたりするのに役立ちます。

#### AIに質問

この [AIに質問](/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/searching-your-content/gitbook-ai.md) このセクションでは、GitBook AI を使用する際にユーザーが何を求めているかを確認できます。この洞察により、よくある質問を特定し、ドキュメントの不足を見つけ、ユーザーのニーズにより適切に応えるようコンテンツを改善できます。

AI が質問に対して返した回答を、ユーザーがどのように評価しているかも確認できます。これらのクエリと評価を確認することで、ドキュメント構造を改善し、見つけやすさを高め、より多くの文書化が必要な領域を特定できます。

#### リンク

GitBook はリンクを追跡し、ユーザーがドキュメント内の外部リソースとどのようにやり取りしているかを把握できるようにします。この機能では、外部リンク、そのドメイン、ヘッダー、フッター、サイドバーなどドキュメント内での配置に関する洞察が得られます。リンクの使用状況を分析することで、ナビゲーションを最適化し、コンテンツのアクセシビリティを向上させ、ユーザーエンゲージメントに基づいてドキュメント戦略を洗練できます。

#### OpenAPI

この [OpenAPI](/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/openapi.md) GitBook の分析ビューでは、ユーザーがAPIドキュメントとどのように関わっているかを把握できます。

エンドポイントの閲覧、パラメータ検索、リクエストの探索などの操作を追跡し、API のどの部分が最もアクセスされているか、またユーザーにより明確な説明が必要な箇所を把握するのに役立ちます。これらの洞察により、ドキュメントを改善し、開発者体験を向上させ、API コンテンツがユーザーのニーズを効果的に満たしていることを確認できます。

#### MCP

サイトコンテンツがどのようにアクセスされているかを、 [MCP](/docs/documentation/ja-gitbook-documentation/kenoai/mcp-servers-for-published-docs.md) 連携。MCP リクエストを時系列で確認し、どのボットやエージェントがサイトコンテンツにアクセスしているかを見ることができます。

### FAQ

<details>

<summary>サイト分析は誰が閲覧できますか？</summary>

サイトにアクセスできる人なら誰でも分析を閲覧できます。読者、レビュー担当者、編集者も含まれます。作成者と管理者は、サイトの設定とカスタマイズにもアクセスできます。

</details>

<details>

<summary>分析データが読み込まれないのはなぜですか？</summary>

分析ダッシュボードが読み込まれない場合、通常は広告ブロッカーやプライバシー拡張機能が分析スクリプトをブロックしているためです。拡張機能を一時的に無効にしてページを再読み込みするか、GitBook とそれが使用するサービスを拡張機能の許可リストに追加してください。

</details>

<details>

<summary>「ページが見つかりません」とはどういう意味ですか？</summary>

「ページが見つかりません」とは、訪問者がサイト上に存在しないページを開こうとしたことを意味します。表では、デフォルトの「ページが見つかりません」ページへの訪問のみをカウントします。どのURLが壊れているかを確認するには、 **壊れたURL** サイト分析を開いてください。そこで、各壊れたリンクに何人の訪問者がいたかを確認でき、 [リダイレクトを作成できます](/docs/documentation/ja-gitbook-documentation/suru-1/site-redirects.md) 必要に応じて。

</details>

<details>

<summary>リファラーデータの「未設定」とはどういう意味ですか？</summary>

「未設定」のリファラーはダイレクトトラフィックを示します。つまり、訪問者がURLを直接入力した、ブックマークを使った、またはリファラーデータを渡さないメールやアプリ内のリンクをクリックしたということです。

</details>

<details>

<summary>「認証済み訪問者」とはどういう意味ですか？</summary>

「認証済み訪問者」フィルターは、イベント発生時にGitBookが訪問者を特定できたかどうかを示します。

訪問者は、訪問者認証を通じてサインインした場合、またはアダプティブコンテンツを使用するサイトなどで署名付き訪問者クレームとともに訪れた場合に「認証済み」としてカウントされます。URL パラメータや公開訪問者クッキーを通じて渡されるパーソナライズ属性は署名されていないため、それらの訪問者は「匿名」としてカウントされます。

</details>

<details>

<summary>認証済み訪問者における「不明」とはどういう意味ですか？</summary>

「不明」とは、GitBook がそのイベントを記録したのが、2026年8月に訪問者認証の追跡が始まる前だったことを意味します。

GitBook では、古いイベントの状態を推測するのではなく、それらを「不明」とラベル付けします。そのため、以前の期間を含むレポートでは、トラフィックの大半が「不明」と表示されます。「認証済み」と「匿名」の区分は、2026年8月以降に意味を持ちます。

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/fen-xi/insights.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
