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

Poin Penting: Sebaiknya tambahkan operasi AssetGroupListingGroupFilterOperation yang menargetkan AssetGroup yang sama, dan operasi AdGroupCriterionOperation 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 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 filter grup listingan menargetkan
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 penargetan listing_group AdGroup yang sama dikelompokkan bersama dalam sub-batch atomik (tanpa perilaku kegagalan sebagian).
• Semua operasi berurutan lainnya dikelompokkan bersama dalam sub-batch non-atomik (perilaku kegagalan parsial).

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

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.

Atomisitas dalam Pemisahan Batch

Google Ads API dapat membagi operasi dalam tugas batch yang dikirimkan menjadi sub-batch yang lebih kecil untuk diproses. Jika Anda tidak mengelompokkan operasi terkait, seperti modifikasi grup listingan dalam AssetGroup dan AdGroup, secara berurutan dalam tugas batch, Google Ads API mungkin membagi operasi ini menjadi sub-batch yang berbeda. Pemisahan ini dapat menyebabkan seluruh modifikasi gagal, atau membuat akun dalam keadaan tidak konsisten.

Pengelompokan Logis

AssetGroupListingGroupFilterOperation mengelola grup listingan dalam AssetGroup, yang umum dalam kampanye Performa Maksimal. AdGroupCriterionOperation mengelola grup listingan dalam AdGroup, yang umum dalam kampanye Shopping standar. Keduanya digunakan untuk menentukan penargetan produk. Jika Anda membuat perubahan yang memengaruhi hierarki penargetan produk di kedua konteks, kelompokkan operasi ini secara berurutan dalam tugas batch untuk memastikan operasi tersebut diterapkan bersama-sama.

Konsistensi Data

Untuk menjaga konsistensi data dan mencegah update sebagian, tambahkan operasi grup listingan terkait secara berurutan ke tugas batch Anda. Pengurutan ini membantu mengelompokkannya ke dalam sub-batch atomik berdasarkan logika pemisahan batch API, yang mencegah akun Anda berada dalam status yang tidak konsisten.

Batasan

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

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