Video reklam desteğinin kullanıma sunulmasıyla birlikte alıcılar, Authorized Buyers aracılığıyla video envanteri satın alabilir. Bu belgede, Authorized Buyers protokolü kullanılarak GZT üzerinden satın alma için entegrasyon gereksinimleri açıklanmaktadır. Kullanılabilir protokoller hakkında bilgi için Başlangıç kılavuzunun Protokol seçme bölümüne bakın.
Alıcılar, hâlihazırda yayın içi ve geçiş reklamı olmak üzere yerleşimlerde video envanteri satın alabilir. Ayrıntılar için Geçiş Reklamları bölümüne bakın.
Alıcı şartları
Yeni GZT alıcıları, en son protokol arabelleğini ve aşağıdaki bölümlerde açıklanan bilgileri kullanarak teklif verenlerini geliştirmelidir. Protokolü indirmek için gerçek zamanlı teklif referans verileri sayfasına bakın. Teklif veren geliştirme hakkında bilgi için İsteği İşleme ve Yanıtı Oluşturma bölümlerine bakın.
Desteklenen makrolar
Aşağıdaki makrolar yayın içi video reklam öğelerinde desteklenir:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Authorized Buyers, tıklama izleyicilerini bir VAST sarmalayıcıya eklediğinden tıklama makroları (CLICK_URL_ESC
gibi) gerekli değildir.
Bu nedenle, tıklama makroları yayın içi video reklamlarda desteklenmez.
Desteklenen makrolar hakkında daha fazla bilgi için Yanıtı Oluşturma bölümünün altındaki Makroları belirtme bölümüne bakın.
Açıklama metni ayrıntıları
Gerçek zamanlı teklif protokolü, video isteklerini tanımlamak ve istek hakkında videoya özgü ek bilgiler sağlamak için real-time-bidding-proto.txt dosyasında tanımlanan bir video mesaj kullanır.
İç içe yerleştirilmiş video mesajındaki alanların listesi de ayrıntılı açıklamalar ve örnekler sağlar:
description_url
-
Video içeriğini açıklayan sayfanın, parametreleri kaldırılmış olarak URL'si. Yayıncı bu URL'yi Google'a gönderir. Örneğin:
http://www.publisher.com/watchpagelink
EndCapSupport
-
Etkinleştirildiğinde tamamlayıcı reklam, video reklamın oynatılması tamamlandıktan sonra video alanında bitiş resmi (bilgi kartı) olarak oluşturulmak üzere seçilebilir.
END_CAP_NOT_ENABLED
Tamamlayıcı reklam, bitiş resmi olarak oluşturulmadı. END_CAP_OPTIONAL
Yanıt uygun bir tamamlayıcı banner içeriyorsa ancak tamamlayıcı banner gerekli değilse bitiş sınırı oluşturulur. END_CAP_FORBIDDEN
Tamamlayıcı reklam içeren bir yanıt filtrelenir. END_CAP_REQUIRED
Tamamlayıcı reklam içermeyen bir yanıt filtrelenir. is_embedded_offsite
-
Bu ayar
true
olarak ayarlanırsa video, yayıncının alanının dışındaki sayfalara yerleştirilir. is_rewarded
-
true
olarak ayarlanırsa kullanıcının video reklamı görüntülemesi için bir ödül kazandığını gösterir. Genel ödüller, ek bir makale ücretsiz okumak, oyunda ekstra can kazanmak veya sponsorlu reklamsız müzik oturumu elde etmek olabilir. max_ad_duration
-
Döndürülen reklam için milisaniye cinsinden izin verilen maksimum süre.
0
olarak ayarlandığında maksimum süre olmaz. max_ads_in_pod
- Authorized Buyers video kapsülündeki maksimum reklam sayısı. Sıfır olmayan bir değer, geçerli reklam alanının birden fazla video reklam gösterebilen bir video kapsülü olduğunu gösterir. Gösterilen video reklamların gerçek sayısı bu değerden az veya bu değere eşit olabilir ancak bu değeri aşamaz.
min_ad_duration
- Döndürmeniz gereken reklamın milisaniye cinsinden minimum süresi. Bu ayarlanmazsa veya sıfıra eşit ya da daha küçük bir değere sahipse minimum süre yoktur.
Placement
-
Videonun nerede oynatılacağını açıklar.
UNKNOWN_PLACEMENT
Yerleşim bilinmiyor veya belirlenemiyor. INSTREAM
Yayın içi, reklamın diğer video içeriği oynatılmadan önce, oynatılırken veya oynatıldıktan sonra oynatılacağı anlamına gelir. Bu, geleneksel bir TV reklamına benzer. Kullanıcının izlediği video içeriği, reklam oynatılırken oynatılmıyor. INTERSTITIAL
Geçiş reklamı, video reklamın video olmayan içeriğin (örneğin bir haber makalesi veya video oyunu) önünde oynatılması anlamına gelir. Reklam, ekranda içeriğin kapladığı alanın tamamını veya neredeyse tamamını kaplar ve kullanıcı, reklam bitene veya atlanana kadar içeriğe devam edemez. IN_FEED
Feed içi video biçimi, kullanıcı bir içerik feed'inde (genellikle sosyal uygulama feed'i, haber makalesi vb.) gezinirken gösterilen bir video reklam öğesidir. Video, ana feed'de ve kullanıcının vizyon ve okuma akışında oluşturulur. Video, banner içi video gibi yan tarafa oluşturulmaz. skippable_max_ad_duration
- Bu reklam atlanabilir ise döndürmeniz gereken reklamın milisaniye cinsinden maksimum süresi. Bu, genellikle atlanamayan reklamlar için izin verilen maksimum süreden farklıdır. Bu alan ayarlanmazsa veya sıfıra eşit ya da daha küçük bir değere sahipse tüm süreye izin verilir.
VideoPlaybackMethod
-
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
reklamın, ses açıkken otomatik olarak oynatılacağı anlamına gelir. AUTO_PLAY_SOUND_OFF
reklamın, ses kapalıyken otomatik olarak oynatılacağı anlamına gelir. CLICK_TO_PLAY
reklamın tıklanana kadar oynatılmadığı anlamına gelir. video_ad_skippable
- Bu, aşağıdaki değerlerden birini içeren bir
SkippableBidRequestType
değeridir:ALLOW_SKIPPABLE
hem atlanabilir hem de atlanamayan reklamlara izin verildiği anlamına gelir. REQUIRE_SKIPPABLE
yalnızca atlanabilir reklamların döndürülebileceği anlamına gelir. BLOCK_SKIPPABLE
yalnızca atlanamayan reklamların döndürülebileceği anlamına gelir. Bu alan ayarlanmazsa varsayılan olarak atlanabilir reklamlara izin verilir.
videoad_start_delay
-
Videonun başlangıcından reklamın görüntülendiği noktaya kadar geçen süre (milisaniye cinsinden). 0 videodan önce gösterilen reklam, -1 ise videodan sonra gösterilen reklam anlamına gelir. Diğer pozitif değerler, alanın videonun ortasında olduğunu gösterir.
Değer, yalnızca bu parametre ayarlanmışsa geçerli olur. Ayarlanmadığında ekran konumu bilinmiyor.
Bu sinyaller, video reklam öğelerine özel değildir ancak teklif verenlerin aşağıdakileri okuması için özellikle değerlidir:
advertising_id
- Bu alan yalnızca SSL kullanılırken ayarlanan 16 baytlık bir UUID'dir.
Bu,
encrypted_advertising_id
tarayıcısının şifrelenmemiş sürümüdür. iOS cihazlarda Reklamverenler için Tanımlayıcı (IDFA) bulunur. Android cihazlarda Android tanımlayıcısını (ADID) içerir. Bağlı TV cihazlarının benzersiz tanımlayıcılarını içerir (örneğin, Roku'nun RIDA'sı). device_type
- Cihazın türünü belirtir.
UNKNOWN_DEVICE
bu alanın varsayılan değeridir. HIGHEND_PHONE
video özellikli cep telefonlarını içerir. TABLET
tablet cihazları da içerir. PERSONAL_COMPUTER
masaüstü ve dizüstü cihazları kapsar. CONNECTED_TV
Hem bağlı TV'leri (yani akıllı TV'ler) hem de bağlı cihazları (Roku, Apple TV vb.) içerir. GAME_CONSOLE
özel oyun cihazları da dahildir. brand
- Cihazın markasını (Nokia veya Samsung gibi) belirtir. Bu alan isteğe bağlıdır ve varsayılan olarak belirtilmemiştir.
model
- Cihazın tam modelini (N70 veya Galaxy gibi) belirtir. Bu alan isteğe bağlıdır ve varsayılan olarak belirtilmemiştir.
screen_orientation
-
Reklam isteği gönderildiğinde cihazın yönünü belirtir.
Geçerli değerler
LANDSCAPE
,PORTRAIT
veUNKNOWN_ORIENTATION
'dir. viewability
-
Bu alanın, geçmişte ne sıklıkta görüntülenebilir olduğuna bağlı olarak son kullanıcı tarafından görüntülenebilir olma olasılığına dair bir tahmin sunar. [0, 100] aralığındaki bir yüzde olarak ifade edilir. Varsayılan değer olan
-1
, geçmiş görüntülenebilirlik verilerinin mevcut olmadığını gösterir. content_attributes.duration_seconds
-
Videonun kaç saniye oynatıldığı (ör. 200 saniye).
Bu,
ContentAttributes
mesajında beyan edilir. 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çi firmalar ve kanal bilgileri gibi envanter hakkında bilgiler de içerir. Teklif isteğindeki diğer tüm alanlar video için de geçerlidir.
Video isteğinin AdSlot mesajındaki genişlik ve yükseklik alanları, video reklam oynatıcının boyutuna karşılık gelir.
allowed_vendor_type
- İzin verilen tedarikçi firma. Kimliklerin listesi için teknik dokümanlardaki vendors.txt dosyasına bakın. Örneğin, 309 = DFA Video Birimi.
allowed_video_formats
-
Bu isteğe yanıt olarak yayınlanan reklamlar için izin verilen video teknolojilerini açıklar.
Yanıtta bu kullanıcılardan en az birinin desteklendiği belirtilmelidir.
Bu tekrarlanan alanın değerleri, VideoFormat sıralamasından gelir:
VIDEO_FLASH
Videoların Flash Video (FLV) biçimini kullanmasına izin verir. VIDEO_HTML5
HTML5 video biçimini kullanan videolara izin verir. VPAID_FLASH
Video Oynatıcı Reklam Sunma Arayüzü Tanımı (VPAID) Flash video biçimini kullanan videolara izin verir. VPAID_JS
VPAID JavaScript video biçimini kullanan videolara izin verir. companion_slot
-
Bu alan, aşağıdaki alanları içeren bir CompanionSlot mesajını temsil eder:
height
Bu alan için kullanılabilecek yükseklikler. width
Bu alan için kullanılabilecek genişlikler. CreativeFormat
Reklam öğesi biçimi, bu tamamlayıcı alandaki reklam öğesi için olası biçimleri temsil eder. url
-
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, video isteğine yanıt verirken video_url
alanında VAST yönlendirme URL'si döndürmelidir.
Teklif yanıtı, video reklam için uygun bildirimi de içermelidir.
Aşağıda, uygun bir video teklif yanıtının özeti verilmiştir:
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
Video teklif yanıtındaki önemli alanlar şunlardır:
attribute
-
Bu snippet'ten gösterilebilecek reklamlara ilişkin tüm özellikler. Kimlik listesi için
buyer-declarable-creative-attributes.txt dosyasına bakın.
Bu özelliklerden hiçbirinin Teklif İsteğinin
excluded_attribute
listesinde olmadığından emin olun. Bu alanı yalnızca bir HTML snippet'i veya video reklam döndürülürse ayarlayın. Örneğin, bu alanın30
olarak ayarlanması, reklamın oluşturulması için VPAID desteği gerektirdiğini belirtir. protocol
-
Yayıncının video reklam istekleri için desteklenen VAST sürümlerini tarif ederek belirtilen sürüm dahil olmak üzere VAST reklamlarına izin verir.
Desteklenen bir dizi video reklam protokolü içerir.
OpenRTB 2.4'teki davranışa karşılık gelir ve bu davranışla eşleşir.
Şu değerler gösterilebilir:
VAST_2_0
,VAST_3_0
,VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
veVAST_4_0_WRAPPER
. video_url
-
Video reklamın VAST yönlendirme URL'si. Örneğin:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
- Alıcılar nasıl video ekleyebilir?
- Tüm video biçimleri için OpenRTB tarafından önerilen sinyaller
- Authorized Buyers protokolü, tüm video biçimleri için önerilen sinyaller
- Yayıncılar videolara nasıl izin verebilir veya videolara nasıl izin vermeyebilir?
- Uç destek kayıtları
Ön hedefleme
Video envanteri almak için GZT alıcıları, video envanterini içeren GZT için bir ön hedefleme yapılandırmasına sahip olmalıdır.
Örnek teklif istekleri ve yanıtları
AdX Video Biçimleri
Alıcılar videoyu nasıl dahil edebilir?
Aşağıdaki tablolarda, alıcıların web ve mobil uygulama için reklam öğelerine ve yerleşimlere video ekleyebilecekleri yöntemler gösterilmektedir.
Web
Video reklam öğesi | Yayın içi (tümü) | Feed içi/makale | Yerel feed içi/makale | Geçişli | 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/makale | Yerel feed içi/makale | Geçişli | Banner içi |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
Özel JS |
|||||
Yerel + VAST |
Anahtar: | Biçim/teknoloji kullanılamıyor | Bu yerleşimde kabul edilen video reklam öğesi, yayıncı engellemelerine tabi |
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çimleri için OpenRTB tarafından önerilen sinyaller gösterilmiştir.
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 (VPAID) |
VIDEO nesnesi mevcut & |
|
Yayın içi (VPAID yok) |
VIDEO nesnesi mevcut & |
|
Yayın dışı |
VIDEO nesnesi mevcut
|
|
Feed içi |
VIDEO nesnesi mevcut & |
|
Yazı içi |
VIDEO nesnesi mevcut & |
|
Yerel biçim |
NATIVE nesne mevcut ve |
|
Banner içi |
Video nesnesi yok ve |
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 dışı |
VIDEO nesnesi mevcut
|
|
Feed içi |
VIDEO nesnesi mevcut & |
|
Yazı içi |
VIDEO nesnesi mevcut & |
|
Yerel biçim |
NATIVE nesne mevcut ve |
|
Geçiş reklamı (VAST) |
VIDEO nesnesi mevcut & |
|
Geçiş reklamı (VAST yok) |
VIDEO nesnesi mevcut & |
Filtrelendi |
Banner içi (MRAID) |
Video nesnesi yok & |
|
Banner içi (MRAID yok) |
Video nesnesi yok & |
AdX protokolü için önerilen sinyaller
Aşağıdaki tablolarda, masaüstü ve mobil web ile mobil uygulama için tüm video biçimleri için Authorized Buyers protokolü önerilen sinyalleri gösterilmiştir.
Masaüstü ve Mobil web
Video biçimi | Önerilen videoyla alakalı sinyaller | Videoyla alakalı ilgili sinyaller |
---|---|---|
Yayın İçi (VPAID) |
VİDEO mesaj mevcut & |
|
Yayın içi (VPAID yok) |
VİDEO mesaj mevcut & |
Allowed_video_formats = VIDEO_HTML5 & |
Feed içi |
VİDEO mesaj mevcut & |
Allowed_video_formats = VIDEO_HTML5 & |
Yazı içi |
VİDEO mesaj mevcut & |
|
Yerel biçim |
Yerel mesajda NATIVE mesajı mevcut & |
|
Banner içi |
|
|
Mobil uygulama
Aşağıdaki tablolarda, masaüstü ve mobil web ile mobil uygulama için tüm video biçimlerine yönelik AdX protosu için önerilen sinyaller gösterilmektedir.
Video biçimi | Video ile ilgili teklif isteği ayrıntıları | Videoyla alakalı ilgili sinyaller |
---|---|---|
Yayın içi |
VIDEO mesaj mevcut |
|
Feed içi |
VİDEO mesaj mevcut & |
|
Yazı içi |
VİDEO mesaj mevcut & |
|
Yerel biçim |
Yerel mesajda NATIVE mesajı mevcut & |
|
Geçişli |
VİDEO mesaj mevcut & |
|
Banner içi (MRAID) |
|
|
Banner içi (MRAID yok) |
|
|
Yayıncılar videolara nasıl izin verebilir/izin vermeyebilir?
Aşağıdaki tablolarda, yayıncıların yerleşimlerinde videolara izin vermek veya vermemek için kullanabilecekleri yöntemler ve videonun OpenRTB ve AdX Proto için teklif isteğinde nasıl ortaya çıktığı gösterilmektedir.
OpenRTB
Yayınlama seçeneği | Geçerli biçimler | Teklif isteğinde şu şekilde açıklanır: |
---|---|---|
Yayın içi video reklam birimi belirtme |
Yayın içi (tümü) |
Video nesnesi mevcut ve |
VPAID'i etkinleştir |
Yayın içi web |
Video nesnesi mevcut ve |
IBV'yi etkinleştir |
Banner içi Geçişli |
|
Yayın dışı reklamları etkinleştirme (instructions) |
Feed içi Yazı içi |
Video nesnesi mevcut ve |
Yayın dışı reklamları etkinleştirme (instructions) |
Yerel biçim |
Yerel nesne mevcut |
Video geçiş reklamını engelleme |
Geçiş reklamı uygulaması |
VIDEO nesnesi mevcut değil |
AdX Protokolü
Yayınlama seçeneği | Geçerli biçimler | Teklif isteğinde şöyle açıklanmıştır (NOT: Bunlar, teklif isteğindeki yayıncı seçeneğinin TÜM göstergeleridir. Önerilen sinyaller için aşağıdaki tabloya bakın) | Varsayılan ayar |
---|---|---|---|
Yayın içi video reklam birimi belirtme |
Yayın içi (tümü) |
Video mesaj mevcut ve |
Yok |
VPAID'i etkinleştir |
Yayın içi web |
Video mesaj mevcut ve
|
Devre dışı |
IBV'yi etkinleştir |
Banner içi Geçişli |
|
Devre dışı |
Yayın Dışı reklamları etkinleştirme (instructions) |
Feed içi Yazı içi |
Video mesaj mevcut ve |
Devre dışı |
Yayın Dışı reklamları etkinleştirme (instructions) |
Yerel biçim |
NATIVE mesajı mevcut ve Yerel mesajda |
Devre dışı |
Video geçiş reklamını engelleme |
Geçiş reklamı uygulaması |
VİDEO mesaj yok ve |
Etkin |
Sıra dışı durumlar
# | Destek Kaydı Açıklaması | Yorum sayısı | Teklif isteği |
---|---|---|---|
1 |
MRAID kullanılarak geciken özel kapanış |
Geçiş reklamlarında reklamın kapatılması, özel kapatma kullanmamış olsa bile MRAID kullanarak Alıcı'ya bildirim gönderebilir. Uygulanan AdX X işareti, özel kapatma işlemi 5 saniye sonra gerçekleşse bile her zaman herhangi bir özel kapatma işleminin en üstünde gösterilir. |
Sözlük
Authorized Buyers video sözlüğüne bakın.
Yayın İçi ve Yayın Dışı biçimlerindeki AdX ve OpenRTB alanları
AdX Protokolü
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
OpenRTB Protokolü
OpenRTB 2.5 (sayfa 47'den itibaren) konusuna bakın.
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
Gösterimin doğrusal, doğrusal olmayan vb. olması gerekip gerekmediğini belirtir. Herhangi bir gösterim belirtilmezse hepsine izin verildiğini varsayın.
|
||||
videoad_start_delay
|
|
Teklif isteği değer kaynağı
OpenRTB Nesnesi | Alanlar | AdX /Exchange Teklif Verme Yayın Dışı |
Örnek Değerler | Bunu kim belirliyor? /Bu değer nereden geliyor? |
---|---|---|---|---|
Nesne | ||||
Video | MIME'ler | evet | ["application/javascript", "video/mp4"]", |
|
minimum süre | no | Yayıncı Yapılandırıldı | ||
maksimum süre | evet | Yayıncı Yapılandırıldı | ||
oynatmamet hod |
evet | [6] | Yayıncı Genellikle Yapılandırılı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 | ||
oynatıcı yüksekliği | evet | 225,300,153 | ||
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ı , atlanabilir, atlanamayan veya her ikisine birden izin verip vermeyeceğinize karar verir. Ödüllü reklamlar, daima atlanmaz; |
|
dk. bit hızı | Hayır | |||
maks. bit hızı | no | |||
pos | evet | 1 | ||
Cihaz | ||||
Px oranı | evet | 1 | ||
gösterim | ||||
Güvenli | evet | 1 | Reklam etiketi her zaman güvenli olduğu için Google varsayılan olarak true değerine ayarlanır |