Video Reklamlar

Bu kılavuzda, video envanterine teklif verirken kullanabileceğiniz entegrasyon şartları, yapılandırma ve alakalı OpenRTB protokol alanları özetlenmiştir. Google RTB protokolünün desteği sonlandırıldı ve bu rehberde bu protokole odaklanılmayacaktır. Google GZT protokolündeki video reklamlar hakkında bilgi edinmek için Google GZT'de Video Reklamlar kılavuzuna göz atın.

Google; yayın içi, yerel ve geçiş video reklamları destekler. Bu biçimler hakkında daha fazla bilgi için yerel ve geçiş reklamı biçimleriyle ilgili kılavuzlara bakın.

Alıcı şartları

GZT Protokolü

Bu kılavuzda genellikle Protobuf biçimi ele alınacaktır ancak aksi belirtilmedikçe alan adları ve yollar, Protobuf ile JSON biçimi arasında eşdeğerdir.

OpenRTB protosunu ve Google'a özel OpenRTB uzantılarını Protolar ve referans verileri sayfasında bulabilirsiniz. Teklif veren geliştirme hakkında daha fazla bilgi için İsteği İşleme ve Yanıtı Oluşturma başlıklı makaleleri inceleyin.

Reklam öğesi incelemesi

Google, reklam öğeleriyle teklif vermeden önce reklam öğelerini onay için göndermenizi önerir. İnceleme sürecini başlatmak için Gerçek Zamanlı Teklif Verme API'sinin Reklam öğeleri kaynağını kullanabilirsiniz.

Ön hedefleme yapılandırması

Video envanteri almak için Authorized Buyers hesabınızın video envanteri içeren bir ön hedefleme yapılandırması oluşturması gerekir.

Makrolar

Makroları, BidResponse.seatbid.bid.adm bölümünde belirtilen video URL'si bağlantısında veya VAST XML'de belirtebilirsiniz. Ayrıca, bir video URL'si belirtirseniz bağlı VAST XML belgesine makro da yerleştirebilirsiniz. Video reklam öğeleri için aşağıdaki makrolar desteklenir:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Authorized Buyers, tıklama izleyicilerini VAST sarmalayıcısına dahil ettiğinden CLICK_URL_ESC gibi tıklama makroları desteklenmez. Desteklenen makrolar hakkında daha fazla bilgi için Makro belirtme bölümüne bakın.

Açıklama metni ayrıntıları

Gelen bir teklif isteğinin yayın içi veya geçiş reklamı video envanteri için olup olmadığını belirlemek ve istekle ilgili videoya özel ek bilgiler bulmak amacıyla OpenRTB'nin BidRequest.imp.video alanını kullanabilirsiniz. Ayrıca, yerel reklam envanteri için videoya özgü benzer bilgiler için BidRequest.imp.native.{request/request_native}.assets.video kullanabilirsiniz.

BidRequest.{app/site}.content.producer.domain

Video içeriğini açıklayan sayfanın, parametreleri kaldırılmış URL'si. Yayıncı bu URL'yi Google'a gönderir. Örneğin:

http://www.publisher.com/watchpagelink
banner.vcm
true olarak ayarlanırsa tamamlayıcı reklam, video reklamın oynatılması tamamlandıktan sonra video alanında bir son kapak (bilgi kartı) olarak oluşturulacak şekilde seçilebilir. Aksi takdirde tamamlayıcı reklam, son kapak olarak oluşturulmaz.
BidRequest.imp.rwdd
true olarak ayarlanırsa kullanıcının video reklamı izleyerek ödül aldığını gösterir. Ücretsiz olarak ek bir makale okumak, oyunda ekstra can kazanmak veya sponsorlu reklamsız müzik oturumu elde etmek tipik ödüller arasındadır.
BidRequest.imp.video.maxduration

Döndürmeniz gereken reklamın saniye cinsinden izin verilen maksimum süresi. Ayarlanmadığında maksimum süre yoktur. BidRequest.imp.video.skip true olduğunda bu durum farklı şekilde davranabilir. Daha fazla bilgi için Atlanabilir videoların maksimum süresi bölümüne bakın.

BidRequest.imp.video.maxseq

Video kapsülünde gösterilebilecek maksimum reklam sayısı. Ayarlanmamışsa reklam alanı bir video kapsülüne dahil değildir.

