Google広告のスクリプトテンプレートを使ってみた（アカウントの概要編）

# これは何？


2022年6月30日に新たに追加された[Google広告スクリプトのテンプレート](https://support.google.com/google-ads/answer/188712?hl=ja)を試してみた時のメモです。

> Google 広告スクリプトを使用すると、アカウントで JavaScript コードを入力することで Google 広告アカウント内のアクションを自動化できるようになります。スクリプトによってアカウント内のアイテムの作成、編集、削除を行い、時間を節約してより効率的にアカウントを管理できます。

> スクリプトを作成する最も簡単な方法は、スクリプトのライブラリに用意されているスクリプトを編集することです。スクリプトをそのまま使用することも、JavaScript を調整してカスタム スクリプトを作成することもできます。たとえば、既定のスクリプトを利用して、次のことが行えます。

Google広告スクリプトを使うと、API経由で広告を直接編集したり、配信レポートを出力することができます。従来のスクリプトの場合、多少の開発スキルが必要でしたが、今回のアップデートでマーケターでも活用できるようになりました。


# テンプレート：`アカウントの概要`を使ってみる

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/319121/19b216bc-3f6a-cc14-6a5d-c707e4ee9df8.png)


`アカウントの概要`とは、表示回数やクリック数、コンバージョン数などの、Google広告の主なパフォーマンスについてスプレッドシートにレポートを出力するテンプレートです。定期実行がされるたびにメールアドレスに通知が届きます。他にも、`アカウントの変動検出機能`など、かなろ有用そうな機能が盛りだくさん。


## 下準備

[このリンク](https://docs.google.com/spreadsheets/d/1gYLXtDK93lWoTe3OBKvTlfcc7L_qHJFgWU9N6HwhZtU/copy
)から、出力用のスプレッドシートをコピーします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/319121/78f43f5b-3e26-e9ca-7ca9-7d577ecd5584.png)

赤枠になっている箇所を編集していきます。`Last Check`の右のセルに、「チェックする最も古い日時」を入力します。`Email`の右のセルに、レポートを受信したいメールアドレスを入力します（メールが不要な場合はブランク）

:::note info
`Last Check`のセルに記載する日付は、読み込みにかなり時間がかかるため、過去90日分までが推奨だそうです。
:::

これで下準備終了。

## 設定

Google広告の `ツールと設定`から`スクリプト`を選択。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/319121/c9bb337e-9881-f156-10e1-3ae0db1c7aa6.png)

スクリプトを追加する際に`テンプレートから開始`を選ぶ。その次に出てくるリストの中から`アカウントの概要`を選び、`カスタマイズ`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/319121/5d50a453-766e-9a4f-0d69-0bf0f93ab36c.png)

`Config.gs`を少しだけ修正します。`YOUR_SPREADSHEET_URL`の部分にスプレッドシートのURL、`report_fields`内にれポーティングしたい指標とその名称を記載。フィールドの仕様については、[公式ドキュメント](https://developers.google.com/google-ads/api/fields/v11/metrics)を見ながら。

```javascript:Config.gs
CONFIG = {
  // URL of the report spreadsheet. This should be a copy of
  // https://docs.google.com/spreadsheets/d/1gYLXtDK93lWoTe3OBKvTlfcc7L_qHJFgWU9N6HwhZtU/copy
  'spreadsheet_url': 'YOUR_SPREADSHEET_URL',
  // More reporting options can be found at
  // https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp#report_2
  'reporting_options': {
    // Comment out the following line to default to the latest reporting
    // version.
    'apiVersion': 'v10'
  },
  /**
   * To add additional fields to the report, follow the instructions at
   * https://developers.google.com/google-ads/scripts/docs/solutions/account-summary#extending_the_report_optional
   */
  'report_fields': [
    {'columnName': 'metrics.cost_micros', 'displayName': 'Cost'},
    {'columnName': 'metrics.average_cpc', 'displayName': 'Avg. CPC'},
    {'columnName': 'metrics.ctr', 'displayName': 'CTR'},
    {'columnName': 'metrics.search_impression_share', 'displayName': 'Search Impr. share'},
    {'columnName': 'metrics.impressions', 'displayName': 'Impressions'},
    {'columnName': 'metrics.clicks', 'displayName': 'Clicks'}
  ]
};
```

`Code.gs`の方は特に変更を加えなくてOK。スクリプト実行時にセキュリティ認証が出てくる場合があるので、承認する。また、定期的に実行したい場合は、朝3時以降に実行を予約します。Google広告は最新データが反映されるまでに最大3時間の遅延が発生します。

## 出力

スプレッドシートの方のアウトプット。データはもちろんダミーです。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/319121/5e13a96f-6be0-53b9-02d7-5b36c02531fc.png)

メールにはこんな感じでデータが届きます。結構便利。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/319121/c80bddf0-208f-bd6f-2c1b-2b5ecf964ee0.png)

# まとめ

Google広告のスクリプトを初めて触ったマーケターでも、10分程度でレポーティングすることができました。使用用途にあわせてスクリプトを改変すれば、より便利になりそう！

# 参考

まだ日本語翻訳されていませんが、基本的な使い方は公式ドキュメントの方が詳しいです。

https://developers.google.com/google-ads/scripts/docs/solutions/account-summary