Video Reklamlar

Bu kılavuzda; entegrasyon şartları, yapılandırma ve Videoya teklif verirken kullanabileceğiniz ilgili OpenRTB protokolü alanları envanter. Google GZT protokolü kullanımdan kaldırıldı ve artık odak noktası olmayacak inceleyebilirsiniz. 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. Kılavuzları göster Yerel ve Geçiş reklamı reklam biçimleri konulu videomuzu izleyin.

Alıcı şartları

GZT Protokolü

Bu kılavuz genellikle Protobuf biçimine atıfta bulunulsa da alan adları ve yolları, aksi belirtilmedikçe kendisi ile JSON biçimi arasında eşdeğerdir.

OpenRTB protokolü ve Google'a özel OpenRTB uzantılarını Protokoller ve referans verileri sayfası. Örneğin, için bir teklif vereni geliştirme hakkında daha fazla bilgi İsteği işleme koyabilir ve Yanıt Oluşturun.

Reklam öğesi incelemesi

Google, oluşturabilirsiniz. İ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 oluştur ön hedefleme yapılandırması video envanteri içerir.

Makrolar

Makroları, BidResponse.seatbid.bid.adm Ayrıca, bir video URL'si belirtirseniz bağlı VAST XML belgesine makro da yerleştirebilirsiniz. İlgili içeriği oluşturmak için kullanılan video reklam öğeleri için şu 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. Daha fazla desteklenen makrolarla ilgili bilgi edinmek için Makroları belirtin.

Açıklama metni ayrıntıları

Aşağıdakileri tanımlamak için OpenRTB'nin BidRequest.imp.video alanını kullanabilirsiniz: Gelen teklif isteğinin yayın içi veya geçiş video için olup olmadığı istekle ilgili videoya özgü ek bilgileri bulabilirsiniz. Ayrıca, yerel reklam envanteri için Şunun için BidRequest.imp.native.{request/request_native}.assets.video: videoya özel benzer bilgiler sağlar.

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

Parametreler kaldırılmış olan URL, bir sayfaya bakın. 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, oluşturulmak üzere seçilebilir. video reklam bittikten sonra video alanında bitiş resmi olarak (bilgi kartı) çalıyor. Aksi takdirde, tamamlayıcı reklam son kapak olarak oluşturulmaz.
BidRequest.imp.rwdd
. true değerine ayarlanırsa kullanıcının ödül olarak ekleyebilirsiniz. Olağan ödüllerle ilgili ekstra makale satın alma, oyunda fazladan can alma veya reklamsız müzik oturumuna dönüştürün.
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. Maksimum atlanabilir video süresi bölümünü inceleyin. inceleyebilirsiniz.

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 Daha önce oynatılan videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar Tüketicinin, video akışı sırasında veya sonrasında istendi. 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 izleme niyetini açıkça belirtmelidir. 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. Google sayfadaki birincil içerik ve tek video olarak kalmalıdır. oynatırken ses duyabilen görüntü içi oynatıcı. Oyuncu, kayan/yapışkan reklama dönüştüğünü varsayarsak, sonraki reklam çağrılarının doğru bir şekilde güncellenen oynatıcı boyutunu iletmektir.
PLCMT_ACCOMPANYING_CONTENT Daha önce oynatılan videodan önce, videonun ortasında ve videodan sonra gösterilen reklamlar video içeriği akışı sırasında veya sonrasında. Video oynatıcı yüklenir ve metin veya grafik paragraflarının öncesinde, arasında veya sonrasında 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ünüm. Sayfa 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, sayfa birincil odak noktası olmalı ve sayfanın çoğunluğunu kaydırılamaz ve görünüm dışına çıkarılamaz. Bu uygulama içi video veya slayt gösterileri gibi yerleşimler oluşturmanız gerekir.
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ğı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çıkken başlatır.
AUTO_PLAY_SOUND_OFF Sayfa yüklendiğinde ses kapalıyken başlatılır.
CLICK_TO_PLAY Tıklandığında ses açıkken başlatır.
MOUSE_OVER Ses açıkken fareyle üzerine gelindiğinde başlatılır.
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 videoya izin vereceğini belirtir veya atlanabilir reklamlara izin verildiği anlamına gelir. Aksi takdirde, atlanabilir reklamlara izin verilmediğini gösterir.
BidRequest.imp.video.startdelay

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

