素材資源

建立需求開發廣告活動前,請務必先匯入廣告活動中使用的所有素材資源。您隨時可以返回並稍後新增素材資源,但您需要一組素材資源才能開始。

規劃廣告活動時,請參閱需求開發素材資源規格和最佳做法指南

圖片和影片素材資源是主要資產類型,本指南將說明如何上傳這兩種素材資源。這些原則也適用於其他類型的資產。無論要製作哪種素材資源,都請使用 AssetOperation 建立。

您可以使用 AdsApp 建立素材資源,不必使用變動,但為了保持一致性,本指南會採用與其他所有作業相同的方式。請注意,如果已有可用的素材資源,可以且應該重複使用。因此,雖然您必須有素材資源才能建立需求開發廣告活動,但可能不一定需要建立素材資源,才能完成廣告活動建立程序。

圖片素材資源

圖片素材資源會以 Base64 編碼格式上傳。由於您無法直接將圖片上傳至 Google Ads 指令碼,因此有兩種不同的方法可取得圖片資料並編碼,以利上傳。

如要從 Google 雲端硬碟擷取圖片,請先取得圖片的 ID,這是識別圖片的最佳方式。如要取得 ID,其中一種方法是從 Google 雲端硬碟 UI 複製可共用連結,然後擷取 ID。您也可以透過程式輔助擷取一系列檔案,然後選取要上傳的檔案。這段程式碼示範如何上傳具有已知 ID 的單一圖片:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}

或者,您也可以使用 UrlFetchApp,透過網址擷取網路伺服器上代管的圖片:

const file = UrlFetchApp.fetch(imageUrl);

接著,您就可以像處理雲端硬碟檔案一樣,對這個檔案呼叫 getBlob,因此作業建構步驟與 Google 雲端硬碟檔案相同。

影片素材資源

使用影片素材資源最簡單的方法是透過 YouTube 影片。如果您在建立廣告活動時上傳素材資源,請使用暫時 ID。否則,請記下傳回的資源名稱,以便在日後的作業中參照該素材資源,並將其新增至素材資源群組。

const videoAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing video",
      "type": "YOUTUBE_VIDEO",
      "youtube_video_asset": {
        "youtube_video_title": "Demand Gen video",
        "youtube_video_id": "123456789"
      }
    }
  }
}
operations.push(videoAsset);