> For the complete documentation index, see [llms.txt](https://docs.wicle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wicle.io/integration/search-console.md).

# Google Search Console連携

Google Search Consoleと連携して、検索パフォーマンスデータをWicle上で確認できます

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

Google Search ConsoleのプロパティをWicleのプロジェクトに連携し、検索結果での表示やクリックをダッシュボードで確認します。Googleアカウントの認証後に、対象プロパティを選択して連携を開始します。

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

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

{% hint style="info" %}
連携後のデータの見方については[Google Search Consoleダッシュボード](https://docs.wicle.io/analytics/dashboard/search-console.md)をご覧ください。検索結果上での表示・クリックは、Wicleの計測タグによる来訪数とは別のデータです。
{% 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. 設定画面の`データ連携`を開き、`Google Search Console連携`で操作します。

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

1. `Google Search Console連携`の`Googleアカウントで認証`をクリックします。
2. Search Consoleへのアクセス権があるGoogleアカウントを選択します。
3. WicleがSearch Consoleのデータを読み取るためのアクセスを許可します。

設定画面に戻り、`Google認証済み`と`設定に進んでください`が表示されたら、次のプロパティ選択へ進みます。

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

1. `Google Search Console連携`の`設定`をクリックします。
2. 認証済みのGoogleアカウントを確認し、`Search Consoleプロパティ`から対象を選択します。
3. `連携を開始`をクリックします。

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

| プロパティタイプ   | 説明                                            |
| ---------- | --------------------------------------------- |
| ドメイン       | 対象ドメインとサブドメインを含み、http・httpsなどのプロトコルをまたいで集計します |
| URLプレフィックス | 指定したURLから始まるページが対象です。httpとhttpsも区別します         |

対象範囲の詳細は[Google公式のプロパティの説明](https://support.google.com/webmasters/answer/34592?hl=ja)をご覧ください。

1つのプロジェクトに連携できるのは1プロパティです。

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

`Search Console連携済み`と表示されたら設定完了です。ダッシュボードで対象期間を選んでデータを確認します。連携開始前の期間も、Search Consoleが提供する範囲内で取得できます。

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

設定画面の`データ連携`で、`Google Search Console連携`の表示を確認します。

| 表示                        | 状態と次の操作                          |
| ------------------------- | -------------------------------- |
| `Googleアカウントで認証`          | 未認証です。Googleアカウントで認証します          |
| `Google認証済み`・`設定に進んでください` | 認証済みです。`設定`からプロパティを選び、`連携を開始`します |
| `Search Console連携済み`      | 設定済みです。ダッシュボードでデータを確認できます        |
| `エラー`                     | エラーの詳細を確認し、後述の対処を行います            |

連携済みの場合は`設定`から、次の情報を確認できます。

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

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

1. 設定画面の`データ連携`を開きます。
2. `Google Search Console連携`の`設定`をクリックします。
3. `連携解除`を選択し、確認画面で確定します。

プロパティ選択前の認証済み状態を取り消す場合は、`設定`内の`認証を解除`を使います。別のGoogleアカウントやプロパティに変更する場合は、現在の連携を解除してから再度設定します。

{% hint style="warning" %}
解除するとWicleの認証情報と連携設定が削除され、ダッシュボードで検索パフォーマンスデータを確認できなくなります。Google Search Console側のプロパティやデータは削除されません。再度利用する場合は、Google認証とプロパティの選択から設定します。
{% endhint %}

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

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

| 症状・状況                        | 対処方法                                                           |
| ---------------------------- | -------------------------------------------------------------- |
| 認証の有効期限が切れました                | `再認証`ボタンからGoogleアカウントで再度認証してください                               |
| Search Consoleへのアクセス権限がありません | Google Search Console側で対象プロパティへのアクセス権を確認し、`再認証`してください          |
| 連携先のサイトが見つかりません              | Google Search Console側で対象プロパティの存在と権限を確認し、`再認証`後にプロパティを選択してください |
| プロパティの候補がありません               | 認証したアカウントを確認し、Google Search Console側で対象プロパティへのアクセス権を設定してください   |
| APIリクエスト上限に達しました             | しばらく時間をおいてから再度アクセスしてください。繰り返す場合はサポートへお問い合わせください                |

{% hint style="info" %}
上記で解決しない場合は、[サポート窓口](https://docs.wicle.io/other/support/contact.md)へお問い合わせください。
{% endhint %}
