Skrip Google Ads memungkinkan Anda mengelola dan melaporkan kampanye Video berbasis YouTube. Anda dapat menggunakan skrip untuk mengelola kampanye video yang ada, membuat dan mengelola grup iklan dan iklan, menyiapkan penargetan untuk kampanye, dan menjalankan laporan. Namun, Anda tidak dapat menggunakan skrip untuk membuat kampanye video.
Mengambil kampanye dan grup iklan video
Kampanye Video tersedia melalui koleksi videoCampaigns
dari objek AdsApp
. Anda dapat mengambilnya seperti biasa mengambil kampanye dalam skrip:
const campaignName = "My first video campaign";
const campaignIterator = AdsApp.videoCampaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
for (const campaign of campaignIterator) {
...
}
Setelah mengambil kampanye, Anda bisa mendapatkan grup iklannya dengan cara yang sama:
const adGroupIterator = campaign.videoAdGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
Atau, Anda dapat menggunakan metode AdsApp.videoAdGroups()
:
const adGroupIterator = AdsApp.videoAdGroups()
.withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
.get();
for (const adGroup of adGroupIterator) {
...
}
Membuat iklan video
Skrip Google Ads memungkinkan Anda mengambil iklan video menggunakan metode
videoAds()
dari
VideoAdGroup
.
Anda dapat membuat iklan video baru menggunakan metode
newVideoAd()
dari VideoAdGroup
.
Format iklan video
Format iklan video yang didukung berbeda-beda berdasarkan jenis kampanye Video. Untuk memastikan Anda memilih jenis kampanye video yang tepat, tambahkan panggilan withCondition
di AdvertisingChannelSubType
.
Beberapa kampanye video memiliki subjenis yang membatasi jenis iklan yang
didukung dalam kampanye tersebut. Secara khusus, kampanye VIDEO_ACTION
hanya
mendukung jenis iklan VIDEO_RESPONSIVE
, dan kampanye VIDEO_NON_SKIPPABLE
hanya mendukung jenis iklan NON_SKIPPABLE_INSTREAM_VIDEO_AD
.
Cara terbaik untuk beroperasi pada jenis kampanye tertentu adalah dengan menggunakan klausa withCondition
di pemilih Anda. Anda dapat memperbarui AdvertisingChannelSubType
untuk jenis minat kampanye:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
.get();
Kampanye Video tanpa subjenis mendukung format iklan video berikut:
- TrueView in-stream
- Video discovery TrueView
- Bumper
Anda dapat memilih kampanye ini menggunakan withCondition
:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = null")
.get();
Iklan video in-stream dapat diputar sebelum, selama, atau setelah video lainnya, sehingga pengguna dapat melewatinya setelah waktu tertentu. Iklan video discovery muncul di Jaringan Display dan berbagai halaman YouTube, dan hanya akan diputar jika pengguna secara aktif mengklik thumbnail iklan terlebih dahulu. Iklan bumper berdurasi 6 detik atau lebih pendek dan dapat muncul di video YouTube, atau di video di aplikasi dan situs partner di Display Network. Untuk detail selengkapnya tentang setiap jenis iklan ini, lihat Tentang format iklan video.
Buat grup iklan
Anda membuat grup iklan video melalui metode
newVideoAdGroupBuilder()
dari kampanye video. Anda harus menentukan jenis grup iklan dan nama
grup iklan saat membuat grup iklan. Jenis grup iklan harus berupa salah satu dari
yang berikut ini, dan tidak dapat diubah setelah grup iklan dibuat:
TRUE_VIEW_IN_STREAM
TRUE_VIEW_IN_DISPLAY
BUMPER
VIDEO_RESPONSIVE
(hanya untukVIDEO_ACTION
kampanye)NON_SKIPPABLE_INSTREAM_VIDEO_AD
(hanya untukVIDEO_NON_SKIPPABLE
kampanye)
Contoh:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("TRUE_VIEW_IN_STREAM")
.withName("Video Ad Group")
.build()
.getResult();
Membuat aset video
Iklan video umumnya perlu mereferensikan aset video. Proses ini menentukan video
yang akan diputar untuk iklan. Anda tidak dapat mengupload video menggunakan skrip, tetapi dapat menautkan video YouTube yang sudah ada dan telah diupload sebelumnya untuk digunakan dalam iklan Anda.
Anda melakukannya dengan membuat
Asset
dengan
YouTubeVideoAssetBuilder
.
const assetOperation = AdsApp.adAsset().newYouTubeVideoAssetBuilder()
.withName("name")
// This is the ID in the URL for the YouTube video.
.withYouTubeVideoId(youTubeVideoId)
.build();
const videoAsset = assetOperation.getResult();
Buat iklan
Untuk membuat iklan baru, gunakan metode pembuat yang cocok dengan jenis grup iklan
(dirantai setelah newVideoAd()
):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(hanya untukVIDEO_ACTION
kampanye)nonSkippableAdBuilder()
(hanya untukVIDEO_NON_SKIPPABLE
kampanye)
Contoh:
const videoAd = videoAdGroup.newVideoAd()
.inStreamAdBuilder()
.withAdName("Video Ad")
.withFinalUrl(
"http://www.example.com/video-ad")
// Specify the video asset created in the last step.
.withVideo(video)
.build()
.getResult();
Penargetan video
Ada dua jenis penargetan yang relevan untuk kampanye video. VideoCampaignTargeting
mewakili semua penargetan yang dilakukan di tingkat akun untuk kampanye video
secara umum, dan diakses menggunakan AdsApp.videoCampaignTargeting()
. Format ini tidak dapat diubah melalui skrip, tetapi dapat dilihat.
Jenis penargetan lainnya memungkinkan Anda menentukan kriteria untuk kampanye video
dan grup iklan video satu per satu. Fitur ini dapat diakses dengan
metode videoTargeting()
pada kampanye atau grup iklan, dan memberikan akses ke
pemilih dan pembuat untuk kriteria positif dan negatif untuk semua jenis
yang berlaku untuk tingkat penargetan tersebut. Metode
AdsApp.videoTargeting()
juga ada untuk melihat kriteria di tingkat akun, dan menyertakan
kumpulan kriteria yang berbeda dari AdsApp.videoCampaignTargeting()
. Seperti
VideoCampaignTargeting
, Anda tidak dapat mengelola kriteria ini dengan skrip.
Berikut adalah contoh untuk mengecualikan penempatan tertentu dalam kampanye:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
Cara kerja kriteria demografi (usia, gender) sedikit berbeda dengan
jenis kriteria lainnya. Saat grup iklan baru dibuat, kriteria untuk setiap kemungkinan nilai usia dan gender akan dibuat secara otomatis, dan grup iklan tersebut akan menargetkan semuanya. Anda dapat mengecualikan demografi dengan mengambil penargetan yang ada dan memanggil metode exclude()
, lalu menyertakan kembali demografi yang dikecualikan dengan mencari penargetan pengecualian yang ada dan memanggil include()
.
Berikut ini contoh untuk mengecualikan jenis kelamin tertentu dari grup iklan:
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}