Filter grup listingan dalam tugas batch

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

Pemisahan batch

Poin Penting: Sebaiknya tambahkan operasi AssetGroupListingGroupFilterOperation yang menargetkan operasi AssetGroup dan AdGroupCriterionOperation yang sama yang berisi listing_group yang menargetkan AdGroup yang sama, ke tugas batch secara berurutan, sehingga kumpulan operasi diperlakukan secara atomik selama pemisahan batch.

Jika ada operasi dalam tugas batch yang berisi kriteria grup iklan atau filter grup listingan grup aset, operasi dalam tugas batch tersebut akan dibagi menjadi beberapa sub-batch saat diterima oleh server Google Ads API. Perlu diketahui 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

Perhatikan poin-poin berikut tentang cara mengelompokkan operasi:

• Semua operasi AssetGroupListingGroupFilterOperation berturut-turut yang menargetkan AssetGroup yang sama dikelompokkan dalam sub-batch atomik (tanpa perilaku kegagalan sebagian).
• Semua operasi AdGroupCriterionOperation berturut-turut yang berisi listing_group yang menargetkan AdGroup yang sama akan dikelompokkan bersama dalam sub-batch atomik (tanpa perilaku kegagalan sebagian).
• Semua operasi berturut-turut lainnya dikelompokkan bersama dalam sub-batch non-atom (perilaku kegagalan parsial).

Istilah Penting: Consecutive mengacu pada urutan operasi dalam tugas batch.

Diagram di bawah mengilustrasikan konsep ini. Setiap kotak abu-abu mewakili tugas batch seperti yang dikirim menggunakan Google Ads API. Dalam kotak abu-abu, setiap operasi dikelompokkan menurut warna untuk mewakili sub-batch yang dibuat oleh server Google Ads API. Urutan operasi di setiap kotak abu-abu sesuai dengan urutan operasi yang akan ditambahkan ke tugas batch.

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. 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.