Bu kılavuzda, video envanterine teklif verirken kullanabileceğiniz entegrasyon şartları, yapılandırma ve alakalı alanlar özetlenmiştir.
Google, bağımsız reklam fırsatları veya dinamik video reklam kapsülleri olarak temsil edilen yayın içi, yerel ve geçiş video reklamlarını destekler. Dinamik kapsüller, sırayla gösterilen bir video reklam grubunu tanımlar. Bu grupta, kapsülün maksimum süresi uzunluğu değişen bir veya daha fazla videoya bölünür. Bu biçimler hakkında daha fazla bilgi için yerel ve geçiş reklamı 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
değerini 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
-
Teklif yanıtına dahil edilen her bir reklam için izin verilen maksimum süre (saniye cinsinden). 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
-
Dinamik video reklam kapsülüne yayınlanabilecek maksimum reklam sayısı.
poddur
ayarlanmışsa ancakmaxseq
ayarlanmamışsa veya0
ise bir video kapsülüne kaç reklamın yayınlanabileceğiyle ilgili bir kısıtlamanız yoktur. Google yalnızca dinamik kapsülleri destekler.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
- Teklif yanıtına dahil edilen her bir reklam için saniye cinsinden minimum süre. 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 akışlı video içeriğinden önce, içeriğin ortasında veya içeriğin sonunda 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, içerik akışı sırasında veya içerik akışından sonra oynatılan videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar. Video oynatıcı, metin veya grafik içerik paragraflarından önce, 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 birincil odak noktası olmalı, görüntü alanının büyük kısmını kaplamalı ve kaydırmayla görüntü alanından kaybolmamalıdır. Bu, uygulama içi video veya slayt gösterileri gibi yerleşimlerde olabilir. PLCMT_NO_CONTENT_STANDALONE
Video içeriği akışı 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.
BidRequest.imp.video.durfloors
veBidRequest.imp.audio.durfloors
-
Alıcının teklif verebileceği çeşitli sürelerdeki video veya işitsel reklam öğelerinin taban fiyatlarını belirten bir
DurFloors
dizisi.Aşağıda, Google tarafından belirtilen
durfloors
değerinin nasıl görüneceğine dair bir örnek verilmiştir:$5
'de(0, 16)
saniyeyi temsil eden{"maxdur": 16, "bidfloor": 5}
.{"mindur": 16, "maxdur": 31, "bidfloor": 10}
,$10
saniyelik[16, 31)
temsil eder.$20
'de[31, inf)
saniyeyi temsil eden{"mindur": 31, "bidfloor": 20}
.
Bu sinyaller video reklam öğelerine özgü değildir ancak teklif verenlerin okuması ö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
değerinin şifrelenmemiş sürümüdür. iOS cihazlarda, Reklamverenler için Tanımlayıcı'yı (IDFA) tümüyle büyük harflerle içerir. Android cihazlar için, Android tanımlayıcısını (ADID) tüm 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ışı reklamcılık 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 mevcut olmadığını gösterir. BidRequest.imp.video.poddur
- Dinamik bir video reklam kapsülü için doldurabileceğiniz saniye cinsinden süre. Bu alan, reklam arasının tamamının uzunluğunu ifade eder. Ayarlanmamışsa reklam alanı bir kapsülün parçası değildir.
Video teklif isteği, sektör, izin verilen tedarikçiler ve kanal bilgileri gibi envanter hakkında da bilgi 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 bir 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: "79N7F1708654i75q3k69j1" seatbid { bid { id: "1gR655162hOsH9q3X6R" impid: "1" price: 2.3833 adid: "test_creative_id_648299" adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%" adomain: "google.com" crid: "test_creative_id_648299" attr: VIDEO_IN_BANNER_AUTO_PLAY w: 1920 h: 1080 [com.google.doubleclick.bid] { event_notification_token { payload: "token" } billing_id: 11004606416 skadn { version: "4.0" network: "O5O88B57" itunesitem: "509167749" nonce: "" sourceapp: "com.google.testapp" timestamp: "OMITTED" signature: "OMITTED" fidelities { fidelity: VIEW_THROUGH_ADS nonce: "d3be52b1-8ef6-4277-8922-54450b07fd5b" timestamp: "1730409097616" signature: "8d52E359K158Dj1u89EpLP3544Qz7B10CV0a92YZJ6JXX8d9uXi72N43ZxjRl96Ph7v8R5u1k5y9Aoy3jZcN3C5dxRU390qc" } fidelities { fidelity: STOREKIT_RENDERED_ADS nonce: "d3be52b1-8ef6-4277-8922-54450b07fd5b" timestamp: "1730409097616" signature: "43C2b79X4nPY913Qs3jJLLhCjUNZg39cK022pCE2wH731Ie7q4584b5UGG137Jh12I2R6a0e35LJbvQJbn5o564roQ7G1Mtd" } sourceidentifier: "1" } app_promotion_type: INSTALLS } } seat: "1061:9160:833989" } bidid: "m7V3rjn0-aF599ZZ6-37hA-b9o7DU8CLrtp" 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 videoyu nasıl dahil edebilir?
- Tüm video biçimleri için OpenRTB tarafından önerilen sinyaller
- Tüm video biçimleri için Authorized Buyers proto önerilen sinyalleri
- Yayıncıların videoya izin vermesi/vermemesi
- Sıra dışı durumlar
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 & |
|
Yayın içi (VPAID yok) |
VIDEO nesnesi mevcuttur & |
|
Yayın içi olmayan |
VIDEO nesnesi mevcut
|
|
Feed içi |
VIDEO nesnesi mevcuttur & |
|
Yazı içi |
VIDEO nesnesi mevcuttur & |
|
Yerel biçim |
NATIVE nesnesi mevcut ve |
|
Banner içi |
Video nesnesi mevcut değil & |
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 & |
|
Yayın içi olmayan |
VIDEO nesnesi mevcut
|
|
Feed içi |
VIDEO nesnesi mevcuttur & |
|
Yazı içi |
VIDEO nesnesi mevcuttur & |
|
Yerel biçim |
NATIVE nesnesi mevcut ve |
|
Geçiş reklamı (VAST) |
VIDEO nesnesi mevcuttur & |
|
Geçiş reklamı (VAST yok) |
VIDEO nesnesi mevcuttur & |
Filtrelendi |
Banner içi (MRAID) |
Video nesnesi mevcut değil & |
|
Banner içi (MRAID yok) |
Video nesnesi mevcut değil & |
Yayıncılar videoya nasıl izin verebilir/vermeyebilir?
Aşağıdaki tabloda, yayıncıların yerleşimlerinde videoya izin verme/vermeme yöntemleri gösterilmektedir.
Pub seçeneği | Geçerli biçimler | Teklif isteğinde şu şekilde tanımlanır: |
---|---|---|
Yayın içi video birimi belirtin |
Yayın içi (tümü) |
Video nesnesi mevcut & |
VPAID'i etkinleştirme |
Yayın içi web |
Video nesnesi mevcut ve |
IBV'yi etkinleştirme |
Banner içi Geçiş reklamı |
|
'yi etkinleştirin (talimatlar) |
Feed içi Yazı içi |
Video nesnesi mevcuttur ve |
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
|
|
||||
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.
|
||||
videoad_start_delay
|
|
Teklif isteği değer 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"]", |
|
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] | ||
protokoller | evet | [2,3,5,6,7,8] | ||
doğrusallık | evet | [1] | ||
yerleşim | evet | [1] | ||
oynatıcı genişliği | evet | 400,400,300 | ||
oyuncu boyu | evet | 225.300.153 | ||
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 | |||
max bitrate | hayır | |||
pos | evet | 1 | ||
Cihaz | ||||
Piksel oranı | evet | 1 | ||
gösterim | ||||
Güvenli | evet | 1 | Google adtag her zaman olduğundan varsayılan olarak doğru değerini alır |