Gösterilen gerçek video reklam sayısı bu değerden az veya bu değere eşit olabilir ancak bu değeri aşamaz.

BidRequest.imp.video.minduration
Döndürmeniz gereken reklamın saniye cinsinden minimum süresi. Ayarlanmamışsa minimum süre yoktur.
BidRequest.imp.video.plcmt
Videonun nerede oynatılacağı açıklanır.
PLCMT_UNKNOWN Yerleşim bilinmiyor veya belirlenemiyor.
PLCMT_INSTREAM Tüketicinin istediği canlı yayın video içeriğinden önce, sırasında veya sonrasında oynatılan videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar. Yayın içi video, oynatıcı başlatılırken varsayılan olarak "ses açık" olarak ayarlanmalı veya kullanıcının video içeriğini izlemek için açıkça net bir niyeti olmalıdır. Oynatıcının etrafında başka içerikler bulunabilir ancak kullanıcının ziyaretinin odak noktası video içeriği olmalıdır. Sayfadaki birincil içerik ve oynatıldığında ses çalabilen tek görüntülü video oynatıcı olarak kalmalıdır. Oynatıcı, yüzen/yapışkan olarak dönüştürülürse sonraki reklam çağrıları, güncellenen oynatıcı boyutunu doğru şekilde iletmelidir.
PLCMT_ACCOMPANYING_CONTENT Video içeriği akışından önce, sırasında veya sonrasında oynatılan videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar. Video oynatıcı, metin veya grafik içerik paragraflarının öncesinde, aralarında ya da sonrasında yüklenir ve oynatılır ve yalnızca görüntü alanına girdiğinde oynatmaya başlar. Eşlik eden içerik yalnızca görüntü alanına girildiğinde oynatılmaya başlamalıdır. Sayfa kaydırıldığında kayan/yapışkan bir oynatıcıya dönüşebilir.
PLCMT_INTERSTITIAL Video içeriği olmadan oynatılan video reklamlar. Oynatma sırasında sayfanın odak noktası olmalı, görüntü alanının büyük kısmını kaplamalı ve kaydırmayla görüntü alanından çıkarılamamalıdır. Bu, uygulama içi video veya slayt gösterileri gibi yerleşimlerde olabilir.
PLCMT_NO_CONTENT_STANDALONE Video içeriği akışına sahip olmadan oynatılan video reklamlar. Bu, slayt gösterileri, yerel feed'ler, içerik içi veya sabit/yüzen reklamlar gibi yerleşimlerde olabilir.
BidRequest.imp.video.playbackmethod
Video reklamın nasıl oynatılacağı açıklanır. Oynatma yöntemi, mevcut en iyi ölçüme göre otomatik oynatma veya tıkla oynat olarak belirlenir.
AUTO_PLAY_SOUND_ON Sayfa yüklenirken ses açıkken başlar.
AUTO_PLAY_SOUND_OFF Sayfa yüklendiğinde ses kapalı olarak başlar.
CLICK_TO_PLAY Tıklamayla ses açık olarak başlar.
MOUSE_OVER Fareyle üzerine gelindiğinde ses açık olarak başlar.
ENTER_SOUND_ON Ses açıkken görüntü alanına girildiğinde başlatılır.
ENTER_SOUND_OFF Varsayılan olarak ses kapalıyken görüntü alanına girildiğinde başlatılır.
BidRequest.imp.video.skip
true ise oynatıcının videonun atlanmasına izin verdiğini veya atlanabilir reklamlara izin verildiğini gösterir. Aksi takdirde, atlanabilir reklamlara izin verilmediğini gösterir.
BidRequest.imp.video.startdelay

0 değeri videodan önce, -1 değeri videonun ortasında ve -2 değeri videodan sonra gösterilen reklam anlamına gelir.

Diğer tüm pozitif değerler, videonun başlangıcından reklamın gösterildiği noktaya kadar geçen süreyi (saniye cinsinden) gösterir.

Bu sinyaller video reklam öğelerine özgü değildir ancak teklif verenler için özellikle değerlidir:

