在批次工作中列出群組篩選器

AdGroupCriterion.listing_groupAssetGroupListingGroupFilter的環境中處理產品資訊群組篩選器時,請在設計整合功能時考量下列事項。

批次分割

如果批次作業包含廣告群組條件或素材資源群組產品群組篩選器,Google Ads API 伺服器收到批次作業時,會將作業分割成多個子批次。請注意,與批次作業中的標準作業不同,包含商家資訊群組篩選器作業的每個子批次都會以原子方式處理。

含有產品組合篩選器的批次作業會分割成子批次,分割方式取決於下列因素:

  1. 商家資訊群組篩選器類型
  2. AdGroupCriterionAssetGroup商家資訊群組篩選器正在指定目標
  3. 作業順序

請考慮作業的分組方式:

下圖說明瞭這個概念。每個灰色方塊代表透過 Google Ads API 提交的批次工作。在灰色方塊中,個別作業會依顏色分組,代表 Google Ads API 伺服器建立的子批次。每個灰色方塊中的作業順序,對應於作業加入批次工作的順序。

圖片

批次分割的完整性

Google Ads API 可能會將提交的批次工作中的作業,分割成較小的子批次進行處理。如果您未將相關作業分組,例如在批次作業中,連續在 AssetGroupAdGroup 中修改產品組合,Google Ads API 可能會將這些作業分成不同的子批次。這種分離可能會導致整個修改作業失敗,或使帳戶處於不一致的狀態。

邏輯分組

AssetGroupListingGroupFilterOperation 管理AssetGroup中的產品資訊群組,這在最高成效廣告活動中很常見。 AdGroupCriterionOperation 管理AdGroup中的產品組合群組,這在標準購物廣告活動中很常見。兩者都用於定義產品指定目標。如果您進行的變更會影響兩個環境中的產品指定目標階層,請在批次作業中連續分組這些作業,確保系統會一併套用。

資料一致性

為確保資料一致性並避免部分更新,請將相關的產品資訊群組作業連續新增至批次工作。這樣一來,API 的批次分割邏輯會將這些作業分組為原子子批次,避免帳戶處於不一致的狀態。

限制

在批次作業中使用產品資訊群組篩選器時,請注意下列限制:

疑難排解

批次作業中的產品資訊群組篩選作業會以單一交易的形式處理,因此如果只有少數作業發生錯誤,可能會導致許多作業失敗。此外,由於 BatchJob 作業的處理方式,失敗的根本原因可能會出現在下游失敗之前或之後的索引中。

舉例來說,處理 ListBatchJobResults 的回應時,您可能會發現多項作業失敗,並顯示狀態訊息 Ad group is invalid due to the listing groups it contains。這則訊息通常表示,由於其他索引的作業失敗,因此這個索引的作業已取消。如要找出問題的根本原因,建議您在 BatchJobResult 中,逐一查看索引 Ad group is invalid 錯誤訊息前後的所有狀態訊息,尋找其他錯誤資訊。