close
Google AdWords API
Get Started
- 有時間可以稍微看一下介紹影片,會有一個基礎概念(有簡中字幕)
Service
- 目前 AdWords 的設定與數值,最新的版本是 v201806,專案使用的版本是 v201802
- 支援 ORDER BY and LIMIT,所以可以排序與分頁;但 API 設定的 PAGE_LIMIT 比較像是一次跟 API 取得的資料量,而不是指資料的分頁
BiddingStrategyService
- 取得的物件是 SharedBiddingStrategy
- 目前常用的修改類型是 Manual CPC 與 Target CPA
- Target CPA 設定方式:
- 之前儲存的設定 from SharedBiddingStrategy
- 建立新的設定
- 單純設定金額
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
- 取得的物件是 Budget
- 修改 Campaign 預算金額要使用這個 Service,從 CampaignService 無法修改
- 因為欄位名稱與 Reflection 取得的欄位名稱不同,所以需要重新整理
// 忽略的欄位名稱
[
'Id',
'Name',
'ReferenceCount',
'IsExplicitlyShared',
'Status',
];
// 正確的欄位名稱
[
'BudgetId',
'BudgetName',
'BudgetReferenceCount',
'IsBudgetExplicitlyShared',
'BudgetStatus',
];
AdGroupCriterionService
- 取得的物件是 AdGroupCriterion
- AdGroups 的各種設定,Keyword 是其中一種類型
- Keyword 的 bid amount 預設是跟 AdGroups 一樣,但也可以針對 Keyword 單獨設定 Max. CPC
- Keyword 的 bid 分為三種類型
ManagedCustomerRepository
- 取得的物件是 ManagedCustomer
- 可以透過 MCC ID 取得所有其他的 google customer id
ConversionTrackerService
- 取得的物件是 ConversionTracker
- 可以取得目前 google 建立所有的 Conversion Actions
Report
- 統計後的數值,偏向 AdWords 的歷史紀錄
- definition(fields) 有很多類型,可以使用的有 ATTRIBUTE, METRIC;SEGMENT 不可使用
- 根據 definition(fields) 不同,結果數量也會不同;指定 definition 沒有值的資料會被忽略,所以顯示愈多 definition 資料量愈多
Choosing the right report
取得所有可用的 report definition
$reportDefinitionService = $this->adWordsServices->get($this->adWordsSession, ReportDefinitionService::class);
$reportDefinitionFields = $reportDefinitionService->getReportFields($this->table);
Campaign Performance Report
- Conversion Tracker 相關欄位
[
'CampaignId',
'ConversionTrackerId',
'ConversionTypeName',
'AllConversions',
];
Adgroup Performance Report
Codes and Formats
- Google AdWords API 會使用到的常數
Common Errors
RATE_EXCEEDED
- 一般操作一天最多呼叫 10,000 次 operations 與 1,000 次 reports
- 次數更新時間似乎是動態的,根據官方說法,被限制後等 24 小時是最保險的
- 升級成 Standard 帳號後就沒有限制,可以透過表單申請
TOO_MANY_PREDICATE_VALUES
文章標籤
全站熱搜