BidRequest.device.ifa
Bu alan, yalnızca SSL kullanıldığında ayarlanan ve karma oluşturma işlemine tabi tutulmayan 36 karakterlik bir UUID'dir. BidRequest.device.dpidm5'ün şifrelenmemiş sürümüdür. iOS cihazlarda, reklamverenler için tanımlayıcının (IDFA) tümüyle büyük harfli halini içerir. Android cihazlar için bu, Android tanımlayıcısını (ADID) tümüyle küçük harflerle içerir. Bağlı TV cihazları için benzersiz tanımlayıcılarını (ör. Roku'nun RIDA'sı) içerir.
BidRequest.device.devicetype
Cihazın türünü belirtir.
MOBILE HIGHEND_PHONE veya TABLET için eski bir takma ad.
PERSONAL_COMPUTER Masaüstü ve dizüstü cihazları içerir.
CONNECTED_TV hem bağlı TV'leri (yani akıllı TV'leri) hem de bağlı cihazları (ör. Roku, Apple TV vb.) içerir.
HIGHEND_PHONE Yüksek kaliteli telefon cihazları dahildir.
TABLET Tablet cihazları içerir.
CONNECTED_DEVICE Özel oyun cihazlarını içerir.
SET_TOP_BOX Set üstü kutu cihazları dahildir.
OOH_DEVICE Ev dışı reklam cihazlarını (ör. dijital reklam panoları) içerir.
BidRequest.device.make
Cihazın markasını (ör. Nokia veya Samsung) belirtir.
BidRequest.device.model
Mevcutsa cihazın tam modelini (ör. N70 veya Galaxy) belirtir. Aksi takdirde "iphone" veya "ipad" gibi genel bir model içerir.
BidRequest.imp.metric
Metric.type completion_rate olarak ayarlandığında, Metric.value, reklam alanında yayınlanan video reklamların geçmiş tamamlama oranını temsil eden [0,0; 1,0] aralığında bir kesirli sayı olur. -1.0 varsayılan değeri, geçmiş tamamlama oranı verilerinin kullanılamadığını gösterir.
BidRequest.imp.video.poddur
Kapsülün içerdiği tüm alanlar dahil olmak üzere reklam arasının tamamının saniye cinsinden uzunluğu. Bu değer, video yayıncısı tarafından sağlanan video meta verilerinde belirtilen değere ayarlanır.

Video teklif isteği, sektör, izin verilen tedarikçiler ve kanal bilgileri gibi envanter hakkında bilgiler de içerir. Teklif isteğinde mevcut olan diğer tüm alanlar video için de geçerlidir.

Bir video isteğinin AdSlot mesajındaki genişlik ve yükseklik alanları, video reklam oynatıcının boyutuna karşılık gelir.

BidRequest.imp.ext.allowed_vendor_type
İzin verilen tedarikçi firmalar. Kimliklerin listesini görmek için teknik dokümanlar bölümündeki vendors.txt dosyasına bakın. Örneğin, 309 = DFA Video Birimi.
BidRequest.imp.video.mimes
Teklif isteğine yanıt olarak yayınlanan reklamlar için desteklenen içerik MIME türlerini açıklayan izin verilenler listesi (ör. "video/mp4"). Teklif yanıtında bunlardan en az biri için destek belirtilmelidir.
BidRequest.imp.video.protocols
Yayıncının video reklam istekleri için desteklenen VAST sürümlerini açıklar. Aşağıdakiler dahil olmak üzere bir dizi Protocol enum değeri içerir: VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER, VAST_4_0, VAST_4_0_WRAPPER ve daha fazlası.
BidRequest.imp.video.companionad
Bu alan, varsa tamamlayıcı reklamları temsil eden bir Banner nesne dizisi içerir.
BidRequest.site.page

Video izleme sayfasının URL'si veya videonun yerleştirildiği sayfanın Örneğin:

http://www.publisher.com/watchpagelink

Teklif veren, bir video isteğine yanıt verirken BidResponse.seatbid.bid.adm alanında bir VAST yönlendirme URL'si veya VAST XML döndürmelidir. Teklif yanıtı, video reklam için uygun beyanı da içermelidir. Aşağıda, doğru bir video teklif yanıtının bir bölümü verilmiştir: 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Video teklif yanıtındaki önemli alanlar şunlardır:

BidResponse.seatbid.bid.ext.attribute
Bu snippet'ten gösterilebilecek reklamlar için özellikler. Kimlik listesini buyer-declarable-creative-attributes.txt dosyasında bulabilirsiniz. Bu özelliklerin hiçbirinin, teklif isteğinde yayıncı tarafından izin verilmeyen özelliklerle eşleşmediğinden emin oluruz. Örneğin, iki alandan birinin 30 içerdiğini ayarlamak, reklamın oluşturulması için VPAID desteğinin gerekli olduğunu gösterir.
BidResponse.seatbid.bid.adm

