Aset

Sebelum membuat kampanye Performa Maksimal, Anda harus mengimpor semua aset yang ingin digunakan dalam kampanye. Anda dapat kembali dan menambahkan aset nanti, tetapi Anda memerlukan serangkaian aset untuk memulai.

Baca artikel tentang aset dan persyaratan aset untuk kampanye Performa Maksimal saat merencanakan kampanye.

Karena aset teks dan aset gambar adalah jenis aset utama yang diperlukan, panduan ini akan menunjukkan cara mengupload setiap aset tersebut. Prinsip ini juga dapat diperluas ke jenis aset lainnya. Apa pun jenis aset yang Anda buat, gunakan AssetOperation untuk membuatnya.

Aset dapat dibuat menggunakan AdsApp tanpa menggunakan mutasi, tetapi demi konsistensi, panduan ini melakukannya dengan cara yang sama seperti semua operasi lainnya. Perhatikan bahwa Anda dapat dan harus menggunakan kembali aset yang ada jika sudah tersedia. Jadi, meskipun Anda harus memiliki aset untuk membuat kampanye Performa Maksimal, Anda mungkin tidak perlu membuat aset tersebut sebagai bagian dari proses pembuatan kampanye.

Aset teks

Aset teks berfungsi seperti operasi lainnya. Jika Anda mengupload aset sebagai bagian dari proses pembuatan kampanye, gunakan ID sementara. Jika tidak, catat nama resource yang ditampilkan untuk digunakan dalam operasi mendatang saat Anda perlu mereferensikan aset untuk menambahkannya ke grup aset.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

Aset gambar

Aset gambar diupload dalam format yang dienkode base-64. Karena Anda tidak dapat mengupload gambar langsung ke skrip Google Ads, Anda memiliki dua pendekatan berbeda untuk mendapatkan data gambar dan mengenkodenya untuk diupload.

Untuk mengambil gambar dari Google Drive, Anda memerlukan ID-nya terlebih dahulu, yang merupakan cara terbaik untuk mengidentifikasi gambar secara unik. Salah satu cara untuk mendapatkan ID adalah dengan menyalin link yang dapat dibagikan dari UI Google Drive dan mengekstrak ID. Anda juga dapat mengambil serangkaian file secara terprogram dan memilih file yang ingin diupload. Kode ini menunjukkan cara mengupload satu gambar dengan ID yang diketahui:

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

Atau, Anda dapat mengambil gambar yang dihosting di server web berdasarkan URL-nya menggunakan UrlFetchApp:

const file = UrlFetchApp.fetch(imageUrl);

Kemudian, Anda dapat memanggil getBlob pada file ini seperti yang Anda lakukan dengan file Drive, sehingga konstruksi operasi identik dengan langkah-langkah untuk file Google Drive.