批次處理可讓您將一組可能彼此相關的作業調度至多個服務,而無須同步等待作業完成。您可以使用批次處理功能建立及管理最高成效廣告活動。
本指南將說明最高成效廣告活動在使用批次處理功能時的相關細節。通用的批次處理指南提供批次處理的一般資訊,而結構化要求指南則包含有關建構要求以建立或管理最高成效廣告活動的詳細資訊。
如要使用批次處理功能建立最高成效廣告活動,請按照下列步驟操作:
建立新的批次工作
如要建立 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
,按照一般批次處理指南中的列出所有批次工作結果步驟,列印工作狀態和回應。