AdWords Script: Quality Score(品質スコア)の詳細項目を取得するスクリプト

AdWordsのキーワード別の品質スコア(1-10)とキーワード診断の結果(吹き出しアイコンに表示される詳細情報)を一覧で取得して、Google Spreadsheetに出力するスクリプト。(スクリプトの終了後にEmailで通知)

項目の説明

• Quality Score: 品質スコア(1-10)
• Creative Quality Score: 広告の関連性(3段階評価)
• Post Click Quality Score: ランディングページの利便性(3段階評価)
• Search Predict CTR: 推定クリック率(3段階評価)

書き換える箇所

• YOUR_EMAIL_HERE: 利用するEMAILアドレスに書き換え
• GOOGLE-SPREADSHEET_URL: 出力先のGoogle SpreadsheetのURLに書き換え
• SHEETNAME: 出力先のGoogle SpreadsheetのSheet名を入力
• LAST_30_DAYS: 取得したい期間に応じて変更

QS-detailattributes.gs

  // global variable
  var email = 'YOUR_EMAIL_HERE';
  var spreadsheet_url = 'GOOGLE-SPREADSHEET_URL';
  var formattedDate = Utilities.formatDate(new Date(), "GMT", "yyyy-MM-dd'T'HH:mm:ss'Z'");
  var cid = AdWordsApp.currentAccount().getCustomerId();
  var accountname = AdWordsApp.currentAccount().getName();


  function main() {
      var inputSheet = SpreadsheetApp.openByUrl(spreadsheet_url).getActiveSheet();
      var spreadsheet = setSpreadsheet(spreadsheet_url);
      var rawsheet = spreadsheet.getSheetByName('SHEETNAME');

      // select report data  
      var report = AdWordsApp.report(
          'SELECT CampaignName, AdGroupName, Criteria, Id, QualityScore, CreativeQualityScore, PostClickQualityScore, SearchPredictedCtr ' +
          'FROM   KEYWORDS_PERFORMANCE_REPORT ' +
          'WHERE  Impressions > 0 ' +
          'DURING LAST_30_DAYS');

      // export data
      report.exportToSheet(rawsheet);
      rawsheet.sort(5, false);

      var header = [
          'Campaign',
          'AdGroup',
          'Keyword',
          'Id',
          'Quality Score',
          'Creative Quality Score',
          'Post Click Qlick Score',
          'Search Predict CTR'
      ];

      // recording logs and email setting
      Logger.log('Adwords script for QS detail attributes is complete.\n' +
          spreadsheet.getUrl());
      if (email) {
          MailApp.sendEmail(email,
              'Quality Score detail attributes report is complete.' + ' ' + accountname + ' ' + formattedDate,
              spreadsheet.getUrl());
      }

      function setSpreadsheet(spreadsheetUrl) {
          return SpreadsheetApp.openByUrl(spreadsheetUrl);
      }
  }