在 AdGroupCriterion.listing_group
或 AssetGroupListingGroupFilter
中使用商家資訊群組篩選器時,在設計整合時應考量幾點。
批次分割
如果批次工作中有任何作業包含廣告群組條件或素材資源群組商家資訊群組篩選條件,則 Google Ads API 伺服器收到批次工作時,系統會將批次工作中的作業拆分成多個「子批次」。請注意,與批次工作中的標準作業不同,每個包含商家資訊群組篩選作業的子批次都會以不可分割的形式處理。
包含商家資訊群組篩選器的批次工作如何拆分為子批次,取決於下列因素:
- 商家資訊群組篩選器類型
- 商家資訊群組篩選器指定的
AdGroupCriterion
或AssetGroup
- 作業順序
請注意下列作業分組方式的要點:
- 凡是指定同一個
AssetGroup
的連續AssetGroupListingGroupFilterOperation
作業,都會歸類為不可分割的子批次 (不會出現部分失敗行為)。 - 凡是包含
listing_group
指定相同AdGroup
的連續AdGroupCriterionOperation
作業,都會歸入不可分割的子批次 (不會發生部分失敗行為)。 - 所有其他連續作業都會分成非原子子批次 (部分失敗行為) 進行分組。
下圖說明瞭這個概念。每個灰色方塊都代表使用 Google Ads API 提交的批次工作。在灰色方塊中,個別作業會依顏色分組,代表 Google Ads API 伺服器建立的子批次。每個灰色方塊中的作業順序對應於將作業加入批次工作的順序。
限制
在批次工作中使用商家資訊群組篩選器時,適用以下限制:
- 一個批次包含
listing_group
且指定相同AdGroup
的AssetGroupListingGroupFilterOperation
作業批次不得超過 20,000 個作業的長度。不過,建議不要超過 10,000 項作業。 - 指定同一個
AssetGroup
的單批次AssetGroupListingGroupFilterOperation
作業不得超過 10,000 個作業。 - 違反上述任一條件會導致整批次工作失敗。