Skrip Google Ads memungkinkan Anda mengelola dan melaporkan Video berbasis YouTube kampanye. 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
videoCampaigns
koleksi dari
Objek AdsApp
. Anda
dapat mengambilnya seperti yang biasa Anda ambil 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 dapat memperoleh 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
videoAds()
dari
VideoAdGroup
.
Anda dapat membuat iklan video baru menggunakan
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 telepon withCondition
pada AdvertisingChannelSubType
.
Beberapa kampanye video memiliki subjenis yang membatasi jenis iklan
yang didukung dalam kampanye tersebut. Secara khusus, hanya VIDEO_ACTION
kampanye
mendukung jenis iklan VIDEO_RESPONSIVE
dan VIDEO_NON_SKIPPABLE
kampanye
hanya mendukung jenis iklan NON_SKIPPABLE_INSTREAM_VIDEO_AD
.
Cara terbaik untuk beroperasi pada jenis kampanye tertentu adalah menggunakan
Klausa withCondition
dalam 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 lain, pengguna opsi untuk melewati setelah waktu tertentu. Iklan video discovery muncul di Jaringan Display dan berbagai halaman YouTube dan hanya akan diputar jika pengguna aktif mengklik thumbnail iklan terlebih dahulu. Iklan bumper berdurasi 6 detik atau lebih singkat serta dapat muncul di video YouTube, atau di video pada situs dan aplikasi partner di Jaringan Display. Untuk detail selengkapnya tentang setiap jenis iklan ini, lihat Tentang format iklan video lainnya.
Buat grup iklan
Anda membuat grup iklan video melalui
newVideoAdGroupBuilder()
kampanye video. Anda perlu menentukan jenis grup iklan dan iklan
saat membuat grup iklan. Jenis grup iklan harus salah satu dari
berikut, 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 harus mereferensikan aset video. Ini menentukan video mana
yang akan diputar untuk iklan. Anda tidak dapat mengupload video menggunakan skrip, tetapi Anda dapat
menautkan video YouTube yang ada yang sebelumnya Anda upload untuk digunakan dalam iklan.
Anda melakukan ini 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();
Membuat 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 berbeda untuk kampanye video. Tujuan
VideoCampaignTargeting
mewakili penargetan yang dilakukan di tingkat akun untuk kampanye video
secara umum, dan diakses menggunakan AdsApp.videoCampaignTargeting()
. Ini
tidak dapat dimodifikasi melalui skrip, tetapi dapat dilihat.
Jenis penargetan lainnya memungkinkan Anda menentukan kriteria untuk kampanye video
grup iklan video satu per satu. Fitur ini dapat diakses dengan
videoTargeting()
pada kampanye atau grup iklan, dan memberikan akses ke
pemilih dan builder untuk kriteria positif dan negatif untuk semua jenis
berlaku untuk tingkat penargetan tersebut. Tujuan
AdsApp.videoTargeting()
juga tersedia untuk melihat kriteria di tingkat akun, dan menyertakan
kumpulan kriteria yang berbeda dari AdsApp.videoCampaignTargeting()
. Suka
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 untuk demografi (usia, gender) sedikit berbeda
jenis kriteria lain. Saat grup iklan baru dibuat, kriteria untuk setiap grup iklan
nilai usia dan gender yang mungkin dibuat secara otomatis, dan grup iklan tersebut
menargetkan semuanya. Anda dapat mengecualikan demografi dengan mengambil
penargetan dan memanggil metode exclude()
di dalamnya, dan Anda dapat menyertakan kembali
demografi yang dikecualikan dengan menemukan penargetan pengecualian yang ada dan
include()
.
Berikut adalah contoh untuk 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();
}