Filter grup listingan dalam tugas batch

Saat menggunakan filter grup listingan dalam konteks AdGroupCriterion.listing_group atau AssetGroupListingGroupFilter, ada beberapa pertimbangan yang harus diperhitungkan saat mendesain integrasi.

Pemisahan batch

Jika ada operasi dalam tugas batch yang berisi kriteria grup iklan atau filter grup listingan grup aset, operasi dalam tugas batch tersebut dibagi menjadi beberapa sub-batch saat diterima oleh server Google Ads API. Perlu diperhatikan bahwa tidak seperti operasi standar dalam tugas batch, setiap sub-batch yang berisi operasi filter grup listingan diperlakukan secara atomik.

Cara tugas batch yang berisi filter grup listingan dibagi menjadi sub-batch ditentukan oleh faktor-faktor berikut:

  1. Jenis filter grup listingan
  2. AdGroupCriterion atau AssetGroup yang ditargetkan filter grup listingan
  3. Urutan operasi ({i>Order of operations<i})

Ingatlah poin-poin berikut tentang cara pengelompokan operasi:

  • Semua operasi AssetGroupListingGroupFilterOperation berurutan yang menargetkan AssetGroup yang sama dikelompokkan bersama dalam sub-batch atomik (tidak ada perilaku kegagalan parsial).
  • Semua operasi AdGroupCriterionOperation berurutan yang berisi listing_group yang menargetkan AdGroup yang sama dikelompokkan bersama dalam sub-batch atomik (tidak ada perilaku kegagalan parsial).
  • Semua operasi lain yang berurutan dikelompokkan bersama dalam sub-batch non-atomik (perilaku kegagalan parsial).

Diagram di bawah mengilustrasikan konsep ini. Masing-masing kotak abu-abu mewakili tugas batch seperti yang dikirimkan menggunakan Google Ads API. Dalam kotak abu-abu, setiap operasi dikelompokkan berdasarkan warna untuk mewakili sub-tumpukan yang dibuat oleh server Google Ads API. Urutan operasi di setiap kotak abu-abu sesuai dengan urutan penambahan operasi ke tugas batch.

gambar

Batasan

Saat menggunakan filter grup listingan dalam konteks tugas batch, batasan berikut berlaku:

  • Satu batch operasi AssetGroupListingGroupFilterOperation yang berisi listing_group dan menargetkan AdGroup yang sama tidak boleh melebihi 20.000 operasi panjangnya. Namun, sebaiknya jangan melebihi 10.000 operasi.
  • Satu batch operasi AssetGroupListingGroupFilterOperation yang menargetkan AssetGroup yang sama tidak boleh melebihi 10.000 operasi.
  • Jika salah satu kondisi ini dilanggar, seluruh tugas batch akan gagal.