# Google Search Console連携

## Google Search Console連携とは <a href="#overview" id="overview"></a>

Google Search Consoleと連携すると、Google検索でのパフォーマンスデータをWicleのダッシュボード上で直接確認できます。

連携により、以下のデータを閲覧できるようになります。

* **検索クエリ**: ユーザーがどのようなキーワードでサイトを見つけているか
* **表示回数**: Google検索結果にサイトが表示された回数
* **クリック数**: 検索結果からサイトがクリックされた回数
* **CTR（クリック率）**: 表示回数に対するクリック数の割合
* **平均掲載順位**: Google検索結果での平均的な表示位置

{% hint style="info" %}
連携後のデータの見方については [Google Search Console](/analytics/dashboard/search-console.md) をご覧ください。
{% endhint %}

## 連携の前提条件 <a href="#prerequisites" id="prerequisites"></a>

* Wicleの組織でOwner権限を持っていること
* 連携したいサイトのGoogle Search Consoleプロパティへのアクセス権があること

{% hint style="warning" %}
連携の設定・変更・解除はOwner権限を持つメンバーのみ実行できます。
{% endhint %}

## 連携の手順 <a href="#setup" id="setup"></a>

### ステップ1: 設定画面を開く <a href="#step1-open-settings" id="step1-open-settings"></a>

1. 左メニュー上部のプロジェクト名をクリックします
2. ポップアップメニュー内のプロジェクト名の右にある歯車マークをクリックします
3. 設定画面の`データ連携`をクリックします

### ステップ2: Googleアカウントで認証する <a href="#step2-authenticate" id="step2-authenticate"></a>

1. `Googleアカウントで連携`ボタンをクリックします
2. Googleのログイン画面が表示されるので、Search Consoleへのアクセス権があるGoogleアカウントを選択します
3. WicleがSearch Consoleのデータを読み取るためのアクセス許可を求められるので、許可します

認証が完了すると、設定画面に戻ります。画面上部に認証済みのGoogleアカウントのメールアドレスが表示されます。

### ステップ3: Search Consoleプロパティを選択する <a href="#step3-select-property" id="step3-select-property"></a>

1. `Search Consoleプロパティ`のドロップダウンから、連携するプロパティを選択します
2. `連携を開始`ボタンをクリックします

プロパティには以下の2種類があります。

| プロパティタイプ   | 説明                               |
| ---------- | -------------------------------- |
| ドメイン       | ドメイン全体（サブドメイン含む）のデータを取得します       |
| URLプレフィックス | 指定したURLプレフィックスに一致するページのデータを取得します |

{% hint style="info" %}
プロジェクトで計測しているサイトに対応するプロパティを選択してください。
{% endhint %}

連携が完了すると、Wicleのダッシュボードで検索パフォーマンスデータを確認できるようになります。

## 連携状態の確認 <a href="#check-status" id="check-status"></a>

設定画面の`データ連携`で、現在の連携状態を確認できます。連携済みの場合、以下の情報が表示されます。

* 連携しているGoogleアカウントのメールアドレス
* サイトURL
* プロパティタイプ（ドメイン / URLプレフィックス）

## 連携を解除する <a href="#disconnect" id="disconnect"></a>

1. 設定画面の`データ連携`を開きます
2. `連携解除`ボタンをクリックします
3. 確認ダイアログで解除を確定します

{% hint style="warning" %}
連携を解除すると、ダッシュボード上の検索パフォーマンスデータは表示されなくなります。再度連携することで、データの閲覧を再開できます。
{% endhint %}

## エラーが発生した場合 <a href="#error-handling" id="error-handling"></a>

連携中にエラーが発生した場合、設定画面にエラーメッセージが表示されます。

| エラー内容                        | 対処方法                                                  |
| ---------------------------- | ----------------------------------------------------- |
| 認証の有効期限が切れました                | `再認証`ボタンからGoogleアカウントで再度認証してください                      |
| Search Consoleへのアクセス権限がありません | Google Search Console側で対象プロパティへのアクセス権を確認し、`再認証`してください |
| 連携先のサイトが見つかりません              | Google Search Console側でプロパティが存在するか確認し、プロパティを再選択してください |
| APIリクエスト上限に達しました             | しばらく時間をおいてからアクセスしてください。この状態は自動的に解消されます                |

{% hint style="info" %}
上記で解決しない場合は、[問い合わせ窓口・対応時間](/other/support/contact.md) までお問い合わせください。
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.wicle.io/integration/search-console.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.