Filter grup listingan dalam tugas batch

Saat Anda menggunakan filter grup listingan dalam konteks AdGroupCriterion.listing_group atau AssetGroupListingGroupFilter, pertimbangkan hal berikut saat merancang integrasi Anda.

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

Pertimbangkan cara pengelompokan operasi:

  • 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 parsial).

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 merepresentasikan sub-batch 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. 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 grup listingan dalam tugas batch diproses sebagai satu transaksi, yang dapat menyebabkan banyak operasi gagal karena sejumlah kecil operasi yang salah. Selain itu, karena cara pemrosesan operasi BatchJob, akar penyebab kegagalan dapat 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 akar penyebab masalah, sebaiknya ulangi semua pesan status di BatchJobResult—sebelum dan setelah indeks pesan error Ad group is invalid—dalam penelusuran informasi error tambahan.