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 untuk skrip saat runtime. Panduan ini menjelaskan cara menggunakan fitur ini dalam skrip Anda.
Penggunaan
Dengan upload massal, Anda dapat membuat jenis perubahan tertentu yang tidak secara langsung didukung oleh skrip Google Ads, seperti mengelola kampanye atau mengupload konversi offline.
Buat upload massal dari Google Drive
Cara termudah untuk menggunakan fitur upload massal adalah dengan 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 BANYAK > Upload.
Klik link Pratinjau untuk melihat perubahan.
Untuk menerapkan perubahan pada akun Anda, klik tombol Terapkan perubahan di halaman detail. Jika file yang diupload mengalami error, atau jika Anda tidak ingin melakukan perubahan, klik tombol Hapus pratinjau untuk menghapus perubahan.
Setelah memastikan bahwa skrip 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().
Buat upload massal dari awal
Anda dapat membuat tugas upload massal dari awal seperti 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();
Tetapkan satuan uang
Secara default, jumlah uang dalam upload massal diinterpretasikan 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 Inggris AS (en_US).
Anda dapat menentukan lokalitas yang berbeda menggunakan opsi fileLocale, seperti yang ditunjukkan
di bawah ini:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Saat menentukan lokalitas, Anda dapat menyediakan header kolom dalam lokal en_US
atau lokal yang Anda tetapkan dalam properti fileLocale.
Setel zona waktu
Secara {i>default<i}, entri waktu dalam {i>file<i} diinterpretasikan 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.
- Kemudian, bagian tersebut akan muncul dengan berbagai template yang dapat dipilih.
Anda juga dapat mendownload berbagai template dari pusat bantuan.