Skrip Google Ads memungkinkan Anda mengelola dan mendapatkan laporan tentang 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
objek
AdsApp
. Anda
dapat mengambilnya seperti yang biasa Anda lakukan saat 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 serupa:
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()
VideoAdGroup
.
Anda dapat membuat iklan video baru menggunakan metode
newVideoAd()
VideoAdGroup
.
Format iklan video
Format iklan video yang didukung berbeda menurut jenis kampanye video. Untuk memastikan Anda memilih jenis kampanye video yang tepat, tambahkan withCondition
panggilan 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 kampanye yang diinginkan:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
.get();
Kampanye video tanpa subjenis mendukung format iklan video berikut:
- TrueView dalam-aliran
- 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 lain, sehingga memberi pengguna opsi untuk melewati iklan setelah waktu yang ditentukan. Iklan video discovery muncul di Jaringan Display dan berbagai halaman YouTube, dan hanya akan diputar jika pengguna mengklik thumbnail iklan terlebih dahulu. Iklan bumper berdurasi 6 detik atau lebih pendek dan dapat muncul di video YouTube, atau di video pada situs dan aplikasi partner di Jaringan Display. Untuk mengetahui detail lengkap tentang setiap jenis iklan ini, lihat Tentang format iklan video.
Buat grup iklan
Anda membuat grup iklan video melalui metode
newVideoAdGroupBuilder()
kampanye video. Anda harus menentukan jenis grup iklan dan nama grup iklan saat membuat grup iklan. Jenis grup iklan harus salah satu dari berikut ini, dan tidak dapat diubah setelah grup iklan dibuat:
VIDEO_BUMPER
VIDEO_EFFICIENT_REACH
VIDEO_NON_SKIPPABLE_IN_STREAM
(hanya untuk kampanyeVIDEO_NON_SKIPPABLE
)VIDEO_RESPONSIVE
(hanya untuk kampanyeVIDEO_ACTION
)VIDEO_TRUE_VIEW_IN_DISPLAY
VIDEO_TRUE_VIEW_IN_STREAM
YOUTUBE_AUDIO
Contoh:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("VIDEO_TRUE_VIEW_IN_STREAM")
.withName("Video Ad Group")
.build()
.getResult();
Buat aset video
Iklan video umumnya perlu mereferensikan aset video. Hal ini menentukan video mana yang akan diputar untuk iklan. Anda tidak dapat mengupload video menggunakan skrip, tetapi Anda dapat menautkan video YouTube yang sudah ada yang sebelumnya Anda upload untuk digunakan dalam iklan.
Anda dapat 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 builder yang cocok dengan jenis grup iklan
(dirangkai setelah newVideoAd()
):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(khusus untuk kampanyeVIDEO_ACTION
)nonSkippableAdBuilder()
(khusus untuk kampanyeVIDEO_NON_SKIPPABLE
)
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 penargetan apa pun yang dilakukan di tingkat akun untuk kampanye video secara umum, dan diakses menggunakan AdsApp.videoCampaignTargeting()
. Setelan ini tidak dapat diubah melalui skrip, tetapi dapat dilihat.
Jenis penargetan lainnya memungkinkan Anda menentukan kriteria untuk kampanye video
dan grup iklan video secara terpisah. Hal ini dapat diakses dengan metode
videoTargeting()
di 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 mencakup
kumpulan kriteria yang berbeda dari AdsApp.videoCampaignTargeting()
. Seperti
VideoCampaignTargeting
, Anda tidak dapat mengelola kriteria ini dengan skrip.
Berikut contoh untuk mengecualikan penempatan tertentu dalam kampanye:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
Kriteria untuk demografi (usia, gender) berfungsi 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 menargetkan semuanya. Anda dapat mengecualikan demografi dengan mengambil penargetan yang ada dan memanggil metode exclude()
di dalamnya, dan Anda dapat menyertakan kembali demografi yang dikecualikan dengan menemukan penargetan pengecualian yang ada dan memanggil include()
.
Berikut contoh cara mengecualikan gender tertentu dari grup iklan:
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}