Skrip Google Ads memungkinkan Anda membuat perubahan massal pada akun dengan mengupload data dalam format CSV. Anda dapat mengupload data dari file CSV dari Google Drive, spreadsheet Google, spreadsheet Microsoft Excel, atau membuat permintaan upload massal dalam skrip Anda saat runtime. Panduan ini menjelaskan cara menggunakan fitur ini dalam skrip Anda.
Penggunaan
Dengan upload massal, Anda dapat melakukan jenis perubahan tertentu yang tidak akan langsung didukung oleh skrip Google Ads, seperti mengelola kampanye atau mengupload konversi offline.
Membuat upload massal dari Google Drive
Cara termudah untuk menggunakan fitur upload massal adalah dengan mengupload file CSV di Google Drive, dan mengupload file tersebut ke Google Ads menggunakan skrip Google Ads:
const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
.next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();
Tindakan ini akan membuat entri pratinjau upload massal di akun Anda di bagian Alat dan setelan > TINDAKAN MASSAL > Upload.
Klik link Pratinjau untuk melihat perubahan.
Untuk menerapkan perubahan ke akun Anda, klik tombol Terapkan perubahan di halaman detail. Jika terdapat error pada file yang diupload, atau jika Anda tidak ingin melakukan perubahan, klik tombol Hapus pratinjau untuk menghapus perubahan.
Setelah memverifikasi bahwa skrip Anda berfungsi dengan benar, Anda dapat melewati tahap pratinjau
dan menerapkan perubahan langsung dari skrip. Hal ini dapat dilakukan dengan
memanggil metode
apply()
dari instance upload massal, bukan metode
preview().
Membuat upload massal dari awal
Anda dapat membuat tugas upload massal dari awal sebagai berikut:
// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
"Campaign", "Budget", "Bid Strategy type", "Campaign type"
];
const upload = AdsApp.bulkUploads().newCsvUpload(columns);
// Call append once for each row you'd like to upload
upload.append({
"Campaign": "Test Campaign 1",
"Budget": 2.34,
"Bid Strategy type": "cpc",
"Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();
Menetapkan unit mata uang
Secara default, jumlah uang dalam upload massal ditafsirkan sebagai jumlah
mata uang yang sebenarnya. Jika lebih suka menggunakan mikro, Anda dapat menetapkan opsi moneyInMicros
ke true saat membuat tugas upload (misalnya, €2,34 akan dimasukkan sebagai 2340000).
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{moneyInMicros: true});
Menetapkan lokalitas file
Secara default, konten file CSV ditafsirkan dalam lokalitas bahasa Inggris AS (en_US).
Anda dapat menentukan lokalitas yang berbeda menggunakan opsi fileLocale, seperti ditunjukkan
di bawah ini:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Saat menentukan lokalitas, Anda dapat memberikan header kolom dalam lokalitas en_US atau dalam lokalitas yang Anda tentukan di properti fileLocale.
Setel zona waktu
Secara default, entri waktu dalam file ditafsirkan di America/Los_Angeles. Anda dapat
menentukan zona waktu yang berbeda menggunakan opsi timeZone. Tentukan zona waktu dalam format database TZ.
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{timeZone: "America/New_York"});
Menetapkan zona waktu dapat berguna saat mengupload konversi offline.
Template spreadsheet untuk upload massal
Cara termudah untuk mendapatkan template spreadsheet untuk upload massal adalah dari UI Google Ads.
- Login ke akun Google Ads.
- Buka Alat dan setelan > TINDAKAN BANYAK > Upload.
- Klik tombol + untuk memulai upload baru.
- Sebuah bagian kemudian muncul dengan berbagai {i>template<i} yang dapat dipilih.
Anda juga dapat mendownload berbagai template dari pusat bantuan.