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

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, 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 pada Alat dan setelan > TINDAKAN BANYAK > File yang diupload.

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 membuat perubahan, klik tombol Hapus pratinjau untuk menghapus perubahan.

Setelah memverifikasi 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().

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();

Tetapkan unit uang

Secara default, jumlah uang dalam upload massal ditafsirkan sebagai jumlah mata uang yang sebenarnya. Jika lebih suka menggunakan mikro, Anda dapat menyetel moneyInMicros ke true saat membuat tugas upload (misalnya, €2,34 akan menjadi 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 akan 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 Tools and settings > TINDAKAN BANYAK > File yang diupload.
  • Klik tombol + untuk memulai upload baru.
  • Kemudian, akan muncul bagian dengan berbagai template yang dapat dipilih.

Anda juga dapat mengunduh berbagai template dari laman bantuan tengah.