> 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/analytics/broken-links.md).

# リンク切れ

公開済みサイトで 404 を返すURLを見つけ、提案されたリダイレクトで修正できます

{% hint style="info" %}
Broken links はベータ版で、Ultimate サイトプランで利用できます。
{% endhint %}

Broken links は、訪問者がアクセスしているものの、もはや存在しない公開済みサイト上の URL を見つけ出します。各リンク切れ URL について、GitBook は訪問者が最も探していた可能性が高いページを特定し、1 回のクリックで有効化できるリダイレクトを提案するので、訪問者が 404 ページに着地し続けることがなくなります。

サイトのサイドバーで、 **［改善］→［リンク切れ］に移動します**.

## 仕組み

GitBook は、Broken links を含むプラン上の公開済みサイトを定期的に監査します。各監査では次の手順が実行されます。

1. サイトへの過去30日間のトラフィックを調べ、404を返したURLを収集します。対象となるには、URLへのアクセスが少なくとも3回必要です。また、 `/wp-admin` や `.php` ファイルへのリクエストなど、ボットやスキャナーによるノイズは無視されます。
2. 類似した URL をまとめ、既存のライブリダイレクトでカバーされているものや、そのパスにページが存在するため再び解決されるものを除外し、残りを訪問数順に並べます。最も訪問数の多い60件のリンク切れ URL が次へ進みます。
3. 公開済みのコンテンツを調べ、各訪問者が探していた可能性が最も高いページを特定します。セクション全体が移動している場合、GitBookは、 `/v1/*`のようなワイルドカード候補にリンク切れのURLをまとめます。該当するページがない場合はその旨を知らせ、30日後にそのURLを再確認します。
4. 明確に一致するリンク切れ URL ごとに、提案されたリダイレクトを作成し、そのページが選ばれた理由の短い説明と、URL が受けるトラフィック量に基づく重大度を付けます。

サイトの監査は 1 日に最大 1 回です。各監査は現在のトラフィックからやり直され、解決済みの URL は除外されるため、60 件を超えるリンク切れ URL があるサイトでも、監査を重ねることで訪問数の多いものから順に処理されます。GitBook がどのページにも一致させられなかったリンク切れ URL も、理由と検討したページを含めて検出項目として保持されるため、リダイレクトではなく新しいページが必要かどうかを判断できます。

