Google AdWords API

Get Started

• https://developers.google.com/adwords/api/docs/guides/start
• 有時間可以稍微看一下介紹影片，會有一個基礎概念（有簡中字幕）

Service

• https://developers.google.com/adwords/api/docs/reference/release-notes/v201802
• 目前 AdWords 的設定與數值，最新的版本是 v201806，專案使用的版本是 v201802
• 支援 ORDER BY and LIMIT，所以可以排序與分頁；但 API 設定的 PAGE_LIMIT 比較像是一次跟 API 取得的資料量，而不是指資料的分頁

BiddingStrategyService

• https://developers.google.com/adwords/api/docs/reference/v201802/BiddingStrategyService
• 取得的物件是 SharedBiddingStrategy
• BiddingStrategyType
• 目前常用的修改類型是 Manual CPC 與 Target CPA
• Target CPA 設定方式：
  1. 之前儲存的設定 from SharedBiddingStrategy
  2. 建立新的設定
  3. 單純設定金額

CampaignService

• https://developers.google.com/adwords/api/docs/reference/v201802/CampaignService
• 取得的物件是 Campaign
• fields ignored when sent to the API

[
    'ConversionOptimizerEligibility',
    'FrequencyCap',
    'NetworkSetting',
    'BiddingStrategyConfiguration',
    'ForwardCompatibilityMap',
    'VanityPharma',
    'Budget',
 
    // 使用原資料修改後更新時這個欄位會有問題，暫時以忽略這個欄位的方式避開錯誤
    'AdServingOptimizationStatus',
];

• fields Budget

[
    'BudgetId',
    'BudgetName',
    'Amount',
    'DeliveryMethod',
    'BudgetReferenceCount',
    'IsBudgetExplicitlyShared',
    'BudgetStatus',
];

• fields BiddingStrategyConfiguration

[
    'BiddingStrategyId',
    'BiddingStrategyName',
    'BiddingStrategyType',
];

• fields TargetCpaBiddingScheme

[
    'TargetCpa',
    'TargetCpaMaxCpcBidCeiling',
];

BudgetService

• https://developers.google.com/adwords/api/docs/reference/v201802/BudgetService
• 取得的物件是 Budget
• 修改 Campaign 預算金額要使用這個 Service，從 CampaignService 無法修改
• 因為欄位名稱與 Reflection 取得的欄位名稱不同，所以需要重新整理

// 忽略的欄位名稱
[
    'Id',
    'Name',
    'ReferenceCount',
    'IsExplicitlyShared',
    'Status',
];
 
// 正確的欄位名稱
[
    'BudgetId',
    'BudgetName',
    'BudgetReferenceCount',
    'IsBudgetExplicitlyShared',
    'BudgetStatus',
];

AdGroupCriterionService

• https://developers.google.com/adwords/api/docs/reference/v201802/AdGroupCriterionService
• 取得的物件是 AdGroupCriterion
• AdGroups 的各種設定，Keyword 是其中一種類型
• Keyword 的 bid amount 預設是跟 AdGroups 一樣，但也可以針對 Keyword 單獨設定 Max. CPC
• Keyword 的 bid 分為三種類型
  1. CpaBid
  2. CpcBid
  3. CpmBid

ManagedCustomerRepository

• https://developers.google.com/adwords/api/docs/reference/v201802/ManagedCustomerService
• 取得的物件是 ManagedCustomer
• 可以透過 MCC ID 取得所有其他的 google customer id

ConversionTrackerService

• https://developers.google.com/adwords/api/docs/reference/v201802/ConversionTrackerService
• 取得的物件是 ConversionTracker
• 可以取得目前 google 建立所有的 Conversion Actions

Report

• https://developers.google.com/adwords/api/docs/appendix/reports
• 統計後的數值，偏向 AdWords 的歷史紀錄
• definition(fields) 有很多類型，可以使用的有 ATTRIBUTE, METRIC；SEGMENT 不可使用
• 根據 definition(fields) 不同，結果數量也會不同；指定 definition 沒有值的資料會被忽略，所以顯示愈多 definition 資料量愈多
• 不支援 ORDER BY and LIMIT

Choosing the right report

• https://developers.google.com/adwords/api/docs/guides/reporting#choosing_the_right_report

取得所有可用的 report definition

$reportDefinitionService = $this->adWordsServices->get($this->adWordsSession, ReportDefinitionService::class);
$reportDefinitionFields = $reportDefinitionService->getReportFields($this->table);

Campaign Performance Report

• https://developers.google.com/adwords/api/docs/appendix/reports/campaign-performance-report
• Conversion Tracker 相關欄位

[
    'CampaignId',
    'ConversionTrackerId',
    'ConversionTypeName',
    'AllConversions',
];

Adgroup Performance Report

• https://developers.google.com/adwords/api/docs/appendix/reports/adgroup-performance-report

Codes and Formats

• https://developers.google.com/adwords/api/docs/appendix/codes-formats
• Google AdWords API 會使用到的常數

Common Errors

RATE_EXCEEDED

• https://developers.google.com/adwords/api/docs/common-errors#RateExceededError.RATE_EXCEEDED
• 一般操作一天最多呼叫 10,000 次 operations 與 1,000 次 reports
• 次數更新時間似乎是動態的，根據官方說法，被限制後等 24 小時是最保險的
• 升級成 Standard 帳號後就沒有限制，可以透過表單申請

TOO_MANY_PREDICATE_VALUES

• https://developers.google.com/adwords/api/docs/reference/v201802/MediaService.SelectorError
• 條件參數數量超過 10,000