Google Ads komut dosyaları, YouTube'a dayalı video kampanyalarınızı yönetmenize ve bu kampanyalarla ilgili rapor oluşturmanıza olanak tanır. Mevcut video kampanyalarını yönetmek, reklam grupları ve reklamlar oluşturup yönetmek, kampanyalar için hedefleme ayarlamak ve rapor çalıştırmak üzere komut dosyalarını kullanabilirsiniz. Ancak video kampanyaları oluşturmak için komut dosyalarını kullanamazsınız.
Video kampanyalarını ve reklam gruplarını alma
Video kampanyaları, videoCampaigns
AdsApp
nesnesinin toplanmasıyla kullanılabilir. Bunları, komut dosyalarındaki kampanyaları normalde aldığınız gibi alabilirsiniz:
const campaignName = "My first video campaign";
const campaignIterator = AdsApp.videoCampaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
for (const campaign of campaignIterator) {
...
}
Bir kampanyayı aldıktan sonra reklam gruplarını da benzer şekilde alabilirsiniz:
const adGroupIterator = campaign.videoAdGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
Alternatif olarak AdsApp.videoAdGroups()
yöntemini kullanabilirsiniz:
const adGroupIterator = AdsApp.videoAdGroups()
.withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
.get();
for (const adGroup of adGroupIterator) {
...
}
Video reklam oluşturma
Google Ads komut dosyaları, videoAds()
yöntemini kullanarak video reklamlarınızı almanıza olanak tanır.
VideoAdGroup
.
newVideoAd()
VideoAdGroup
yöntemini kullanarak yeni video reklamlar oluşturabilirsiniz.
Video reklam biçimleri
Desteklenen video reklam biçimleri, video kampanyasının türüne göre değişir. Doğru türde bir video kampanyası seçtiğinizden emin olmak için withCondition
harekete geçirici mesaj AdvertisingChannelSubType
ekleyin.
Bazı video kampanyalarının, kampanyada desteklenen reklam türlerini kısıtlayan alt türleri vardır. Daha net bir ifadeyle, VIDEO_ACTION
kampanyaları yalnızca VIDEO_RESPONSIVE
reklam türünü, VIDEO_NON_SKIPPABLE
kampanyaları ise yalnızca NON_SKIPPABLE_INSTREAM_VIDEO_AD
reklam türünü destekler.
Belirli kampanya türlerinde çalışmanın en iyi yolu, seçicinizde withCondition
ifadesini kullanmaktır. İlgilendiğiniz kampanya türü için AdvertisingChannelSubType
değerini güncelleyebilirsiniz:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
.get();
Alt türü olmayan video kampanyaları aşağıdaki video reklam biçimlerini destekler:
- Akışta TrueView (TrueView In-stream)
- TrueView video discovery
- Bumper
Bu kampanyaları withCondition
kullanarak seçebilirsiniz:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = null")
.get();
Yayın içi video reklamlar, diğer videolardan önce, sonra veya bunların yayını sürerken oynatılabilir. Kullanıcılara belirli bir süre sonra reklamı atlama seçeneği sunulur. Video Discovery reklamları Görüntülü Reklam Ağı'nda ve çeşitli YouTube sayfalarında gösterilir ve yalnızca kullanıcı önce reklamın küçük resmini aktif olarak tıkladığında oynatılır. Bumper reklamlar 6 saniye veya daha kısadır ve YouTube videolarında ya da Görüntülü Reklam Ağı'ndaki iş ortağı sitelerinde ve uygulamalarında yer alan videolarda gösterilebilir. Bu reklam türlerinin her biriyle ilgili tüm ayrıntılar için Video reklam biçimleri hakkında başlıklı makaleyi inceleyin.
Reklam grubunu oluşturma
newVideoAdGroupBuilder()
Video kampanyası yöntemiyle video reklam grubu oluşturursunuz. Reklam grubu oluştururken bir reklam grubu türü ve reklam grubu adı belirtmeniz gerekir. Reklam grubu türü aşağıdakilerden biri olmalıdır ve reklam grubu oluşturulduktan sonra değiştirilemez:
VIDEO_BUMPER
VIDEO_EFFICIENT_REACH
VIDEO_NON_SKIPPABLE_IN_STREAM
(yalnızcaVIDEO_NON_SKIPPABLE
kampanyaları için)VIDEO_RESPONSIVE
(yalnızcaVIDEO_ACTION
kampanyaları için)VIDEO_TRUE_VIEW_IN_DISPLAY
VIDEO_TRUE_VIEW_IN_STREAM
YOUTUBE_AUDIO
Örnek:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("VIDEO_TRUE_VIEW_IN_STREAM")
.withName("Video Ad Group")
.build()
.getResult();
Video öğesini oluşturma
Video reklamların genellikle bir video öğesine referans vermesi gerekir. Bu, reklam için hangi videonun oynatılacağını belirler. Komut dosyalarını kullanarak video yükleyemezsiniz ancak daha önce yüklediğiniz mevcut bir YouTube videosunu reklamlarınızda kullanmak üzere bağlayabilirsiniz.
Bunu, YouTubeVideoAssetBuilder
ile Asset
oluşturarak yapabilirsiniz.
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();
Reklamı oluşturun
Yeni bir reklam oluşturmak için reklam grubu türüyle eşleşen oluşturucu yöntemini kullanın
(newVideoAd()
sonrasına zincirlenir):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(yalnızcaVIDEO_ACTION
kampanyaları için)nonSkippableAdBuilder()
(yalnızcaVIDEO_NON_SKIPPABLE
kampanyaları için)
Örnek:
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();
Video hedefleme
Video kampanyaları için iki farklı alakalı hedefleme türü vardır. VideoCampaignTargeting
, genel olarak video kampanyaları için hesap düzeyinde yapılan tüm hedeflemeleri temsil eder ve AdsApp.videoCampaignTargeting()
kullanılarak erişilir. Bu değer, komut dosyalarıyla değiştirilemez ancak görüntülenebilir.
Diğer hedefleme türü, video kampanyaları ve video reklam grupları için ölçütleri ayrı ayrı belirtmenize olanak tanır. Bu işleme, kampanyada veya reklam grubunda videoTargeting()
yöntemiyle erişilebilir ve bu hedefleme düzeyine uygun tüm türler için hem pozitif hem de negatif ölçütlere yönelik seçicilere ve oluşturuculara erişim sağlar. Hesap düzeyindeki ölçütleri görüntülemek için AdsApp.videoTargeting()
yöntemi de vardır ve bu yöntem, AdsApp.videoCampaignTargeting()
'dan farklı bir ölçüt grubu içerir. VideoCampaignTargeting
gibi, bu ölçütleri komut dosyalarıyla yönetemezsiniz.
Bir kampanyada belirli bir yerleşimi hariç tutma örneğini aşağıda görebilirsiniz:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
Demografi (yaş, cinsiyet) kriterleri, diğer kriter türlerinden biraz farklı çalışır. Yeni bir reklam grubu oluşturulduğunda, olası her yaş ve cinsiyet değeri için otomatik olarak ölçütler oluşturulur ve bu reklam grubu, tüm bu değerleri hedefler. Mevcut hedeflemeyi getirip üzerinde exclude()
yöntemini çağırarak bir demografik grubu hariç tutabilir, mevcut hariç tutma hedeflemesini bulup include()
yöntemini çağırarak da hariç tutulan bir demografik grubu yeniden dahil edebilirsiniz.
Belirli bir cinsiyeti reklam grubundan hariç tutma örneğini aşağıda bulabilirsiniz:
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}