批次處理可將一組可能相互依賴的操作分派至多項服務,而不必同步等待操作完成。您可以使用批次處理功能,建立及管理最高成效廣告活動。
本指南提供使用批次處理時,最高成效廣告活動的專屬詳細資料。一般批次處理指南提供批次處理的一般資訊,結構要求指南則包含建構要求以建立或管理最高成效廣告活動的詳細資訊。
如要使用批次處理建立最高成效廣告活動,請按照下列步驟操作:
建立新的批次工作
按照一般批次處理工作建立步驟,建立 BatchJob 資源。
準備變動作業清單
最高成效廣告活動需要執行多項作業,才能建立多個相關資源,詳情請參閱結構要求指南。為要納入批次工作的每項資源建立 MutateOperation。
CampaignOperation 和 CampaignAssetOperation 需求條件
為最高成效廣告活動Campaign (brand_guidelines_enabled 預設為 true,除非您設為 false 或建立旅遊目標廣告活動) 啟用品牌宣傳指南時,您必須使用 CampaignAsset 資源,將品牌 Asset 資源連結至廣告活動。在地生活服務最高成效廣告活動不支援品牌宣傳指南,且會省略品牌 CampaignAsset 資源 (建立廣告活動時,請將 brand_guidelines_enabled 設為 false)。只有在建立不含自訂 AssetGroupAsset 資源 (HTML5 MEDIA_BUNDLE 素材資源除外) 的無素材資源廣告活動,或 brand_guidelines_enabled 設為 false 時,零售最高成效廣告活動 (含 Merchant Center 動態饋給) 才能在同一個原子子批次中省略品牌 CampaignAsset 資源。
在批次工作中,建立 Campaign 資源本身後,立即建立這些 CampaignAsset 資源 (不可分割式子批次中最多可有 1,000 項作業)。Campaign create 作業 (resource_name) 及其後續的 CampaignAsset create 作業 (campaign) 必須指定相同的負臨時 ID,且任何必備的 AssetOperation create 作業都必須放在 Campaign 建立作業之前。如果 CampaignAsset 資源未在 Campaign 資源建立後立即建立 (啟用品牌宣傳指南時,請參閱疑難排解),要求就會失敗,並傳回 CampaignError,指出缺少素材資源。即使在同一份作業清單中加入 CampaignAsset 建立作業,也無法避免這項錯誤。
AssetGroupOperation 和 AssetGroupAssetOperation 需求條件
使用 AssetGroupAsset 建立 AssetGroup 資源和相關聯的 Asset 資源,以符合最低素材資源規定時,在批次工作中建立 AssetGroup 和 AssetGroupAsset 資源的 MutateOperation 物件必須依序排列,中間不得有其他作業,因為這些作業會分組為不可分割的子批次 (每個子批次最多 1,000 項作業)。在 AssetGroup create 作業 (resource_name) 及其後續的 AssetGroupAsset create 作業 (asset_group) 中,指定相同的負數臨時 ID,並在建立 AssetGroup 之前,放置任何必要的 AssetOperation create 作業。否則,即使符合最低素材資源規定所需的操作包含在操作清單後續部分,要求仍會失敗,並顯示 AssetGroupError,指出缺少部分素材資源。
AssetGroupListingGroupFilterOperation 項最佳做法
建立、更新或移除 AssetGroupListingGroupFilter 資源時,請將指定相同 AssetGroup 的所有 AssetGroupListingGroupFilterOperation 作業,連續加入批次工作,這樣在批次分割期間,這些作業就會分到同一個不可分割的子批次。如要進一步瞭解批次拆分和其他影響商家資訊群組的因素,請參閱商家資訊群組批次處理指南。
將異動作業新增至工作
將步驟 2 的變動作業加入清單,然後呼叫 AddBatchJobOperations 方法,將變動清單加入步驟 1 建立的批次工作。請按照一般批次處理指南中的新增作業步驟,新增變動作業清單。
執行批次工作
呼叫 RunBatchJob 方法,開始執行上傳的操作。如需範例,請參閱一般批次處理指南中的「執行批次工作」步驟。
輪詢工作狀態並擷取結果
批次工作會以長時間執行的作業形式執行,通常需要一段時間才能完成。啟動工作後,請在 google.longrunning.Operations 服務上使用 Operations.GetOperation 方法 (或使用 GoogleAdsService 查詢 batch_job.status),輪詢工作狀態,直到工作完成。
批次工作完成後,請呼叫 ListBatchJobResults 方法,擷取工作中每項作業的狀態和回應。如需範例,請參閱「列出所有批次工作結果」。