Video kampanyaları

Video kampanyaları, YouTube'da ve Google video iş ortaklarının web siteleri ile uygulamalarında video reklamlar göstermenize olanak tanır.

API sınırlamaları

Google Ads API, öncelikle mevcut video kampanyalarını, reklam gruplarını, reklamları ve ölçütleri getirmeyi ve bunlar hakkında rapor oluşturmayı destekler. Video kampanyaları, Google Ads API kullanılarak oluşturulamaz veya değiştirilemez. Sürüme özgü aşağıdaki istisnalar ve davranışlar geçerlidir:

  • VideoResponsiveAdInfo değişkenliği: 24. sürümden itibaren VideoResponsiveAdInfo nesneleri değişkendir (önceki sürümlerde sabittir). VideoResponsiveAdInfo oluştururken veya değiştirirken videos, business_name ve logo_images alanları zorunludur.
  • Marka güvenliği uygunluğu: 24. sürümden itibaren kampanya düzeyinde campaign.video_brand_safety_suitability kaldırıldı. customer.video_brand_safety_suitability kullanarak hesap düzeyinde marka güvenliği uygunluğunu sorgulayın.
  • Video kampanyası denemeleri: Sürüm 24'ten itibaren, video kampanyalarından oluşan YOUTUBE_CUSTOM denemelerini yapılandırmak için experiment.video_experiment kullanılabilir.

Kampanya yönetimi için alternatifler

Video kampanyalarını programatik olarak oluşturmanız veya yönetmeniz gerekiyorsa aşağıdaki seçenekleri değerlendirin:

  • Google Ads komut dosyaları: Google Ads komut dosyalarını kullanarak video kampanyalarını yönetebilirsiniz. Bu sayede Google Ads arayüzünde otomatik yönetim sağlanır.
  • Talep Yaratma kampanyaları: Amacınız YouTube dahil olmak üzere Google mülklerinde video reklamlar yayınlamaksa Talep Yaratma kampanyaları, hem oluşturma hem de yönetim için Google Ads API'de tam olarak desteklenir.

Performans verilerini alma

GoogleAdsService.SearchStream kullanarak video kampanyalarınız, reklam gruplarınız ve ölçütleriniz için performans verilerini campaign.advertising_channel_type = 'VIDEO' ölçütüne göre filtreleyerek alabilirsiniz.

Reklam grubu performansı

Aşağıdaki sorgu, ad_group kaynağından TrueView video görüntülemeleri ve çeyrek tamamlanma oranları dahil olmak üzere video kampanyası ve reklam grubu metriklerini alır:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

Video yerleşimi ve ölçüt raporlaması

ad_group_criterion, metrikleri veya segmentleri doğrudan desteklemediğinden hedeflenen YouTube videoları, YouTube kanalları veya diğer yönetilen yerleşimler için performans metriklerini almak üzere managed_placement_view gibi ölçüt görünümü kaynaklarını kullanın:

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS

Erişim ve sıklık raporları

Video kampanyalarında, reklamlarınızın belirli gösterim sıklıklarında gösterildiği benzersiz kullanıcı sayısını ölçmek için campaign ve customer (26. sürümden itibaren) kaynaklarında Unique Reach metriklerini sorgulayabilirsiniz.

Aşağıdaki benzersiz kullanıcı metrikleri, sıklık grupları genelinde kitle erişimini ölçer:

  • metrics.unique_users: Seçilen tarih aralığında (92 güne kadar) reklamınızı en az bir kez gören benzersiz kullanıcıların sayısı. Satırlar arasında birleştirilemez.
  • metrics.unique_users_two_plus - metrics.unique_users_ten_plus: 31 güne kadar olan tarih aralıklarında reklamınızı sırasıyla en az 2 ila 10 kez gören benzersiz kullanıcıların sayısı (metrics.unique_users_six_plus - metrics.unique_users_nine_plus, v26 ve sonraki sürümlerde 2+ ila 10+ grubunu tamamlar).
  • metrics.average_impression_frequency_per_user: İstenen dönemde (92 güne kadar) benzersiz bir kullanıcının reklamınızı ortalama görme sayısı. Bu metrik yalnızca campaign kaynağında kullanılabilir, satırlar arasında birleştirilemez ve tamamlayıcı bir _info alanı yoktur.

Sürüm 26 ve sonraki sürümlerde, her tekil kullanıcı erişimi metriğinin ReachMetricInfo türünde bir meta veri alanı vardır: metrics.unique_users_info ve metrics.unique_users_two_plus_info ile metrics.unique_users_ten_plus_info.

Google Ads Sorgu Dili'nde (GAQL), tamamlayıcı metrics.unique_users*_info alanları filterable: false ve sortable: false içeren MESSAGE metrikleridir. Bu nedenle, bunları WHERE veya ORDER BY yan tümcelerinde kullanamazsınız. Bu alanları doğrudan SELECT ifadesinde seçin (ör. metrics.unique_users_info). SELECT ifadesine .reach_metric_states eklemeyin. GAQL'de iç içe yerleştirilmiş mesaj alanları seçildiğinde UNRECOGNIZED_FIELD hatası alınır. Bunun yerine, metrics.unique_users_info seçildiğinde metriğin gizlenip gizlenmediğini veya tamamlanıp tamamlanmadığını açıklayan ReachMetricState türünde yinelenen enum alanı reach_metric_states içeren bir ReachMetricInfo mesajı döndürülür.