Video reklamlar için bu, video reklamın VAST yönlendirme URL'sidir. Örneğin:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

Alternatif olarak, bu ham VAST XML olabilir.

Örnek teklif istekleri ve yanıtları

Video Biçimleri

Alıcılar videoları nasıl ekleyebilir?

Aşağıdaki tablolarda, alıcıların reklam öğelerine video ekleme yöntemleri ve sırasıyla web ve mobil uygulama için videonun yayınlanabileceği yerleşimler gösterilmektedir.

Web

Video reklam öğesi Yayın içi (tümü) Feed içi/yazı içi Yerel feed içi/yazı içi Geçiş reklamı Banner içi

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

Özel JS

 

Yerel + VAST

 

Mobil Uygulama

Video reklam öğesi Yayın içi (tümü) Feed içi/yazı içi Yerel feed içi/yazı içi Geçiş reklamı Banner içi

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

Özel JS

Yerel + VAST

Anahtar: Biçim/teknoloji mevcut değil

Bu yerleşimde kabul edilen video reklam öğesi (yayıncı engellemelerine tabidir)

Video reklam öğesi bu yerleşimde kullanılamıyor

OpenRTB tarafından önerilen sinyaller

Aşağıdaki tablolarda, masaüstü ve mobil web ile mobil uygulama için tüm video biçimlerinde OpenRTB tarafından önerilen sinyaller gösterilmektedir.

Masaüstü ve mobil web

Video biçimi Önerilen sinyaller (yalnızca videoyla alakalı sinyaller) İlgili sinyaller (yalnızca videoyla alakalı sinyaller)

Yayın içi (VPAID)

VIDEO nesnesi mevcuttur   &
video.placement = INSTREAM   &

Yayın içi (VPAID yok)

VIDEO nesnesi mevcuttur   &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

Yayın içi olmayan

VIDEO nesnesi mevcut

video.linearity: linear
Yerleşim, gerçek
yerleşime bağlıdır. Değerler aşağıda verilmiştir
Video.startdelay = 0

Feed içi

VIDEO nesnesi mevcuttur   &
video.placement = IN-FEED

Yazı içi

VIDEO nesnesi mevcuttur   &
video.placement = IN-ARTICLE

Yerel biçim

NATIVE nesnesi mevcut ve

Banner içi

Video nesnesi mevcut değil &
banner.battr ≠ 6 Banner İçi Video (Otomatik Oynatma) &
banner.battr ≠ 7 Banner İçi Video (Kullanıcı Tarafından Başlatılan)

Mobil uygulama

Video biçimi Teklif isteği ayrıntıları (yalnızca videoyla ilgili ayrıntılar)

Yayın içi

VIDEO nesnesi mevcuttur   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 veya 2: VPAID 2.0

Yayın içi olmayan

VIDEO nesnesi mevcut

video.linearity: linear
Yerleşim, gerçek
yerleşime bağlıdır. Değerler aşağıda verilmiştir
Video.startdelay = 0

Feed içi

VIDEO nesnesi mevcuttur   &
video.placement = IN-FEED

Yazı içi

VIDEO nesnesi mevcuttur   &
video.placement = IN-ARTICLE

Yerel biçim

NATIVE nesnesi mevcut ve

Geçiş reklamı (VAST)

VIDEO nesnesi mevcuttur   &
video.placement = INTERSTITIAL

Geçiş reklamı (VAST yok)

VIDEO nesnesi mevcuttur   &
video.placement = INTERSTITIAL

Filtrelenen

Banner içi (MRAID)

Video nesnesi mevcut değil &
banner.battr ≠ 6 Banner İçi Video (Otomatik Oynatma) &
banner.battr ≠ 7 Banner İçi Video (Kullanıcı Tarafından Başlatılan)

Banner içi

(MRAID yok)

Video nesnesi mevcut değil &
banner.battr ≠ 6 Banner İçi Video (Otomatik Oynatma) &
banner.battr ≠ 7 Banner İçi Video (Kullanıcı Tarafından Başlatılan)

