Video Reklamlar

Bu kılavuzda, video envanteri için teklif verirken kullanabileceğiniz entegrasyon şartları, yapılandırma ve ilgili alanlar açıklanmaktadır.

Google; tek reklam fırsatları veya dinamik video reklam kapsülleri olarak temsil edilen yayın içi, doğal ve geçiş video reklamlarını destekler. Dinamik kapsüller, sırayla gösterilen video reklam gruplarını tanımlar. Kapsülün maksimum süresi, farklı uzunluklardaki bir veya daha fazla videoya bölünür. Doğal ve geçiş reklam biçimleri hakkında daha fazla bilgi için bu biçimlerle ilgili kılavuzlara bakın.

Alıcı şartları

GZT Protokolü

Bu kılavuzda genellikle Protobuf biçimi kullanılacaktır ancak aksi belirtilmedikçe alan adları ve yollar, Protobuf ve JSON biçiminde aynıdır.

OpenRTB protokolünü ve Google'a özel OpenRTB uzantılarını Protokoller 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 bölümlerini inceleyin.

Reklam öğesi incelemesi

Google, reklam öğelerini teklif vermeden önce onaya göndermenizi önerir. İnceleme sürecini başlatmak için Real-Time Bidding API'nin 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ı, video URL'si bağlantısında veya BidResponse.seatbid.bid.adm içinde belirtilen VAST XML'de 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 bir 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 Makroları 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 özgü ek bilgiler bulmak için OpenRTB'nin BidRequest.imp.video alanını kullanabilirsiniz. Ayrıca, doğal 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ın oynatılması bittikten sonra video alanında bitiş kartı (bilgi kartı) olarak oluşturulmak üzere seçilebilir. Aksi takdirde tamamlayıcı reklam, bitiş reklamı olarak oluşturulmaz.

BidRequest.imp.rwdd

true olarak ayarlanırsa kullanıcının video reklamı izlediği için ödül aldığını gösterir. Tipik ödüller arasında ücretsiz olarak fazladan bir makale okuma, oyunda ekstra can alma veya sponsorlu reklamsız müzik oturumu alma sayılabilir.

BidRequest.imp.video.maxduration

Teklif yanıtına dahil edilen her bir tek reklam için izin verilen maksimum süre (saniye cinsinden). Ayarlanmadığında maksimum süre yoktur. BidRequest.imp.video.skip, true olduğunda bu farklı şekilde davranabilir. Daha fazla bilgi için Maksimum atlanabilir video süresi bölümüne bakın.

BidRequest.imp.video.maxseq

Dinamik video reklam kapsülünde yayınlanabilecek maksimum reklam sayısı. poddur ayarlanmış ancak maxseq ayarlanmamışsa veya 0 ise bir video kapsülünde yayınlanabilecek reklam sayısıyla ilgili bir kısıtlamanız yoktur. Google yalnızca dinamik kapsülleri destekler.

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

BidRequest.imp.video.minduration

Teklif yanıtına dahil edilen her bir tek 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, akış sırasında veya akıştan sonra oynatılan videodan önce gösterilen, ara reklam ve yayın sonrası video reklamlar. Yayın içi video, oynatıcı başlatıldığında varsayılan olarak "ses açık" olarak ayarlanmalı veya video içeriğini izlemek için açıkça net bir kullanıcı niyeti 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 ve oynatılırken ses çalabilen tek video oynatıcı olarak kalmalıdır. Oynatıcı kayan/sabit hale gelirse sonraki reklam çağrıları, güncellenen oynatıcı boyutunu doğru şekilde iletmelidir.
PLCMT_ACCOMPANYING_CONTENT	Video içeriği akışından önce, akış sırasında veya akıştan sonra oynatılan videodan önce gösterilen reklamlar, ara reklamlar ve yayın sonrası video reklamlar. Video oynatıcı, metin veya grafik içerik paragraflarından önce, paragrafların arasında ya da paragraflardan sonra yüklenip oynatılır ve yalnızca görüntü alanına girdiğinde oynatılmaya başlar. Eşlik eden içerik yalnızca görüntü alanına girdiğinde oynatılmaya başlamalıdır. Sayfadan kaydırıldığında kayan/sabit bir oynatıcıya dönüşebilir.
PLCMT_INTERSTITIAL	Video içeriği olmadan oynatılan video reklamlar. Oynatma sırasında sayfanın ana odağı olmalı, görüntü alanının büyük kısmını kaplamalı ve kaydırılarak görünümden çıkarı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, slayt gösterileri, yerel feed'ler, içerik içi veya yapışkan/kayan gibi yerleşimlerde olabilir.

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şlar.
AUTO_PLAY_SOUND_OFF	Sayfa yüklendiğinde ses kapalı olarak başlar.
CLICK_TO_PLAY	Tıklandığında ses açık olarak başlar.
MOUSE_OVER	Fareyle üzerine gelindiğinde ses açık olarak başlar.
ENTER_SOUND_ON	Görüntü alanına girildiğinde ses açık olarak başlar.
ENTER_SOUND_OFF	Varsayılan olarak ses kapalıyken görüntü alanına girildiğinde başlar.

BidRequest.imp.video.skip

true ise oynatıcının videonun atlanmasına izin vereceğ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 gösterilen reklamı, -1 ara reklamı ve -2 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 ve BidRequest.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 DurFloors nesnelerden oluşan bir dizi.

Aşağıda, Google tarafından belirtilen durfloors için bir örnek verilmiştir:

1. $5 itibarıyla (0, 16) saniyeyi temsil eden {"maxdur": 16, "bidfloor": 5}.
2. $10 itibarıyla [16, 31) saniyeyi temsil eden {"mindur": 16, "maxdur": 31, "bidfloor": 10}.
3. $20 itibarıyla [31, inf) saniyeyi temsil eden {"mindur": 31, "bidfloor": 20}.