Başka herhangi bir pozitif değer, videoyu reklamın gösterildiği noktaya getirin.

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ılırken ayarlanan ve 36 karakterli UUID'dir. karma oluşturma işlemi uygulanmamıştır. 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 için Android tanımlayıcısını (ADID) tamamı küçük harfle karakteri ekleyin. Bağlı TV cihazlarının benzersiz tanımlayıcılarını içerir (örneğin, Roku'nun RIDA'sı).
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ı TV'leri cihazlara (ör. Roku, Apple TV vb.) izin verilmez.
HIGHEND_PHONE Yüksek kaliteli telefon cihazları dahildir.
TABLET Tablet cihazlar da dahildir.
CONNECTED_DEVICE Özel oyun cihazlarını kapsar.
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 kullanılamadığını gösterir.
BidRequest.imp.video.poddur
. Tüm alanlar dahil olmak üzere reklam arasının tamamının saniye cinsinden süresi. gösterir. 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. Tümü Teklif isteğindeki mevcut diğer alanlar video için de geçerlidir.

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 = Campaign Manager Video Birimi.
BidRequest.imp.video.mimes
. Şurada sunulan reklamlar için desteklenen içerik MIME türlerini açıklayan bir izin verilenler listesi teklif isteğine verilen yanıt; örneğin "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 sayfanın URL'si Videonun yerleştirildiği video. Örneğin:

http://www.publisher.com/watchpagelink

Teklif veren bir video isteğine yanıt verirken VAST yönlendirmesi döndürmelidir URL'sini girin veya BidResponse.seatbid.bid.adm alanına VAST XML girin. İlgili içeriği oluşturmak için kullanılan 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. Bkz. buyer-declarable-creative-attributes.txt dosyası oluşturun. Bu özelliklerden hiçbirinin mevcut olmadığından Yayıncının teklif isteğinde izin vermediği öğeleri eşleştirmelidir. Ö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 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/makale 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/makale 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 ilgili sinyaller) İlgili sinyaller (yalnızca video ile ilgili sinyaller)

Yayın içi (VPAID)

VIDEO nesnesi mevcut   &
video.placement = INSTREAM   &

Yayın içi (VPAID yok)

VIDEO nesnesi mevcut   &
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 mevcut   &
video.placement = IN-FEED

Yazı içi

VIDEO nesnesi mevcut   &
video.placement = IN-ARTICLE

Yerel biçim

YEREL nesne 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 mevcut   &
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 mevcut   &
video.placement = IN-FEED

Yazı içi

VIDEO nesnesi mevcut   &
video.placement = IN-ARTICLE

Yerel biçim

NATIVE nesnesi mevcut ve

Geçiş reklamı (VAST)

VIDEO nesnesi mevcut   &
video.placement = INTERSTITIAL

Geçiş reklamı (VAST yok)

VIDEO nesnesi mevcut   &
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

(Windows 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 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 videoya bir birim belirtme

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

Video nesnesi mevcut ve
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ştir

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 mevcut 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

Reklamın kapatılması, geçiş reklamları için özel kapatma kullanılmamış olsa bile MRAID'i kullanarak alıcıya bildirim gönderebilir.


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

Bkz. OpenRTB 2.5 (47. sayfadan itibaren)

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ı bool
linearity

Gösterimin doğrusal mı, doğrusal olmayan mı vb. olması gerektiğini gösterir. Hiçbir şey belirtilmezse tümüne izin verildiğini varsayın.

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
Nesne		 Alanlar Authorized Buyers
/Exchange
Teklif:
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ı
oynatmametresi
Hod		 evet [6] Genellikle
Yayıncı Yapılandırıldı
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
oynatıcı yüksekliği evet 225.300.153 Google
başlangıç gecikmesi evet 0 Google, varsayılan 5 sn.
atla evet 1 Yayıncı/Google
- Geçiş Reklamı için => Google
- Yayın İçi için => Yayıncı

uygulamasına izin verilip verilmeyeceğine karar verir atlanabilen, atlanamayan veya her ikisi birden.
. Ödül reklamları, her zaman atlanmaz;
minimum bit hızı Hayır Google
max bitrate hayır Google
pos evet 1 Google
Cihaz
Px 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