2015年2月2日月曜日

【AdWords script】1. レポートをGoogleスプレッドシートに流し込む

さて、AdWords scriptについてもそろそろ書いていきましょう。

AdWords scriptは今まで取り上げてきたGoogle Apps ScriptがAdWords管理画面にIDE(統合開発環境)がエンベッドされているものです。AdWordsアカウントの入札、入稿、レポーティングにおけるさまざまな自動処理が可能になる、非常に便利な機構です。

日々の運用管理をする上でデータのモニタリングは当然大事ですが、いちいちCSVでレポートデータを管理画面から落としてExcelで処理しなくても、Googleスプレッドシートに自動的にデータを落とし、必要な処理を関数化したりGoogle Apps Scriptで処理を定義することが可能です。

同じGoogleのプラットフォームですので、AdWordsとGoogleスプレッドシートと連携させるのはとても楽です。特にAdWordsに対する認証やアカウントの選択をコードにする必要がなく簡単です。

前述のように、レポートデータを落としてからの処理がキモではありますが、まずはどのようにAdWords scriptを設定しデータをGoogleスプレッドシートに流し込むかのキホンとコツを解説します。

AdWords scriptの設定
実際のAdWords scriptを見ながら解説します。このままご自分のAdWordsアカウントのAdWords scriptにコピペ利用できますので、ぜひトライしてみてください。

 【サンプルコード】
これだけです。簡単ですね。AdWords scriptに名前を付けて保存してください。実行すると、「Campaign Performance Report + '取得日時'」という名前のスプレッドシートができているはずです。

ブロック毎にコメントアウト(//の部分)していますので、参考にしてください。
最初の部分は、ファイル名(レポート名+日付)をつけたスプレッドシートを生成するための変数指定になっています。最後のexportToSheetメソッドで、実際のスプレッドシート生成とデータのエキスポートを同時に処理するようになっています。

これは実はいろいろやり方はあるかと思ってまして、
  1. 新しいスプレッドシートを生成
  2. 既成のテンプレートをコピー利用する
  3. 既成のスプレッドシートの値を毎回消して利用する
今回の場合は1.にしていますが、みなさんの好みで処理方法は選んでください。

AWQL(AdWords Query Language)と便利なツール
真ん中のAdWordsApp.reportオブジェクトでAdWordsレポートの種類、出力するフィールド、出力条件を指定します。

この部分はAWQL(AdWords Query Language)というAdWordsデータに対してクエリーをかけるためのSQLライクな言語です。
  • SELECTで出力したいフィールドを指定しています。CampaignId、Impressions、 Clicks、Ctr、Costを指定しました。投稿の都合上、キャンペーンIDにしていますが、キャンペーン名(CampaignName)にするとわかりやすいでしょう(日本語でも問題ありません)。
  • FROMで出力したいレポートを指定しいています。今回はキャンペーンレポート(CAMPAIGN_PERFORMANCE_REPORT)を指定しています。
  • WHEREは条件指定です。Impressions > 0とすることでインプレッション1以上のキャンペーンのみを出力します。
  • DURINGは期間指定です。LAST_30_DAYSで過去30日間を指定しています。20150101,20150131のように、日付で期間指定することも可能です。
  • その他、ソート順や取得件数なども指定できますが、詳細はこちらをご覧ください(https://developers.google.com/adwords/api/docs/guides/awql
AdWordsにはいろいろな種類のレポートがありますし、取得できるデータの種類も多数あります。クエリー文を書くための便利な外部ツールがありますのでご紹介します。その名もAWQL.me(https://www.awql.me/)。

ログインします。認証を完了すればコンソールでAdWordsアカウントをプルダウンで選択できるようになります。

コンソールでfromの行にマウスを合わせると右のHelpの内容が変わりますね。ここでレポートの種類を確認できますので、別のものを選択したい場合はHelpのレポート名をコピペして、コンソールのfromの部分を置き換えてください。

レポート種類を変えると、そのレポートで取得できるフィールドが出てくることも確認できるかと思います。同じように必要なフィールドをコピペしてください。

Runを押すと、下に結果が戻ってきます。ここで実際にAWQLコードが間違っていないか確認できます。

コードが確認できたら、AdWords scriptで活用ください(AWQL.meの指定を参考にしつつ、コードの書き方は実際のAdWords scriptのそれに準じてください)。

1 件のコメント:

  1. It is very arduous to mention once precisely have to be compelled to money your check. generally it's going to terribly troublesome to money if it's not official hours

    返信削除