Bu sinyaller video reklam öğelerine özgü değildir ancak teklif verenlerin okuması için ö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. BidRequest.device.dpidm5 parametresinin şifrelenmemiş sürümüdür. iOS cihazlar için, tümü büyük harflerden oluşan Reklamverenler için Tanımlayıcı'yı (IDFA) içerir. Android cihazlar için Android tanımlayıcısını (ADID) tamamen 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ü bilgisayar cihazları içerir.
CONNECTED_TV	hem bağlı TV'leri (yani akıllı TV'ler) hem de bağlı cihazları (Roku, Apple TV vb.) içerir.
HIGHEND_PHONE	İleri teknoloji telefon cihazlarını içerir.
TABLET	Tablet cihazları içerir.
CONNECTED_DEVICE	Özel oyun cihazları dahildir.
SET_TOP_BOX	Set üstü kutu cihazları içerir.
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

Varsa cihazın tam modelini (ör. N70 veya Galaxy) belirtir, yoksa "iphone" ya da "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ş tamamlanma oranını temsil eden [0,0, 1,0] aralığında bir kesir olacaktır. Varsayılan -1.0 değeri, geçmiş tamamlanma oranı verilerinin mevcut olmadığını gösterir.

BidRequest.imp.video.poddur

Dinamik 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. Ayarlanmazsa reklam alanı bir kapsülün parçası olmaz.

Video teklif isteği, sektör, izin verilen tedarikçiler ve kanal bilgileri gibi envanterle ilgili bilgileri de içerir. 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ısının boyutuna karşılık gelir.

BidRequest.imp.ext.allowed_vendor_type

İzin verilen tedarikçiler. 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 sunulan 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

Yayıncının video reklam istekleri için desteklediği VAST sürümlerini açıklar. Aşağıdakiler de dahil olmak üzere Protocol enum değerlerinden oluşan bir dizi 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 doğru beyanı da içermelidir. Aşağıda, uygun bir video teklif yanıtının özeti verilmiştir:

id: "eW3q768m3k93fv93a80tGQ"
seatbid {
  bid {
    id: "0uMc95E6ClImM3p5FSe"
    impid: "1"
    price: 0.034745
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_168019"
    cat: "7"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 61170857882
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 30
}

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

BidResponse.seatbid.bid.ext.attribute

Bu snippet'ten gösterilebilecek reklamların özellikleri. Kimliklerin listesi için buyer-declarable-creative-attributes.txt dosyasına bakın. Bu özelliklerden hiçbirinin, teklif isteğinde yayıncı tarafından izin verilmeyen özelliklerle eşleşmediğinden emin olmak için kontrol yaparız. Örneğin, alanlardan birinde 30 varsa bu, reklamın oluşturulması için VPAID desteği gerektiği anlamına gelir.

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ı

• Örnek video teklif istekleri
• Örnek video teklif yanıtları

Atlanabilir video reklam düzeltmesi

Google, video envanteri için Gerçek Zamanlı Teklif verme tekliflerine otomatik olarak atlanabilir video reklam düzeltmesi uygular. Bu, teklif isteğinde istenen atlanabilirlik ile teklif yanıtında döndürdüğünüz reklam öğelerinin atlanabilirliği arasındaki farklar nedeniyle tekliflerinizin açık artırmadan filtrelenmesini önleyebilir. Atlanabilir video reklam düzeltmesi aşağıdaki durumlarda uygulanmaz:

• Teklif yanıtında belirttiğiniz reklam öğesi VPAID kullanılarak uygulanır. Real-Time Bidding API'deki Creative.video.videoMetadata.isVpaid alanını kullanarak hangi video reklam öğelerinizin VPAID ile uygulandığını belirleyebilirsiniz.
• Yayıncı, reklam öğesini oluşturur. Bunu, yayıncı reklam öğesini oluşturacaksa 'PUBLISHER' olan BidRequest.imp.displaymanager alanına göre belirleyebilirsiniz.

Aşağıda, atlanabilir video reklam düzeltmesinin nasıl uygulandığını açıklayan örnekler verilmiştir:

• 1. senaryo:
• JSON biçimi için 0, Protobuf biçimi için false olarak ayarlanmış BidRequest.imp.video.skip alanını içeren bir teklif isteği alırsınız.
• Atlanabilir bir reklam öğesiyle teklif verirsiniz.
• Sonuç: Teklifiniz açık artırmaya girer. Teklifiniz kazanırsa ve video reklam öğesi oluşturulursa atlanamayan olarak oluşturulur.
• 2. senaryo:
• JSON biçimi için 1, Protobuf biçimi için true olarak ayarlanmış BidRequest.imp.video.skip alanını içeren bir teklif isteği alırsınız.
• BidRequest.imp.video.skipmin alanında belirtilen süreden daha uzun süreli, atlanamayan bir reklam öğesiyle teklif verdiniz.
• Sonuç: Teklifiniz açık artırmaya girer. Teklifiniz kazanırsa ve video reklam öğesi oluşturulursa atlanabilir olarak oluşturulur.

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 videoya nasıl izin verebilir/izin vermeyebilir?
• Sıra dışı durumlar

Alıcılar nasıl video 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 yayınlanabilecekleri yerleşimler gösterilmektedir.

Web

Mobil Uygulama

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

Mobil uygulama

Yayıncılar videoya nasıl izin verebilir/videoyu nasıl engelleyebilir?

Aşağıdaki tabloda, yayıncıların yerleşimlerinde videoya izin verme/vermeme yöntemleri gösterilmektedir.

Sıra dışı durumlar

Sözlük

Authorized Buyers video 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) bölümüne bakın.

Teklif isteği değer kaynağı