Bir erişim metriği gizlendiğinde veya saklama aralığının (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION veya DATE_RANGE_BEYOND_RETENTION) dışında olduğunda Metrics üzerindeki optional int64 alanı ayarlanmaz (alan varlığı kontrol edilmezse 0 olarak değerlendirilir). Ancak LOW_QUALITY, sayısal metriği doldurmaya devam eder.

ReachMetricState enum değerleri, erişim verilerinin durumunu gösterir:

  • COMPLETE: Erişim metriği; gizlilik, kalite veya diğer sınırlamalar nedeniyle engelleme olmadan tamamlanmıştır.
  • PRIVACY_SUPPRESSION: Erişim verileri, kullanıcı gizliliğini korumak için engellendi (ör. kitle hacmi k-anonimlik eşiklerini karşılamadığında).
  • QUALITY_SUPPRESSION: Erişim verileri, veri kalitesi şartları nedeniyle engellendi.
  • LOW_QUALITY: Erişim metriği hesaplandı ancak düşük kaliteli olarak işaretlendi.
  • DATE_RANGE_BEYOND_RETENTION: Seçilen tarih aralığı, erişim verileri için 3 yıllık veri saklama süresini aştığından erişim metrikleri kullanılamıyor.

Aşağıdaki sorgu, video kampanyaları için 30 günlük tekilleştirilmiş erişim metriklerini ve bunların engelleme durumlarını cihaz ve reklam biçimine göre segmentlere ayrılmış olarak alır. Erişim ve N+ sıklık metriklerinin günlük olarak değil, tüm tarih aralığı boyunca tekilleştirilmesi için SELECT ifadesinden segments.date segmentini çıkarın:

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  segments.ad_format_type,
  segments.ad_sub_format_type,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Desteklenen kaynaklar, tarih aralıkları ve segmentler

Erişim ve sıklık sorguları, metriğin maksimum tarih aralığında sınırlı bir segments.date filtresi gerektirir. Tarih filtresi olmayan veya aralığı aşan sorgular, ayarlanmamış erişim alanları döndürür:

Metrik Kaynaklar Maksimum tarih aralığı Uyumlu segmentler
metrics.unique_users campaign, customer (v26 ve sonraki sürümler) 92 gün segments.date, segments.device, reklam biçimi segmentleri (v26 ve sonraki sürümler), reklam ağı segmentleri (v26 ve sonraki sürümler) ve ayarlanmış demografi segmentleri
metrics.average_impression_frequency_per_user campaign 92 gün segments.date, segments.device ve ayarlanmış demografik segmentler
metrics.unique_users_two_plus - metrics.unique_users_ten_plus campaign, customer (v26 ve sonraki sürümler) 31 gün segments.date, segments.device, reklam biçimi segmentleri (v26 ve sonraki sürümler) ve reklam ağı segmentleri (v26 ve sonraki sürümler)
metrics.unique_users*_info (v26 ve sonraki sürümler) campaign, customer Temel metrikle eşleşir segments.date, segments.device, reklam biçimi segmentleri ve reklam ağı segmentleri

Erişim sorgularını segmentlere ayırırken aşağıdaki ortak segment kısıtlamalarını uygulayın:

  • Reklam biçimi ve reklam ağı segmentleri: Reklam biçimine (segments.ad_format_type, isteğe bağlı olarak segments.ad_sub_format_type ile) veya reklam ağına (segments.ad_network_type, isteğe bağlı olarak segments.ad_sub_network_type ile) göre segmentlere ayırabilirsiniz ancak reklam biçimi ve reklam ağı segmentlerini aynı sorguda birleştiremezsiniz. Bir alt segment seçerken her zaman üst segmenti (segments.ad_format_type veya segments.ad_network_type) seçin. segments.ad_sub_format_type segmenti, atlanamayan yayın içi reklamları süreye göre ayırır ve diğer reklam biçimleri için UNSEGMENTED değerini döndürür. segments.ad_sub_network_type segmenti ise YouTube platformlarını (YOUTUBE_INSTREAM, YOUTUBE_INFEED ve YOUTUBE_SHORTS) yalnızca Talep Yaratma kampanyaları için ayırır ve video kampanyaları için UNSEGMENTED değerini döndürür.
  • Düzenlenmiş demografik segmentler: segments.adjusted_age_range ve segments.adjusted_gender segmentleri yalnızca izin verilenler listesine eklenmiş hesaplarda kullanılabilir, birlikte seçilmeleri gerekir ve metrics.unique_users_*_plus metrikleri, metrics.unique_users*_info alanları veya reklam ağı segmentleriyle birleştirilemez.