Filter grup listingan dalam tugas batch

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Saat menggunakan filter grup listingan dalam konteks AdGroupCriterion.listing_group atau AssetGroupListingGroupFilter, ada beberapa pertimbangan yang harus Anda pertimbangkan 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 akan dibagi menjadi beberapa sub-batch saat diterima oleh server Google Ads API. Perhatikan 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 berikut:

1. Jenis filter grup listingan
2. AdGroupCriterion atau AssetGroup yang ditargetkan oleh filter grup listingan
3. Urutan operasi

Perhatikan poin-poin berikut tentang cara operasi dikelompokkan:

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

Diagram berikut menggambarkan konsep tersebut. Setiap 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-batch yang dibuat server Google Ads API. Urutan operasi di setiap kotak abu-abu sesuai dengan urutan penambahan operasi 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.
• Melanggar salah satu kondisi ini akan menyebabkan seluruh tugas batch gagal.

Pemecahan masalah

Mencantumkan operasi filter grup dalam tugas batch diproses sebagai satu transaksi, yang dapat menyebabkan skenario saat banyak operasi gagal karena sejumlah kecil operasi yang salah. Selain itu, karena cara operasi BatchJob diproses, akar masalah kegagalan dapat muncul di indeks sebelum atau setelah kegagalan downstream.

Misalnya, saat memproses respons dari ListBatchJobResults, Anda mungkin mendapati bahwa beberapa operasi gagal dengan pesan status, Ad group is invalid due to the listing groups it contains. Pesan ini biasanya menunjukkan bahwa operasi pada indeks ini dibatalkan karena operasi gagal di indeks lain. Untuk mengidentifikasi akar masalah, sebaiknya iterasi semua pesan status di BatchJobResult—sebelum dan setelah indeks pesan error Ad group is invalid—untuk mencari informasi error tambahan.