Google Apps Scriptを駆使せよ！Adsenseのデータをスプレッドシートに自動取得する方法

Adsenseのデータをスプレッドシートに自動取得できる？？

どうも、Linです。全力で、血糖値あげてます。

サイト運営者が最も導入しやすいウェブ広告といえばGoogle Adsense。

サイトにコードを貼り付けるだけで Google のアドネットワークにの広告を表示できるので、初心者の方にもすぐに利用にできるおすすめの広告です。

僕もこの Google AdSense に日頃からお世話になっている身。

この Google アドセンスの見積もり収益額を毎日スプレッドシートにコピー＆ペーストして月の売上を予測したりしていましたが、

毎日コピー&ペーストするのは正直だるい！

1日当たりの作業量は大したことないかもしれませんが、これがちりつもで毎日やると長い目でとんでもない時間と労力をロスしていることになります。

そこで今日は、 Google アドセンスのレポートデータを取得して自動でスプレットシートに記録する方法を探してみてました。

すると、こちらの神記事にたどり着き、なんとかGoogle アドセンスのデータをスプレッドシートに自動で取得できるようになりました。

LIVESENSE DIGITAL MARKETING

AdSense Management APIを使用したパフォーマンスデータの自動レポーティング

http://marketing.livesense.co.jp/post/68748588614

こんにちは、リブセンスの岩崎亮です。 LDMの投稿としてはデマンドサイドの話が多かったので、今回は趣向を変えてサプライサイドの話を少ししようかと思います。 AdSenseといえばサプライサイドにとっては無くてはならない収益源の一つですが、高い収益性を上げるた...

今日はその方法を忘れないうちにまとめておきますね。

Adsenseのデータをスプレッドシートに自動取得する方法

Adsenseのデータをスプレッドシートに自動取得するためには、

Adsnse Management API
Google Apps Script

を使っていきますよ。

Step1. スプレッドシートを作成する

まずは AdSense のデータを取得するためのスプレッドシートを作成していきましょう。

今回は「AdSense 練習」という名前のスプレッドシートにしてみました。

Step2. スクリプトエディタを開く

スプレッドシートのメニューから「ツール」と進むと「スクリプトエディタ」というものがあります。

こちらをクリックすると、プロジェクト新規作成の画面になり、名前を付けなければならないので適当に AdSense API とでも名付けておきましょう。

すると、スプレッドシートとは別のウィンドウでスクリプトエディタという画面になります。

こちらにGoogle Apps Scriptのコードを書いていくことになりますね。

Step3. プロジェクト作成

このスクリプトエディターのメニューから「リソース」と進むと、「 Google の拡張サービス」というものがあると思います。

Step4. AdSense の API を有効化する

API の一覧ができますので、今回は「 AdSense Management API」というものを有効にしましょう。

こいつを有効にしただけは十分ではないので、さらに下の方にある「 Google Cloud platform APIダッシュボード」というものがありますので、そちらをクリックしてみます。

そこの「API とサービスの有効化」をクリックすると、

Google Cloud platform の画面になります。

「adsense」と検索してみると、 AdSense Management API というものが出てきます。

こちらを「有効にする」を選んであげましょう。

これでAPIの有効化の設定は完了なので、先ほどのスクリプトエディタに戻ってやります。

Step5. スクリプトを書く

いよいよGoogle Apps Scriptのコードを書いていきますよ。

次のようなコードをスクリプトエディタにコピー＆ペーストしてみてください。

function report() {
 var ss = SpreadsheetApp.getActiveSpreadsheet();
 var sheet = ss.getSheets()[0];
 var adClientId = 'ca-pub-xxxxxxxxxxxxx'
 var startDate = '2018-12-01';
 var endDate = '2018-12-31';
 var metrics = ['PAGE_VIEWS', 'CLICKS', 'PAGE_VIEWS_CTR', 'COST_PER_CLICK', 'PAGE_VIEWS_RPM', 'EARNINGS']
 var args = {
 'metric': metrics,
 'dimension': ['DATE'],
 'filter': ['AD_CLIENT_ID==' + adClientId],
 };
 var report = AdSense.Reports.generate(startDate, endDate, args).getRows();
 sheet.getRange(2, 1, report.length, metrics.length + 1).setValues(report);
}

function report() {

var ss = SpreadsheetApp.getActiveSpreadsheet();

var sheet = ss.getSheets()[0];

var adClientId = 'ca-pub-xxxxxxxxxxxxx'

var startDate = '2018-12-01';

var endDate = '2018-12-31';

var metrics = ['PAGE_VIEWS', 'CLICKS', 'PAGE_VIEWS_CTR', 'COST_PER_CLICK', 'PAGE_VIEWS_RPM', 'EARNINGS']

var args = {

'metric': metrics,

'dimension': ['DATE'],

'filter': ['AD_CLIENT_ID==' + adClientId],

};

var report = AdSense.Reports.generate(startDate, endDate, args).getRows();

sheet.getRange(2, 1, report.length, metrics.length + 1).setValues(report);

}

ポイントは次の3つ。

