ASPの成果レポートをGoogleスプレッドシートへ自動取得する方法

ASPごとに管理画面を開いて成果件数や報酬額を確認する作業は、登録案件が増えるほど負担になります。Googleスプレッドシートと連携すれば、日次の成果レポートを自動取得し、複数ASPのデータを一つの場所で比較できます。

連携方法は、ASPが提供するAPIを使う方法、成果データをCSVで取得して取り込む方法、メール通知を加工する方法に分けられます。利用できる手段はASPによって異なるため、最初に規約と管理画面の機能を確認しましょう。

ここでは、Google Apps Script（GAS）を使ってスプレッドシートへ成果情報を保存する流れを解説します。クリック数、発生成果、確定報酬、未確定報酬を同じ形式に整えると、収益分析や広告案件の入れ替えも効率化できます。

連携方法	自動化のしやすさ	初期設定	向いているケース
API連携	高い	やや難しい	定期取得と詳細分析
CSV取り込み	中程度	普通	APIがないASP
メール転送	低い	普通	簡易的な成果確認
手動入力	低い	簡単	少数案件の試用

連携前に確認するASPの仕様

まず、利用中のASPがAPIを公開しているかを確認します。APIキー、媒体ID、広告主ID、取得可能な期間、リクエスト回数の上限などが主な確認項目です。APIがなければ、管理画面からCSVをダウンロードし、GASで自動処理する構成を検討します。

成果のステータスにも注意が必要です。発生、承認、否認、保留などの定義はASPごとに違い、同じ「報酬額」でも集計条件が異なります。ASP比較を行う際は、確定報酬と発生報酬を別列に保存すると、実際の入金額を誤って判断しにくくなります。

スプレッドシートの基本設計

新しいシートを作成し、「成果データ」「設定」「集計」の3つに分けます。成果データには取得日、ASP名、案件名、クリック数、成果件数、報酬額、ステータスを記録し、設定シートにはAPIキーや取得開始日を保存します。

APIキーはセルに直接表示したままにせず、GASのプロパティサービスへ登録する方法が安全です。テスト用のリンク先を確認するときも、運営元や掲載内容が明確なページを使い、掲載内容を確認してから計測対象に加えます。

GASで成果レポートを取得する手順

スプレッドシートの「拡張機能」から「Apps Script」を開き、APIへ接続するコードを作成します。基本的な処理は、設定値の読み込み、HTTPリクエスト、JSONやCSVの解析、行データへの変換、シートへの追加という流れです。

function fetchReport() {
  const sheet = SpreadsheetApp.getActive()
    .getSheetByName('成果データ');
  const apiKey = PropertiesService.getScriptProperties()
    .getProperty('API_KEY');

  const url = 'https://example.com/api/report?date=2025-01-01';
  const response = UrlFetchApp.fetch(url, {
    headers: { 'Authorization': 'Bearer ' + apiKey }
  });

  const data = JSON.parse(response.getContentText());
  data.items.forEach(item => {
    sheet.appendRow([
      new Date(),
      item.campaign,
      item.clicks,
      item.conversions,
      item.revenue,
      item.status
    ]);
  });
}

実際にはASPごとにエンドポイントやパラメータ、認証方式が異なります。取得済みの日付を記録し、同じレポートを重複保存しない仕組みも必要です。初回は1日分のデータで動作確認し、列ずれや文字化けがないことを確かめてから期間を広げます。

集計しやすいデータに整える方法

ASPごとに項目名が異なる場合は、共通フォーマットへ変換します。たとえば「成果数」「コンバージョン」「CV」はすべて「成果件数」に統一し、日付も同じ形式で保存します。クリック計測を重視する案件では、クリック型案件の情報も参考にしながら、クリック数と成果数の関係を確認すると分析しやすくなります。

自動取得後は、集計シートでASP別・案件別・月別のピボットテーブルを作成します。成果単価は「報酬額÷成果件数」、承認率は「承認件数÷発生成果数」で算出できます。数値が空欄のときはゼロとして扱うか、未取得として区別するかをあらかじめ決めておきます。

設定時に確認する項目は次のとおりです。

• APIキーをスクリプトプロパティで管理する
• 取得日と対象期間を別々に記録する
• 同一案件の重複行を防止する
• 発生と確定のステータスを分ける

運用時に確認する数値は次のとおりです。

• クリック数と成果件数の推移
• 承認率と確定報酬額
• ASP別の未取得データ
• APIエラーや取得停止の有無

トラブルを防ぐ運用と自動化

GASの時間主導型トリガーを使えば、毎日決まった時刻にレポートを取得できます。ASP側の更新時間を考慮し、深夜ではなく翌日の午前中に実行すると、前日分のデータを取り込みやすくなります。実行ログとエラー通知も設定しておくと、連携停止に早く気づけます。

API制限に達した場合は、取得期間を短くする、実行回数を減らす、前回取得日時以降だけを取得するなどの対策を行います。列構成を変更する際はGASの書き込み位置も見直し、バックアップ用シートを残しておくと復旧が容易です。

まずは一つのASPと一つの案件で自動取得を試し、正しい成果数と報酬額が保存できることを確認してください。動作確認後にASPを追加し、集計テンプレートを整備すれば、日々のレポート確認を効率化しながら、広告運用の判断材料を一元管理できます。