大量上傳

Google Ads 指令碼可讓您以 CSV 格式上傳資料,對帳戶進行大量變更。您可以從 Google 雲端硬碟、Google 試算表或 Microsoft Excel 試算表上傳 CSV 檔案的資料,也可以在執行階段透過指令碼建立大量上傳要求。本指南說明如何在指令碼中使用此功能。

使用方式

這樣一來,您就能進行 Google Ads 指令碼無法直接支援的某些變更,例如管理廣告活動或上傳離線轉換資料。

透過 Google 雲端硬碟建立大量上傳

如要使用大量上傳功能,最簡單的方法是在 Google 雲端硬碟中上傳 CSV 檔案,然後使用 Google Ads 指令碼將檔案上傳至 Google Ads:

const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

這個步驟會在帳戶的「工具與設定」>「大量動作」>「上傳」下建立大量上傳預覽項目。

按一下「預覽」連結即可查看變更。

如要將變更套用至帳戶,請按一下詳細資料頁面上的「Apply changes」按鈕。如果上傳的檔案有誤,或是您不想進行變更,請按一下「捨棄預覽」按鈕來捨棄變更。

確認指令碼能正常運作後,您就可以略過預覽階段,並直接從指令碼套用變更。方法是呼叫大量上傳例項的 apply() 方法,而非 preview() 方法。

從頭開始建立大量上傳

您可以從頭開始建立大量上傳工作,方法如下:

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

設定金額單位

根據預設,大量上傳的金額會解讀為實際貨幣金額。如果您偏好使用微量,可以在建立上傳工作時,將 moneyInMicros 選項設為 true (例如,€2.34 將輸入為 2340000)。

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

設定檔案語言代碼

根據預設,CSV 檔案內容會以美式英文語言代碼 (en_US) 解譯。您可以使用 fileLocale 選項指定不同的語言代碼,如下所示:

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

指定語言代碼時,您可以使用 en_US 語言代碼或 fileLocale 屬性中指定的語言代碼提供欄標題。

設定時區

根據預設,檔案中的時間會解讀為 America/Los_Angeles。您可以使用 timeZone 選項指定其他時區。請使用 TZ 資料庫格式指定時區。

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

設定時區有助於上傳離線轉換資料。

大量上傳的試算表範本

如要取得大量上傳的試算表範本,最簡單的方法是透過 Google Ads UI。

  • 登入 Google Ads 帳戶。
  • 依序前往「工具與設定」>「大量動作」>「上傳」
  • 按一下「+」+按鈕即可啟動新的上傳作業。
  • 隨即顯示的區段會列出多種範本可供選擇。

您也可以前往說明中心下載許多不同的範本。