Skrip Google Ads memungkinkan Anda melakukan perubahan massal pada akun dengan mengupload data dalam format CSV. Anda dapat mengupload data dari file CSV dari Google Drive, Google Spreadsheet, Microsoft Excel Spreadsheet, atau membuat permintaan upload massal dalam skrip saat runtime. Panduan ini menjelaskan cara menggunakan fitur ini dalam skrip Anda.
Penggunaan
Dengan menggunakan upload massal, Anda dapat melakukan jenis perubahan tertentu yang biasanya tidak didukung langsung oleh skrip Google Ads, seperti mengelola kampanye atau mengupload konversi offline.
Membuat upload massal dari Google Drive
Cara paling sederhana untuk menggunakan fitur upload massal adalah mengupload file CSV di Google Drive, lalu 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 pada akun Anda, klik tombol Terapkan perubahan di halaman detail. Jika file yang diupload memiliki error, atau jika Anda tidak ingin melakukan perubahan, klik tombol Buang pratinjau untuk membuang 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
apply()
metode 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 satuan moneter
Secara default, jumlah uang dalam upload massal ditafsirkan sebagai jumlah mata uang 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 lain menggunakan opsi fileLocale:
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 dalam properti fileLocale.
Menetapkan zona waktu
Secara default, entri waktu dalam file ditafsirkan dalam America/Los_Angeles.
Anda dapat menentukan zona waktu lain 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 MASSAL > Upload.
- Klik tombol + untuk memulai upload baru.
- Kemudian, bagian akan muncul dengan berbagai template yang dapat dipilih.
Anda juga dapat mendownload berbagai template dari pusat bantuan.