Upload File Besar

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 saat runtime. Panduan ini menjelaskan cara menggunakan fitur ini dalam skrip Anda.

Penggunaan

Dengan menggunakan upload massal, Anda dapat melakukan jenis perubahan tertentu yang tidak didukung secara 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 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 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 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 satuan moneter

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 US English (en_US). Anda dapat menentukan lokalitas yang berbeda 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 di properti fileLocale.

Setel zona waktu

Secara default, entri waktu dalam file ditafsirkan dalam zona waktu 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 Anda.
  • Buka Alat dan setelan > TINDAKAN MASSAL > Upload.
  • Klik tombol + untuk memulai upload baru.
  • Kemudian, bagian yang berisi berbagai template akan muncul untuk dipilih.

Anda juga dapat mendownload berbagai template dari pusat bantuan.