Strategi mutasi mengacu pada penggunaan
AdsApp.mutate untuk melakukan panggilan API
secara langsung, bukan mengandalkan objek khusus skrip Google Ads. Hal ini memiliki
manfaat yang memungkinkan Anda mengakses semua fitur API dengan lebih cepat, dan memiliki
hambatan yang lebih rendah untuk masuk jika Anda sudah memahami sintaksis API.
Membuat kampanye Performa Maksimal dengan mutate
Panduan ini mengasumsikan bahwa Anda membuat seluruh kampanye dalam satu permintaan atomik, bukan membuat setiap entitas dalam permintaan terpisah. Artinya, Anda harus menyiapkan dan menggunakan ID sementara untuk menautkan resource satu sama lain.
Setelah itu, buat array untuk menyimpan semua operasi:
const operations = [];
Anda akan sering memerlukan ID pelanggan untuk pelanggan yang Anda buatkan kampanye, karena ID ini diperlukan di setiap nama resource.
const customerId = AdsApp.currentAccount().getCustomerId();
Setiap kali ingin membuat resource baru, Anda akan menggunakan ID sementara berikutnya dalam nama resource, sehingga Anda dapat mereferensikan objek ini nanti, dan menyisipkan objek yang dibuat ke dalam array:
const newOperation = {
[OPERATION_TYPE_VARIES]: {
create: {
resourceName: `customers/${customerId}/[EXACT_PATH_VARIES]/${getNextTempId()}`
// Other fields, relevant to the resource being created.
}
}
}
operations.push(newOperation);
Anda dapat membaca informasi selengkapnya dan melihat contoh operasi di dokumentasi mutasi REST Google Ads API. Pelajari komponen wajib dan opsional kampanye Performa Maksimal, dan buat operasi untuk kebutuhan Anda.
Setelah membuat semua operasi, jalankan operasi tersebut dalam satu batch:
AdsApp.mutateAll(operations);