Bu kılavuzda, video envanterine teklif verirken kullanabileceğiniz entegrasyon koşulları, yapılandırma ve ilgili alanlar özetlenmektedir.
Google, ayrı reklam fırsatları veya dinamik video reklam kapsülleri olarak gösterilen yayın içi, doğal ve geçiş video reklamlarını destekler. Dinamik kapsüller, sırayla gösterilen video reklamların gruplandırılmasını ifade eder. 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 Doğal 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ınır ancak aksi belirtilmediği sürece alan adları ve yollar, Protobuf ile JSON biçimi arasında eşdeğerdir.
OpenRTB proto ve Google'a özgü OpenRTB uzantılarını Protos 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 onay için göndermenizi önerir. İnceleme sürecini başlatmak için Gerçek Zamanlı Açık Artırma API'sinin Creatives kaynağını kullanabilirsiniz.
Ön hedefleme yapılandırması
Video envanteri alabilmek 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
içinde belirtilen video URL'si bağlantısında veya VAST XML'sinde belirtebilirsiniz. Ayrıca bir video URL'si belirtirseniz bağlı VAST XML belgesine makrolar 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 başlıklı makaleyi inceleyin.
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 için OpenRTB'nin BidRequest.imp.video
alanını kullanabilirsiniz.
Ayrıca, yerel reklam envanteri için benzer videoya özgü 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 oynatıldıktan sonra video alanında son kart (bilgi kartı) olarak oluşturulmak üzere seçilebilir. Aksi takdirde, tamamlayıcı reklam bitiş ekranı olarak oluşturulmaz. BidRequest.imp.rwdd
-
true
olarak ayarlanırsa kullanıcının video reklamı görüntülediği için ödül aldığı belirtilir. Tipik ödüller arasında ücretsiz olarak ekstra bir makale okuma, oyunda ekstra can alma veya sponsorlu reklamsız müzik oturumu elde etme yer alabilir. 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 Maksimum atlanabilir video süresi başlıklı makaleyi inceleyin. BidRequest.imp.video.maxseq
-
Dinamik video reklam kapsülünde yayınlanabilecek maksimum reklam sayısı.
poddur
ayarlanmış ancakmaxseq
ayarlanmamış veya0
ise video kapsülünde kaç reklamın yayınlanabileceği konusunda bir sınırlama yoktur. Google yalnızca dinamik pod'ları destekler.Gösterilen video reklamların gerçek sayısı bu değerden küçük 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ın saniye cinsinden minimum süresi. Ayarlanmadığında minimum süre yoktur.
BidRequest.imp.video.plcmt
-
Videonun nerede oynatılacağını açıklar.
PLCMT_UNKNOWN
Yerleşim bilinmiyor veya belirlenemiyor. PLCMT_INSTREAM
Tüketicinin istediği akışlı video içeriğinden önce, içerik sırasında veya içerikten sonra oynatılan videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar. Yayın içi video, oynatıcı başlatıldığında varsayılan olarak "ses açık" olarak ayarlanmalı veya kullanıcının video içeriğini izleme niyeti açıkça belirtilmiş olmalıdır. Oynatıcının etrafında başka içerikler olsa da video içeriği, kullanıcının ziyaretinin odak noktası olmalıdır. Sayfadaki birincil içerik olmaya devam etmeli ve oynatılırken ses çalabilen tek görüntülenebilir video oynatıcı olmalıdır. Oynatıcı, kayan/sabit oynatıcıya dönüştürülürse sonraki reklam çağrıları, güncellenen oynatıcı boyutunu doğru şekilde iletmelidir. PLCMT_ACCOMPANYING_CONTENT
Akışlı video içeriğinden önce, içerik görüntülenirken veya içerikten sonra oynatılan videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar. Video oynatıcı yüklenir ve metin paragraflarından veya grafik içeriklerinden önce, sonra ya da bu içerikler arasında oynatılır. Yalnızca görünüm alanına girdiğinde oynatılmaya başlar. Eşlik eden içerik, yalnızca görüntü alanına girildiğinde oynatılmaya başlamalıdır. Sayfadan kaydırıldığında kayan/sabit oynatıcıya dönüştürülebilir. 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 görüntü alanının dışına kaydırılamamalıdır. Bu, uygulama içi video veya slayt gösterileri gibi yerleşimlerde olabilir. PLCMT_NO_CONTENT_STANDALONE
Akışlı video içeriği olmadan oynatılan video reklamlar. Bu tür reklamlar; slayt gösterileri, doğal feed'ler, içerik içi veya sabit/kayan gibi yerleşimlerde gösterilebilir. BidRequest.imp.video.playbackmethod
-
Video reklamın nasıl oynatılacağını açıklar.
Oynatma yöntemi, mevcut en iyi ölçüme göre otomatik oynatma veya tıkla oynat olarak belirlenir.
AUTO_PLAY_SOUND_ON
Sayfa yüklendiğinde ses açık olarak başlatılır. AUTO_PLAY_SOUND_OFF
Sayfa yüklendiğinde ses kapalı olarak başlatılır. CLICK_TO_PLAY
Tıklandığında ses açık olarak başlatılır. MOUSE_OVER
Fareyle üzerine gelindiğinde ses açık olarak başlatılır. ENTER_SOUND_ON
Görüntü alanına girildiğinde ses açık olarak 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
- ise
true
oynatıcının videonun atlanmasına izin vereceğini veya atlanabilir reklamlara izin verileceğini gösterir. Aksi takdirde, atlanabilir reklamlara izin verilmediği belirtilir. BidRequest.imp.video.startdelay
-
0 değeri videodan önce gösterilen reklamı, -1 değeri videonun ortasında gösterilen reklamı ve -2 değeri videodan sonra gösterilen reklamı ifade eder.
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 ifade eder.
BidRequest.imp.video.durfloors
veBidRequest.imp.audio.durfloors
-
Alıcının teklif verebileceği çeşitli sürelerdeki video veya işitsel reklam öğeleri için ilgili taban fiyatları gösteren bir
DurFloors
nesne dizisi.Aşağıda, Google tarafından belirtilen
durfloors
öğesinin nasıl görüneceğine dair bir örnek verilmiştir:{"maxdur": 16, "bidfloor": 5}
,$5
konumunda(0, 16)
saniyeyi gösteriyor.{"mindur": 16, "maxdur": 31, "bidfloor": 10}
,[16, 31)
saniyeyi$10
cinsinden gösterir.{"mindur": 31, "bidfloor": 20}
,$20
konumunda[31, inf)
saniyeyi gösteriyor.
Bu sinyaller video reklam öğelerine özgü olmasa da teklif verenlerin okuması açısından özellikle değerlidir:
BidRequest.device.ifa
- Bu alan, yalnızca SSL kullanılırken ayarlanan ve karma oluşturma işlemi uygulanmayan 36 karakterlik bir UUID'dir. Bu,
BidRequest.device.dpidm5
'nın şifrelenmemiş sürümüdür. iOS cihazlar için tümü büyük harflerle yazılmış Reklamverenler İçin Tanımlayıcı (IDFA) içerir. Android cihazlar için tümü küçük harflerden oluşan Android tanımlayıcısını (ADID) içerir. Bağlı TV cihazları için benzersiz tanımlayıcıları (örneğin, 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 dahildir. CONNECTED_TV
hem bağlı TV'leri (yani akıllı TV'ler) hem de bağlı cihazları (ör. Roku, Apple TV vb.) içerir. HIGHEND_PHONE
Üst düzey telefon cihazları dahildir. TABLET
Tablet cihazlar dahildir. CONNECTED_DEVICE
Özel oyun cihazlarını içerir. SET_TOP_BOX
Set üstü kutu cihazları içerir. 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
- Varsa 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şteki tamamlanma oranını temsil eden [0,0, 1,0] aralığında bir kesir olur.-1.0
varsayılan değeri, geçmiş tamamlama oranı verilerinin kullanılamadığını gösterir. BidRequest.imp.video.poddur
- Dinamik bir video reklam kapsülünü doldurabileceğiniz sürenin saniye cinsinden uzunluğu. 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, envanterle ilgili bilgileri de içerir. Bunlar arasında dikey, izin verilen satıcılar ve kanal bilgileri yer alır. Teklif isteğindeki diğer tüm mevcut 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 listesi için teknik dokümanlardaki 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ı, bunlardan en az birinin desteklendiğini belirtmelidir.
BidRequest.imp.video.protocols
-
Video reklam istekleri için yayıncının desteklediği VAST sürümlerini açıklar.
Aşağıdakiler dahil olmak üzere bir
Protocol
enum değerleri dizisi 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
nesneleri dizisi içerir. BidRequest.site.page
-
Video izleme sayfasının URL'si veya videonun yerleştirildiği sayfanın URL'si. Ö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, uygun bir video teklif yanıtının alıntısı yer almaktadır:
id: "n40G42d551UX18627ao8lt" seatbid { bid { id: "17u6BnD62h88r5q7066" impid: "1" price: 0.797848 adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%" adomain: "google.com" crid: "test_creative_id_987914" w: 320 h: 480 cattax: GOOGLE_CATEGORIES [com.google.doubleclick.bid] { attribute: 47 attribute: 50 billing_id: 55383762512 skadn { version: "4.0" network: "306el65O" itunesitem: "832461214" sourceapp: "977150768" fidelities { fidelity: VIEW_THROUGH_ADS nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565" timestamp: "1757329316673" signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7" } fidelities { fidelity: STOREKIT_RENDERED_ADS nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565" timestamp: "1757329316673" signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b" } sourceidentifier: "8396" } app_promotion_type: INSTALLS clickurl: "google.com" } } } [com.google.doubleclick.bid_response] { processing_time_ms: 20 }
Bir video teklifi yanıtındaki önemli alanlar şunlardır:
BidResponse.seatbid.bid.ext.attribute
-
Bu snippet'ten gösterilebilecek reklamlar için özellikler. Kimliklerin listesi için
buyer-declarable-creative-attributes.txt
dosyasına bakın. Bu özelliklerden hiçbirinin, yayıncının teklif isteğinde izin vermediği özelliklerle eşleşmediğinden emin olmak için kontrol ederiz.
Örneğin, alanlardan birinin
30
içerip içermediğini ayarlamak, reklamın oluşturulması için VPAID desteği gerektiğini 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'si 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 önerilen sinyalleri
- Tüm video biçimleri için Authorized Buyers proto önerilen sinyalleri
- Yayıncılar videoya nasıl izin verebilir/izin vermeyebilir?
- Uç durumlar
Alıcılar nasıl video ekleyebilir?
Aşağıdaki tablolarda, alıcıların reklam öğelerine video ekleyebileceği ve web ile mobil uygulama için sırasıyla reklam yayınlayabilecekleri yerleşimler gösterilmektedir.
Web
Video reklam öğesi | Yayın içi (tümü) | Feed/makale içi | Feed içi/makale içi yerel reklam | 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/makale içi | Feed içi/makale içi yerel reklam | Geçiş reklamı | Banner içi |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
Özel JS |
|||||
Yerel + VAST |
Anahtar: | Biçim/teknoloji kullanılamıyor | Yayıncı engellemelerine tabi olmak kaydıyla bu yerleşimde video reklam öğesi kabul edilir. |
Video reklam öğesi bu yerleşimde kullanılamıyor |
---|
OpenRTB için önerilen sinyaller
Aşağıdaki tablolarda, masaüstü ve mobil web ile mobil uygulama için tüm video biçimlerinde OpenRTB'nin önerdiği 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 mevcut & |
|
Yayın içi (VPAID yok) |
VIDEO nesnesi mevcut & |
|
Yayın içi olmayan |
VIDEO nesnesi mevcut
|
|
Feed içi |
VIDEO nesnesi mevcut & |
|
Yazı içi |
VIDEO nesnesi mevcut & |
|
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 mevcut & |
|
Yayın içi olmayan |
VIDEO nesnesi mevcut
|
|
Feed içi |
VIDEO nesnesi mevcut & |
|
Yazı içi |
VIDEO nesnesi mevcut & |
|
Yerel biçim |
NATIVE nesnesi mevcut ve |
|
Geçiş reklamı (VAST) |
VIDEO nesnesi mevcut & |
|
Geçiş reklamı (VAST yok) |
VIDEO nesnesi mevcut & |
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/izin vermeyebilir?
Aşağıdaki tabloda, yayıncıların yerleşimlerinde videoya nasıl izin verebileceği/videoyu nasıl engelleyebileceği gösterilmektedir.
Yayıncı seçeneği | Geçerli biçimler | Teklif isteğinde şu şekilde açıklanı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ı |
|
(Talimatlar) için etkinleştirin. |
Feed içi Yazı içi |
Video nesnesi mevcut & |
Yayın içi olmayan reklamları etkinleştirme (talimatlar) |
Yerel biçim |
Yerel nesne mevcut |
Video geçiş reklamları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 kullanarak özel kapatmayı geciktirme |
Geçiş reklamlarında, özel kapatma kullanılmamış olsa bile reklamın kapatılması MRAID kullanılarak alıcıya bildirim gönderebilir. Yetkili alıcılar tarafından uygulanan X, 5 saniye sonra altta görünse bile her zaman özel kapatma düğmesinin üzerinde yer alır. |
Sözlük
Authorized Buyers video sözlüğü bölümüne bakın.
Yayın içi ve yayın içi olmayan biçimlerle ilgili alanlar
OpenRTB 2.5 (47. sayfadan itibaren) bölümüne bakın.
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
Gösterimin doğrusal mı, doğrusal olmayan mı vb. olması gerektiğini belirtir. Hiçbiri belirtilmezse hepsine izin verildiği varsayılır.
|
||||
videoad_start_delay
|
|
Teklif isteği değeri kaynağı
OpenRTB Nesnesi |
Alanlar | Authorized Buyers /Exchange Teklifli sistem Yayın içi olmayan |
Örnek Değerler | Kim belirler? /Bu değer nereden alınır? |
---|---|---|---|---|
Nesne | ||||
Video | mimler | 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ıldı |
|
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 | ||
oyuncunun boyu | evet | 225.300.153 | ||
başlangıç gecikmesi | evet | 0 | Google, varsayılan 5 sn. | |
atla | evet | 1 | Yayıncı/Google - Geçiş reklamları için => Google - Yayın içi reklamlar 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 | |||
maksimum bit hızı | hayır | |||
pos | evet | 1 | ||
Cihaz | ||||
Px oranı | evet | 1 | ||
gösterim | ||||
Güvenli | evet | 1 | Google varsayılan olarak doğru değerini döndürür çünkü adtag her zaman güvenlidir |