批次處理可讓您將一組可能相互依存的作業,分派至多項服務,不必同步等待作業完成。您可以使用批次處理功能,建立及管理最高成效廣告活動。
本指南詳細說明使用批次處理時,最高成效廣告活動的相關細節。一般批次處理指南提供批次處理的一般資訊,結構要求指南則提供建立或管理最高成效廣告活動要求的詳細資訊。
如要使用批次處理建立最高成效廣告活動,請按照下列步驟操作:
建立新的批次工作
按照一般批次處理工作建立步驟,建立 BatchJob 資源。
準備變動作業清單
最高成效廣告活動需要執行作業,才能建立多項相關資源,詳情請參閱結構要求指南。為要納入批次工作的每項資源建立 MutateOperation。
CampaignOperation 和 CampaignAssetOperation 需求條件
如果廣告活動已啟用品牌宣傳指南 (請參閱品牌宣傳指南),您必須使用 CampaignAsset 資源,將品牌資產連結至廣告活動。此外,在批次工作中,這些 CampaignAsset 資源的建立作業必須在 Campaign 資源本身建立後立即進行。如果 CampaignAsset 資源未在 Campaign 資源之後立即建立 (啟用品牌宣傳指南時,請參閱疑難排解),要求就會失敗,並傳回 CampaignError,表示缺少素材資源。即使在同一份作業清單中加入 CampaignAsset 建立作業,也無法避免這項錯誤。
AssetGroupOperation 和 AssetGroupAssetOperation 需求條件
在批次工作中建立 AssetGroup 和 AssetGroupAsset 資源的 MutateOperation 類型作業必須依序執行,中間不得有其他作業,因為這些作業在處理時會分組在一起。否則,即使符合最低素材資源需求所需的操作包含在操作清單後續部分,要求仍會擲回 AssetGroupError,指出缺少部分素材資源。
AssetGroupListingGroupFilterOperation 最佳做法
在 AssetGroupListingGroupFilter 的情境下使用商家資訊群組篩選條件時,建議您將指定相同 AssetGroup 的 AssetGroupListingGroupFilterOperation 作業連續新增至批次工作,這樣在批次分割期間,系統就會將這組作業視為一個整體。如要進一步瞭解批次拆分和其他影響商家資訊群組的因素,請參閱商家資訊群組批次處理指南。
將變動作業新增至工作
將步驟 2 的變動操作加入清單,然後呼叫 AddBatchJobOperations,將變動清單加入步驟 1 建立的批次工作。請按照一般批次處理指南中的新增廣告營運步驟,新增變動作業清單。
執行批次工作
呼叫 RunBatchJob,允許上傳的工作開始執行。如需範例,請參閱一般批次處理指南中的「執行批次工作」步驟。
擷取工作狀態
批次工作會以長時間執行的作業形式啟動,通常需要一段時間才能完成。啟動工作後,請使用長時間執行的作業的
GetOperation
方法輪詢工作狀態,直到工作完成為止。
所有批次工作完成後,請呼叫 ListBatchJobResults,按照一般批次處理指南中的「列出所有批次工作結果」步驟,列印狀態和回應。