> 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/google-ads.md).

# Google Ads連携

Google Adsと連携して、広告パフォーマンスデータをWicle上で確認できます

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

Google AdsアカウントをWicleのプロジェクトに連携し、広告の費用や成果をダッシュボードで確認します。Googleアカウントの認証後に、対象の広告アカウントを選択して連携を開始します。

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

* **費用**: 広告費用の合計
* **クリック数**: 広告がクリックされた回数
* **CV数（コンバージョン数）**: Google Ads側で計測されたコンバージョン数
* **CPA**: 1コンバージョンあたりの費用
* **CTR（クリック率）**: 表示回数に対するクリック数の割合
* **CPC（平均クリック単価）**: 1クリックあたりの平均費用

キャンペーン・キーワード・ランディングページなど、広告配信の内訳も確認できます。広告のCVと、Wicleで設定したコンバージョンは別の集計です。

{% hint style="info" %}
連携後のデータの見方については[Google Adsダッシュボード](https://docs.wicle.io/analytics/dashboard/google-ads.md)をご覧ください。
{% endhint %}

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

* Wicleの組織でOwner権限を持っていること
* 連携したいGoogle Adsアカウントへのアクセス権があること

{% 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連携`と`Google Ads連携`のセクションが並んで表示されます。`Google Ads連携`のセクションで操作します。

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

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

設定画面に戻り、`Google認証済み`と`設定に進んでください`が表示されたら、次のアカウント選択へ進みます。

### ステップ3: Google Adsアカウントを選択する <a href="#step3-select-account" id="step3-select-account"></a>

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

ドロップダウンには、認証したGoogleアカウントからアクセスできるGoogle Adsアカウントが`アカウント名（アカウントID）`の形式で表示されます。

1つのプロジェクトに連携できるのは1アカウントです。

{% hint style="info" %}
プロジェクトで計測しているサイトの広告配信に使用しているアカウントを選択してください。
{% endhint %}

`Google Ads連携済み`と表示されたら設定完了です。ダッシュボードで対象期間を選び、広告パフォーマンスデータを確認します。

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

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

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

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

* 連携しているGoogleアカウントのメールアドレス
* アカウント名
* アカウントID

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

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

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

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

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

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

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

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