Yayıncılar videoya nasıl izin verebilir/vermeyebilir?

Aşağıdaki tabloda, yayıncıların yerleşimlerinde videoya izin verebilecekleri/vermeyecekleri yöntemler gösterilmektedir.

Pub seçeneği Geçerli biçimler Teklif isteğinde şu şekilde tanımlanır:

Yayın içi video birimini belirtme

Yayın içi (tümü)

Video nesnesi mevcut &
video.placement = INSTREAM

VPAID'i etkinleştirme

Yayın içi web

Video nesnesi mevcut ve
video.api = 1 (VPAID 1.0) veya 2 (VPAID 2.0)

IBV'yi etkinleştirme

Banner içi

Geçiş reklamı

banner.battr ≠ 6 Banner İçi Video (Otomatik Oynatma) ve/veya 7 Banner İçi Video (Kullanıcı Tarafından Başlatılan)

'i etkinleştirin (talimatlar)

Feed içi

Yazı içi

Video nesnesi mevcuttur ve
video.placement = IN-FEED veya IN-ARTICLE

Yayın içi olmayan reklamları etkinleştirme (talimatlar)

Yerel biçim

Yerel nesne mevcut

Video geçiş reklamını engelleme

Geçiş reklamı uygulaması

VIDEO nesnesi mevcut değil

Sıra dışı durumlar

# Destek kaydı açıklaması Yorumlar Teklif isteği

1

MRAID'i kullanarak gecikmeli özel kapatma

Geçiş reklamlarında, reklam kapatıldığında MRAID kullanılarak alıcıya bildirim gönderilebilir. Bu bildirim, özel kapatma kullanılmamış olsa bile gönderilir.


Yetkili Alıcı tarafından uygulanan X, özel kapanış 5 saniye sonra alt kısımda görünse bile her zaman özel kapanışların üstünde gösterilir

Sözlük

Authorized Buyers video terimleri sözlüğüne bakın.

Yayın içi ve yayın içi olmayan biçimler için alakalı alanlar

OpenRTB 2.5 (47. sayfadan itibaren) başlıklı makaleyi inceleyin.

BidRequest.Video.
Placement
Yayın içi mWeb

1: Yayın içi
2: Banner içi

mApp

1: Yayın içi
2: Banner içi
Yayın içi olmayan mApp Interstitial

5: Geçiş reklamı

Native

3: Yazı İçi
4: Feed İçi

Rewarded

is_rewarded_inventory: OpenRTB Uzantısı boole
linearity

Gösterimin doğrusal, doğrusal olmayan vb. olup olmayacağını belirtir. Hiçbiri belirtilmezse tümüne izin verildiği varsayılır.

Yayın içi mWeb

1: LINEAR (yayın içi)

mApp

1: LINEAR (yayın içi)
Yayın içi olmayan mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
Yayın içi mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
Yayın içi olmayan Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Teklif isteği değeri kaynağı

OpenRTB
Nesnesi		 Alanlar Authorized Buyers
/Exchange
Teklifli Sistem
Yayın içi olmayan		 Örnek Değerler Bunu kim belirler?
/Bu değer
nereden türetiliyor?
Nesne
Video mim evet ["application/javascript",
"video/mp4"]",		 Google
minduration hayır Yayıncı tarafından yapılandırıldı
maxduration evet Yayıncı tarafından yapılandırıldı
playbackmet
hod		 evet [6] Genellikle yayıncı
yapılandırılmıştır
api (MRAID) evet [1,2] Google
protokoller evet [2,3,5,6,7,8] Google
doğrusallık evet [1] Google
yerleşim evet [1] Google
oynatıcı genişliği evet 400,400,300 Google
oyuncu boyu evet 225.300.153 Google
başlangıç gecikmesi evet 0 Google, varsayılan olarak 5 saniye
atla evet 1 Yayıncı/Google
- Geçiş reklamı için => Google
- Yayın içi reklam için => Yayıncı
atlanabilir, atlanamayan veya her ikisine de izin verilip verilmeyeceğine karar verir.

Ödüllü reklamlar, her zaman atlanamaz;
minimum bit hızı Hayır Google
max bitrate hayır Google
pos evet 1 Google
Cihaz
Piksel oranı evet 1 Google
gösterim
Güvenli evet 1 Google
adtag her zaman
olduğundan
varsayılan olarak doğru
değerini alır