Google Ads komut dosyaları, YouTube tabanlı Video kampanyalarınızı yönetmenize ve bunlar hakkında rapor oluşturmanıza olanak tanır. Komut dosyalarını kullanarak mevcut video kampanyalarını yönetebilir, reklam grupları ve reklamlar oluşturup yönetebilir, kampanyalar için hedefleme ayarlayabilir ve rapor çalıştırabilirsiniz. Ancak video kampanyaları oluşturmak için komut dosyalarını kullanamazsınız.
Video kampanyaları ve reklam grupları alınıyor
Video kampanyaları, bir AdsApp
nesnesinin videoCampaigns
koleksiyonuyla kullanılabilir. Bunları, normalde komut dosyalarındaki kampanyaları 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, kampanyanın reklam gruplarını da benzer bir şekilde alabilirsiniz:
const adGroupIterator = campaign.videoAdGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
Alternatif olarak AdsApp.videoAdGroups()
yöntemini de 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ı, video reklamlarınızı VideoAdGroup
videoAds()
yöntemini kullanarak almanıza olanak tanır.
VideoAdGroup
newVideoAd()
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 farklılık gösterir. Doğru video kampanyası türünü seçtiğinizden emin olmak için AdvertisingChannelSubType
üzerinden bir withCondition
araması ekleyin.
Bazı video kampanyalarının, söz konusu kampanyada desteklenen reklam türlerini kısıtlayan alt türleri vardır. Özellikle, 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ürleri üzerinde çalışmanın en iyi yolu, seçicinizde withCondition
ifadesini kullanmaktır. İlgi alanı 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:
- Yayın içi (in-stream) TrueView
- TrueView video discovery
- Bumper
withCondition
kullanarak bu kampanyaları seçebilirsiniz:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = null")
.get();
Video içi reklamlar, diğer videoların yayını öncesinde, sırasında veya sonrasında oynatılabilir. Bu sayede, 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örünür ve yalnızca kullanıcı önce reklam küçük resmini etkin bir şekilde tıklarsa oynatılır. Bumper reklamlar, 6 saniye veya daha kısadır ve YouTube videolarında veya 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 bölümünü inceleyin.
Reklam grubunu oluşturma
Bir video kampanyasının newVideoAdGroupBuilder()
yöntemini kullanarak video reklam grubu oluşturursunuz. Reklam grubunu 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:
TRUE_VIEW_IN_STREAM
TRUE_VIEW_IN_DISPLAY
BUMPER
VIDEO_RESPONSIVE
(yalnızcaVIDEO_ACTION
kampanya için)NON_SKIPPABLE_INSTREAM_VIDEO_AD
(yalnızcaVIDEO_NON_SKIPPABLE
kampanya için)
Örnek:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("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 bir 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ında zincirlenen):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(yalnızcaVIDEO_ACTION
kampanya için)nonSkippableAdBuilder()
(yalnızcaVIDEO_NON_SKIPPABLE
kampanya 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 ve AdsApp.videoCampaignTargeting()
kullanılarak erişilen herhangi bir hedeflemeyi temsil eder. Bu, komut dosyaları aracılığı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ı belirtmenizi sağlar. Bu buna kampanya veya reklam grubunda videoTargeting()
yöntemi kullanılarak erişilebilir ve söz konusu hedefleme düzeyi için geçerli olan tüm türler için hem pozitif hem de negatif ölçütler için seçicilere ve oluşturuculara erişim sağlanır. AdsApp.videoTargeting()
yöntemi, ölçütleri hesap düzeyinde görüntülemek için de mevcuttur ve AdsApp.videoCampaignTargeting()
parametresinden farklı bir ölçüt grubu içerir. VideoCampaignTargeting
gibi, bu ölçütleri komut dosyalarıyla yönetemezsiniz.
Aşağıda, bir kampanyada belirli bir yerleşimi hariç tutmaya ilişkin bir örnek verilmiştir:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
Demografiye ilişkin ölçütler (yaş, cinsiyet) diğer kriter türlerinden biraz farklı çalışır. Yeni bir reklam grubu oluşturulduğunda, olası her yaş ve cinsiyet değerine ilişkin ölçütler otomatik olarak oluşturulur ve bu reklam grubu bunların tümünü hedefler. Mevcut hedeflemeyi getirip exclude()
yöntemini çağırarak bir demografiyi hariç tutabilirsiniz. Ayrıca, mevcut hariç tutma hedeflemesini bulup include()
yöntemini çağırarak, hariç tutulan bir demografiyi yeniden dahil edebilirsiniz.
Aşağıda, belirli bir cinsiyeti reklam grubundan hariç tutmaya ilişkin bir örnek verilmiştir:
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}