Google Ads komut dosyaları, YouTube tabanlı video kampanyalarınızı yönetmenize ve raporlamanı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ı kullanamazsınız.
Video kampanyalarını ve reklam gruplarını getirme
Video kampanyaları, AdsApp
nesnesi koleksiyonu aracılığıyla kullanılabilir.videoCampaigns
Bunları, komut dosyalarında normalde kampanyaları alacağınız şekilde 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ı 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ı, VideoAdGroup
yöntemini kullanarak video reklamlarınızı videoAds()
ile almanıza olanak tanır.
VideoAdGroup
'ın 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 değişir. Doğru video kampanyası türünü seçtiğinizden emin olmak için AdvertisingChannelSubType
'da withCondition
çağrısı ekleyin.
Bazı video kampanyalarında, kampanyada desteklenen reklam türlerini kısıtlayan alt türler bulunur. Daha açık belirtmek gerekirse, 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 işlem yapmanın en iyi yolu, seçicinizde withCondition
yan tümcesi 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 videoları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österilir ve yalnızca kullanıcı önce reklam küçük resmini etkin bir şekilde tıkladığında oynatılır. 6 saniye veya daha kısa olan bumper reklamlar YouTube videolarında ya da Görüntülü Reklam Ağı'ndaki iş ortağı siteleri ve uygulamalarındaki videolarda gösterilebilir. Bu reklam türlerinin her biri hakkında ayrıntılı bilgi için Video reklam biçimleri hakkında başlıklı makaleyi inceleyin.
Reklam grubunu oluşturma
Video kampanyası newVideoAdGroupBuilder()
yöntemiyle bir 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
kampanyaları için)NON_SKIPPABLE_INSTREAM_VIDEO_AD
(yalnızcaVIDEO_NON_SKIPPABLE
kampanyaları 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ğı belirler. Komut dosyaları kullanarak video yükleyemezsiniz ancak daha önce yüklediğiniz bir YouTube videosunu reklamlarınızda kullanmak için 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şturma
Yeni bir reklam oluşturmak için reklam grubu türüyle eşleşen oluşturucu yöntemini kullanın (newVideoAd()
'den sonra 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 hedeflemeyi temsil eder ve AdsApp.videoCampaignTargeting()
kullanılarak erişilir. Bu değer 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ı belirtmenize olanak tanır. Kampanya veya reklam grubundaki videoTargeting()
yöntemiyle erişilebilen bu API, söz konusu hedefleme düzeyi için geçerli tüm türlerde hem pozitif hem de negatif ölçütler için seçicilere ve oluşturuculara erişim sağlar. AdsApp.videoTargeting()
yöntemi, ölçütleri hesap düzeyinde görüntülemek için de kullanılır ve AdsApp.videoCampaignTargeting()
'dan farklı bir ölçüt grubu içerir. VideoCampaignTargeting
gibi bu ölçütleri komut dosyalarıyla yönetemezsiniz.
Aşağıda, bir kampanyadaki belirli bir yerleşimi hariç tutmayla ilgili bir örnek verilmiştir:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
Demografi (yaş, cinsiyet) ölçütleri, diğer ölçüt türlerinden biraz farklı çalışır. Yeni bir reklam grubu oluşturulduğunda, olası her yaş ve cinsiyet değeri için ölçütler otomatik olarak oluşturulur ve bu reklam grubu bunların tümünü hedefler. Mevcut hedeflemeyi getirerek ve üzerinde exclude()
yöntemini çağırarak bir demografiyi hariç tutabilir, mevcut hariç tutma hedeflemesini bulup include()
yöntemini çağırarak hariç tutulan bir demografiyi yeniden dahil edebilirsiniz.
Belirli bir cinsiyeti reklam grubundan hariç tutmayla ilgili bir örnek aşağıda verilmiştir:
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}