Filter grup listingan dalam tugas batch

Saat Anda menggunakan filter kelompok listingan dalam konteks AdGroupCriterion.listing_group atau AssetGroupListingGroupFilter, perhatikan pertimbangan berikut saat mendesain integrasi Anda.

Pembagian 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 kelompok listing dibagi menjadi sub-batch ditentukan oleh faktor-faktor berikut:

1. Jenis filter kelompok listing
2. AdGroupCriterion atau AssetGroup yang ditargetkan oleh filter kelompok listing
3. Urutan operasi

Pertimbangkan cara operasi dikelompokkan:

• Semua operasi AssetGroupListingGroupFilterOperation berurutan yang menargetkan AssetGroup yang sama dikelompokkan bersama dalam sub-batch atomik (tidak ada perilaku kegagalan sebagian).
• Semua operasi AdGroupCriterionOperation berurutan yang berisi listing_group yang menargetkan AdGroup yang sama dikelompokkan bersama dalam sub-batch atomik (tidak ada perilaku kegagalan sebagian).
• 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 yang dikirimkan menggunakan Google Ads API. Dalam kotak abu-abu, setiap operasi dikelompokkan berdasarkan 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 kelompok listing dalam konteks tugas batch, batasan berikut berlaku:

• Satu batch AdGroupCriterionOperation operasi 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.

Pemecahan masalah

Operasi filter kelompok listingan dalam tugas batch diproses sebagai satu transaksi, yang dapat menyebabkan skenario ketika banyak operasi gagal karena sejumlah kecil operasi yang salah. Selain itu, karena cara operasi BatchJob diproses, penyebab utama kegagalan mungkin muncul pada indeks sebelum atau setelah kegagalan hilir.

Misalnya, saat memproses respons dari ListBatchJobResults, Anda mungkin menemukan 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 pada indeks yang berbeda. Untuk mengidentifikasi penyebab utama masalah ini, sebaiknya ulangi semua pesan status di BatchJobResult—sebelum dan sesudah indeks pesan error Ad group is invalid—untuk mencari informasi error tambahan.