まず自分のアドセンス IDを記載する必要がありますね。スクリプトの中の「’ca-pub-xxxxxxxxxxxxx’」のpub以下のxxxxの部分には自分のアドセンスIDを描いてあげましょう。

アドセンスIDは自分のアドセンス広告コードを見れば「’ca-pub-xxxxxxxxxxxxx’」という書式でかいてあるはずです。

広告IDを記載した後はデータを取得する日付も変更してやりましょう。

startDate
endDate

という2つの変数がデータ取得開始日と終了日になりますので、

var startDate = '2018-12-01'; 
var endDate = '2018-12-31';

1 2	var startDate = '2018-12-01'; var endDate = '2018-12-31';

の日付を自分好みに変えてやればいいわけですね。

後はメトリックス。

これはどのデータを取得するかを指定できますね。

今回のサンプルコードでは、

var metrics = ['PAGE_VIEWS', 'CLICKS', 'PAGE_VIEWS_CTR', 'COST_PER_CLICK', 'PAGE_VIEWS_RPM', 'EARNINGS']

1	var metrics = ['PAGE_VIEWS', 'CLICKS', 'PAGE_VIEWS_CTR', 'COST_PER_CLICK', 'PAGE_VIEWS_RPM', 'EARNINGS']

となっていますので、

Metrics	意味
PAGE_VIEWS	PV数
CLICKS	標準的なコンテンツ広告がクリックされた回数
PAGE_VIEWS_CTR	クリックにつながったページビューの割合
COST_PER_CLICK	広告がユーザーにクリックされるたびに発生する収益
PAGE_VIEWS_RPM	ページビュー 1,000 回あたりの収益
EARNINGS	サイト運営者の見積もり収益額

というデータが今回は取得できるのです。

メトリックスについては様々な仕様が用意されていますので、詳しくはこちらのページから選んでみてくださいね。

Google Developers

指標とディメンション | AdSense Management API | ...

https://developers.google.com/adsense/management/metrics-dimensions?hl=ja#metrics

Step6. スクリプトを実行する

スクリプトを実行してアドセンスのデータを取得していきましょう。

ただし、スクリプトを実行するときにアクセスの許可を取らなければならないので粘り強さが必要で、強引に突破していきましょう。

スクリプトを実行すると、

まず「許可を確認」して、

アカウントを指定すると、

次のようなやばそうな警告画面が出現。

ここで動じずに「詳細」をクリックして隠し画面を出します。

そこに小さく「安全ではないページに移動」がありますので、そちらをクリックして、

「許可」を押してやるとスクリプトを実行できるでしょう。

ふう、長かったぜ。

Step7. トリガーの設定

ここまででデータを取得することができましたね。

後は

どのタイミングでデータを取得するのか？？

を設定していきます。これを設定してやれば、サイト運営者が手を下さずとも自動的にアドセンスのデータを取得してスプレッドシートに記録してくれるのですね。

スクリプトエディターのメニューから「編集」と進むと「現在のプロジェクトのトリガー」がありますのでそちらをクリック。

すると、次のようなトリガーの画面が出てきます。

まず下の「トリガーを追加」をクリックしてみます。

すると、トリガー設定画面が出てきますので今回は「イベントのソースを選択」から「時間主導型」を選んでみます。

すると、

時間ベースのトリガーのタイプを選択
時刻を選択

という2つの項目が出てきますのでこれらを設定していきましょう。

「時間ベースのトリガーのタイプを選択」では、どういう頻度でデータを取得するかを決め、「時刻を選択」ではスクリプトを実行する時間帯を選ぶのです。

僕の例

最後に、僕がどのようにこのアドセンスの API を用いてスプレッドシートにデータを記録したのかを書いてきましょう。

僕は毎日、

アドセンスの売上見積もり金額
表示回数
CTR
CPC

が知りたかったのでMetricsには、

EARNINGS
PAGE_VIEWS
PAGE_VIEWS_CTR
COST_PER_CLICK

を指定してやりました。スクリプトは次のようになりましたね↓

function report() {

 var ss = SpreadsheetApp.getActiveSpreadsheet();
 var now = new Date();
 var yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);
 var firstDate = new Date(now.getFullYear(), now.getMonth(), 1);
 var sheet = ss.getSheets()[0];
 var adClientId = 'ca-pub-xxxxxxxxxxx'
 var startDate = Utilities.formatDate( firstDate, 'Asia/Tokyo', 'yyyy-MM-dd');
 var endDate = Utilities.formatDate( yesterday, 'Asia/Tokyo', 'yyyy-MM-dd');
 var metrics = ['PAGE_VIEWS', 'PAGE_VIEWS_CTR', 'COST_PER_CLICK', 'EARNINGS']
 var args = {
 'metric': metrics,
 'dimension': ['DATE'],
 'filter': ['AD_CLIENT_ID==' + adClientId],
  'useTimezoneReporting': true,
 };
 var report = AdSense.Reports.generate(startDate, endDate, args).getRows();

 sheet.getRange(7, 2, report.length, metrics.length + 1).setValues(report);
}