Pemrosesan batch menyediakan cara untuk mengirimkan sekumpulan operasi, yang mungkin saling bergantung, ke beberapa layanan tanpa menunggu operasi selesai secara serentak. Anda dapat menggunakan pemrosesan batch untuk membuat dan mengelola kampanye Performa Maksimal.
Panduan ini memberikan detail khusus untuk kampanye Performa Maksimal saat menggunakan pemrosesan batch. Panduan pemrosesan batch generik memberikan informasi umum tentang pemrosesan batch, dan Panduan permintaan struktur berisi informasi mendetail tentang cara membuat permintaan untuk membuat atau mengelola kampanye Performa Maksimal.
Untuk membuat kampanye Performa Maksimal menggunakan pemrosesan batch, ikuti langkah-langkah berikut:
Membuat tugas batch baru
Ikuti langkah pembuatan tugas pemrosesan batch umum untuk membuat resource
BatchJob.
Menyiapkan daftar operasi mutasi
Kampanye Performa Maksimal memerlukan operasi untuk membuat beberapa resource terkait, yang dijelaskan dalam
Panduan permintaan struktur. Buat
MutateOperation untuk setiap resource yang harus
disertakan dalam tugas batch.
Persyaratan CampaignOperation dan CampaignAssetOperation
Jika pedoman merek diaktifkan untuk kampanye (lihat
pedoman merek), Anda harus menautkan
aset merek ke kampanye menggunakan CampaignAsset
aset. Selain itu, dalam tugas batch, pembuatan CampaignAsset
resource ini harus terjadi segera setelah pembuatan resource Campaign
itu sendiri. Jika resource CampaignAsset tidak dibuat segera
setelah resource Campaign (jika pedoman merek diaktifkan - lihat
pemecahan masalah),
permintaan akan gagal dan menampilkan CampaignError yang menunjukkan aset tidak ada.
Menyertakan operasi pembuatan CampaignAsset di lain waktu dalam daftar operasi yang sama tidak akan mencegah error ini.
Persyaratan AssetGroupOperation dan AssetGroupAssetOperation
Operasi jenis MutateOperation yang
membuat resource AssetGroup dan
AssetGroupAsset dalam tugas batch harus
berurutan tanpa operasi lain di antaranya karena cara pengelompokan
operasi ini saat diproses. Jika tidak, permintaan akan menampilkan
AssetGroupError yang menunjukkan bahwa beberapa aset tidak ada,
meskipun operasi yang diperlukan untuk
memenuhi persyaratan aset minimum disertakan nanti
dalam daftar operasi.
AssetGroupListingGroupFilterOperation praktik terbaik
Saat bekerja dengan filter grup listingan dalam konteks
AssetGroupListingGroupFilter, sebaiknya
tambahkan
operasi AssetGroupListingGroupFilterOperation
yang menargetkan AssetGroup yang sama ke
pekerjaan batch secara berurutan, sehingga serangkaian operasi diperlakukan secara atomik
selama pemisahan batch. Untuk membaca selengkapnya tentang pemisahan batch dan faktor lain yang memengaruhi grup listingan, lihat panduan pemrosesan batch grup listingan.
Tambahkan operasi perubahan ke tugas
Tambahkan operasi mutasi dari Langkah 2 ke daftar dan panggil
AddBatchJobOperations
untuk menambahkan daftar mutasi ke tugas batch yang dibuat di Langkah 1.
Ikuti langkah operasi penambahan
dalam panduan pemrosesan batch umum untuk menambahkan daftar operasi perubahan.
Menjalankan tugas batch
Izinkan tugas yang diupload mulai berjalan dengan memanggil
RunBatchJob. Lihat langkah
Jalankan tugas batch
dalam panduan pemrosesan batch umum untuk melihat contohnya.
Mengambil status tugas
Tugas batch dimulai sebagai operasi yang berjalan lama dan biasanya memerlukan waktu untuk diselesaikan.
Setelah memulai tugas, gunakan metode
GetOperation
operasi yang berjalan lama untuk melakukan polling status tugas
hingga selesai.
Setelah semua tugas batch Anda selesai, panggil
ListBatchJobResults untuk
mencetak status dan responsnya dengan mengikuti
langkah mencantumkan semua hasil tugas batch dalam
panduan pemrosesan batch umum.