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