> 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連携とは <a href="#overview" id="overview"></a>

Google Adsと連携すると、広告の配信パフォーマンスデータをWicleのダッシュボード上で直接確認できます。

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

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

キャンペーン・キーワード・ランディングページごとのパフォーマンスも確認できます。すべてのキャンペーンタイプが対象です。

{% hint style="info" %}
連携後のデータの見方については [Google Ads](/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アカウントで認証`ボタンをクリックします
2. Googleのログイン画面が表示されるので、Google Adsへのアクセス権があるGoogleアカウントを選択します
3. WicleがGoogle Adsのデータを読み取るためのアクセス許可を求められるので、許可します

認証が完了すると設定画面に戻り、`Google認証済み`と表示されます。

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

1. `設定`ボタンをクリックします
2. `Google Adsアカウント`のドロップダウンから、連携するアカウントを選択します
3. `連携を開始`ボタンをクリックします

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

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

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

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

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

設定画面の`データ連携`で、現在の連携状態を確認できます。連携済みの場合、`設定`ボタンから以下の情報を確認できます。

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

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

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

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

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

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

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

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


---

# 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://docs.wicle.io/integration/google-ads.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.
