Cara terbaik untuk mengelola kampanye Performa Maksimal dengan skrip Google Ads adalah menggunakan
strategi mutasi untuk memberikan pengelolaan langsung
kampanye Performa Maksimal Anda. Kampanye Performa Maksimal hanya dapat dibuat
dengan fungsi mutate. Namun, Anda juga dapat menggunakan objek AdsApp lain untuk
mengambil kampanye Performa Maksimal, mengelola grup aset, dan menjalankan laporan jika
Anda mau.
Pengambilan kampanye Performa Maksimal
Kampanye Performa Maksimal tersedia melalui
koleksi performanceMaxCampaigns dari objek AdsApp. Anda dapat
mengambilnya seperti biasa:
const campaignName = "My Performance Max campaign";
const campaignIterator = AdsApp.performanceMaxCampaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
for (const campaign of campaignIterator) {
...
}
Tidak seperti beberapa jenis kampanye lainnya, kampanye Performa Maksimal tidak memiliki grup iklan atau objek iklan yang dapat Anda lihat; semua hal yang terkait dengan konsep ini untuk kampanye lain akan ditangani secara otomatis berdasarkan grup aset yang Anda tetapkan.
Aset dan grup aset
Iklan dari kampanye Performa Maksimal dijalankan dari aset seperti video, gambar, judul, dan deskripsi—baik yang disediakan oleh Anda maupun yang dibuat secara otomatis. Untuk ringkasan lengkap tentang jenis aset yang diperlukan, lihat panduan aset Performa Maksimal Google Ads API.
Aset untuk kampanye Performa Maksimal digabungkan menjadi satu grup aset, dan setiap kampanye Performa Maksimal harus memiliki minimal satu grup aset. Anda tidak dapat membuat grup aset ini secara langsung di skrip, tetapi Anda dapat menambahkan dan menghapus aset dari grup aset yang ada.
Menambahkan aset ke grup aset
Pertama, buat aset:
const imageUrl = "http://www.example.com/example.png";
const imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
const assetOperation = AdsApp.adAssets().newImageAssetBuilder()
.withName("new asset name")
.withData(imageBlob)
.build();
const imageAsset = assetOperation.getResult();
Kemudian, tambahkan aset yang baru saja Anda buat ke grup aset yang ada:
// First, fetch the Performance Max campaign we want to operate on.
const campaignIterator = AdsApp.performanceMaxCampaigns()
.withCondition(`campaign.name = '${campaignName}'`)
.get();
let campaign;
if (campaignIterator.hasNext()) {
campaign = campaignIterator.next();
} else {
throw `No campaign found with name ${campaignName}.`
}
// Then, get that campaign's asset groups.
const assetGroupIterator = campaign.assetGroups().get();
// The campaign must have at least one asset group, so we can just assume so here.
const assetGroup = assetGroupIterator.next();
// Add the asset from the previous step.
assetGroup.addAsset(imageAsset, 'MARKETING_IMAGE');
Perhatikan bahwa Anda harus menentukan jenis aset di langkah terakhir. Anda dapat menemukan daftar lengkap jenis aset di dokumentasi Google Ads API
Untuk menggunakan aset yang ada, buat pemilih aset terlebih dahulu:
const assetSelector = AdsApp.adAssets().assets();
Kemudian, gunakan filter withCondition untuk mempersempit ke aset yang ingin Anda operasikan. Lihat AssetSelector untuk mengetahui daftar lengkap opsi filter.
Terakhir, ambil iterator dan lakukan iterasi seperti pada entity lainnya:
const assetIterator = assetSelector.get();
for (const asset of assetIterator) {
...
}
Aset teks
Aset teks berfungsi sedikit berbeda, karena Anda tidak perlu membuat aset terlebih dahulu. Anda cukup menentukan teks, bukan aset, dan sistem akan membuat aset untuk Anda secara otomatis. Jika teks tersebut merupakan duplikat persis dari aset teks yang ada, aset yang ada akan digunakan kembali.
Misalnya, berikut cara membuat aset judul:
assetGroup.addAsset('asset text here', 'HEADLINE');
Menghapus aset dari grup aset
Anda juga dapat menghapus aset dari grup aset. Namun, perlu diingat bahwa setiap grup aset harus memiliki jumlah minimum jenis aset tertentu agar kampanye valid.
Berikut cara menghapus aset yang ditambahkan dalam contoh sebelumnya:
assetGroup.removeAsset(imageAsset, 'MARKETING_IMAGE');
Anda juga bisa mendapatkan daftar aset dalam grup aset tertentu dengan fungsi search:
// The resource name is a unique identifier for this asset group.
const assetGroupName = assetGroup.getResourceName();
results = AdsApp.search(
`SELECT asset.resource_name, asset_group_asset.field_type
FROM asset_group_asset
WHERE asset_group.resource_name = '${assetGroupName}'`
);
Tindakan ini akan memilih nama resource aset sebagai ID uniknya. Anda juga dapat memilih kolom lain, seperti asset.type atau asset.text_asset.text, untuk lebih menyaring hasil. Gunakan pembuat kueri untuk jenis laporan ini
untuk membuat kueri Anda sendiri.
Setelah Anda memiliki aset target, panggil remove di grup aset untuk menghapus
aset dari grup aset:
// This example assumes at least one asset is returned. We'll remove the first
// asset, whatever it is. In your code, customize this to choose the right
// asset to be removed.
const row_info = results.next().asset;
assetGroup.remove(row_info.asset.resource_name, row_info.asset_group_asset.field_type);