批次處理可讓您將一組作業 (可能相互依存) 分派至多項服務,而不必同步等待作業完成。您可以使用批次處理功能,建立及管理最高成效廣告活動。
本指南將詳細說明使用批次處理時,最高成效廣告活動的相關資訊。一般批次處理指南提供批次處理的一般資訊,而結構化要求指南則詳細說明如何建構要求,以建立或管理最高成效廣告活動。
如要使用批次處理功能建立最高成效廣告活動,請按照下列步驟操作:
建立新的批次工作
按照一般批次處理作業建立步驟,建立 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
列印作業的狀態和回應。