Broken links は次の機能を基に構築されています [サイトのリダイレクト](https://gitbook.com/docs/documentation/ja-gitbook-documentation/publish/site-redirects.md)。リダイレクトに詳しくない場合は、まずお読みください。

## 2つのビュー

Broken links には 2 つのビューがあり、ヘッダーのタブから切り替えられます。

* **検出結果** には、GitBook が検出したリンク切れの URL と、確認できるように提案されたリダイレクトが一覧表示されます。
* **分析** には、サイトの分析データから得られたリンク切れ URL の全レポートが表示されます。リダイレクトがまだ提案されていない URL も含まれます。

## 検出項目の確認

「 **検出結果** 」ビューでは、過去 30 日間の概要が最初に表示されます。

| カード             | 表示内容              |
| --------------- | ----------------- |
| **リンク切れの訪問**    | サイトが返した 404 応答の数。 |
| **影響を受けた訪問者**   | 404 に到達した一意の訪問者数。 |
| **提案されたリダイレクト** | レビュー待ちの未処理提案の数。   |

リストには、各検出項目のステータス、重大度、そしてリンク切れ URL と、GitBook が見つけた場合は遷移先のページを説明するタイトルが表示されます。修正案のある検出項目が最初に一覧表示されます。

### 重大度

重大度は、サイト内の他のリンク切れ URL と比べて、そのリンク切れ URL が受けるトラフィック量を反映します。

重大度には3つのレベルがあります。

* **高**：過去30日間に少なくとも20回アクセスされ、サイト内でアクセス数が上位5位以内のリンク切れURL。
* **中**：安定したトラフィックがあるURL。
* **低**：過去30日間に数回しかアクセスされていないURL。

### 検索、フィルタリング、並べ替え

特定の検出結果を見つけるには、検索ボックスにURLまたはその一部を入力します。フィルターバーを使うと、検出結果を次の項目で絞り込めます。 **ステータス** または **重大度**。デフォルトでは、一覧には次の項目のみが表示されます **開く** 件の検出結果が重大度順に並んでいます。並べ替えを次の項目に切り替えます： **最近更新された項目** を選ぶと、最新の変更が先に表示されます。検出結果を開いてから戻っても、検索条件、フィルター、並べ替えは保持されます。

## リンク切れ URL を修正する

1. 一覧で検出項目を選択して、詳細を開きます。
2. 「 **動機** 」セクションを確認してください。GitBookが問題のあるURLに対応すると判断したページと、その理由が説明されています。「 **関連ページ** リストには、関連するページへのリンクが表示されます。
3. クリック **リダイレクトを作成**.
4. ダイアログは **リダイレクトを追加** が開き、次の項目が **ソースパス** と **宛先** に提案された値があらかじめ入力されています。必要に応じて変更してください。たとえば、 **恒久的なリダイレクト** 古いURLを今後使用しない場合は、これを選択します。
5. クリックして **リダイレクトを有効にする** すぐに有効にするか、 **下書きとして保存** して、サイトのリダイレクト設定から後で公開します。

未解決の検出結果とソースが一致するリダイレクトを有効にすると、その検出結果は自動的に **解決済み**としてマークされます。リダイレクトを下書きとして保存すると、リダイレクトが有効になるまで検出結果は未解決のままです。

リダイレクトはサイトのリダイレクト一覧に追加されます。いつでも **設定 → リダイレクト**から、または画面上部の **リダイレクトを管理** をクリックして編集または削除できます。

{% hint style="info" %}
リダイレクトの作成にはサイトでの管理者権限が必要で、検出項目のステータス変更には編集権限が必要です。使用できない操作は無効化され、説明が表示されます。
{% endhint %}

### ワイルドカード提案

複数の壊れたURLが同じプレフィックスを持ち、すべて同じ移動先セクションに属している場合、GitBookはURLごとにリダイレクトを設定する代わりに、 `/v1/*` のような単一のワイルドカードリダイレクトを提案します。事前入力されたリダイレクトダイアログでは、 **ワイルドカードを一致したテキストに置き換える** が有効になっているため、 `/v1/installation` は新しい移動先の一致するパスに転送されます。ワイルドカードリダイレクトの動作については、 [サイトのリダイレクト](https://gitbook.com/docs/documentation/ja-gitbook-documentation/publish/site-redirects.md) をご覧ください。

## 検出項目を無視する

提案が適切でない場合や、壊れたURLにリダイレクトが不要な場合は、検出結果を開いて **無視**をクリックします。検出結果は **却下済み** に移動し、デフォルトの一覧から消えます。 **ステータス**で絞り込むと再び表示でき、 **アーカイブ解除**.

ステータスメニューを使って、一覧または詳細ページから直接検出項目のステータスを変更することもできます。

| ステータス    | 意味                                  |
| -------- | ----------------------------------- |
| **未対応**  | 検出項目はレビュー待ちです。                      |
| **解決済み** | リダイレクトが作成されたか、URL が再び解決されるようになりました。 |
| **却下**   | 検出項目を無視するよう選択しました。                  |

次回の監査でリンク切れ URL が再び解決されると、検出項目は自動的に解決済みになります。これは、そのパスにページが再び存在するようになった場合（翻訳ページを含む）、またはライブリダイレクトでカバーされる場合です。

## リンク切れ URL の分析

で元に戻せます。 **分析** ビューには、選択した期間に404を返したすべてのURLが表示されます。GitBookがそのURLに対する提案を表示しているかどうかは問いません。これらには、入力ミスのあるURL、リダイレクトのない古いリンク、スパムリンクなどがあります。このビューを使って、リダイレクトではなく新しいページが必要な壊れたURLを見つけたり、壊れたURLへのトラフィック元を確認したりできます。

レポートには次のカードが含まれます。

* **壊れたURLへのアクセス数**, **影響を受けた訪問者数**、および **重複のないURL数** を選択した期間について表示し、時間の経過に伴う推移も確認できます。
* **アクセス数の多い壊れたURL**をアクセス数順に表示します。
* **ディメンション別の壊れたURL**では、壊れたURLへのトラフィックを次の項目でグループ化できます。 **参照元ドメイン**, **壊れたURL**, **参照元URL全体**, **国**または **デバイス**。参照元ドメインでグループ化すると、古いURLへのリンクを掲載している外部サイトをすばやく見つけ、実際に古くなったリンクとクローラーによるノイズを見分けられます。
* **適応型コンテンツが原因の404**は、サイトで適応型コンテンツを使用している場合に表示されます。これらは、ページ自体は存在するものの、条件によって閲覧できなかった訪問者です。リダイレクトしても解決しないため、検出結果から除外されます。

レポートには、ほかの [サイト分析](https://gitbook.com/docs/documentation/ja-gitbook-documentation/analytics/insights.md)と同じフィルター（セクション、言語、国、デバイス、参照元など）を適用できます。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/analytics/broken-links.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
