Video reklam desteğinin kullanıma sunulmasıyla birlikte alıcılar Authorized Buyers aracılığıyla video envanteri satın alabilir. Bu belgede, gerçek zamanlı teklif verme (GZT) üzerinden satın alma için entegrasyon gereksinimleri Authorized Buyers protokolünü kullanarak. Kullanılabilir protokoller hakkında bilgi için Protokol seçme bölümünde bulabilirsiniz.
Alıcılar, tüm yerleşimlerde video envanteri satın alabilir, şu anda yayın içi ve geçiş reklamı olarak gösteriliyor. Bkz. Geçiş Reklamları'nı inceleyin.
Alıcı şartları
Yeni GZT alıcıları, teklif verenlerini en son protokol arabelleğini kullanarak geliştirmelidir ve aşağıdaki bölümlerde özetlenen bilgilere bakın. Protokolü indirmek için gerçek zamanlı teklif verme referans verileri sayfasına bakın. Teklif vereni geliştirme hakkında bilgi için İsteği İşleme adlı makaleyi inceleyin ve Yanıt Oluşturun.
Desteklenen makrolar
Yayın içi video reklam öğelerinde aşağıdaki makrolar desteklenir:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Tıklama makroları (CLICK_URL_ESC
gibi) gerekli değil
çünkü Authorized Buyers, tıklama izleyicilerini bir VAST paketine ekler.
Bu nedenle, yayın içi video reklamlarda tıklama makroları desteklenmez.
Desteklenen makrolar hakkında daha fazla bilgi için
Makroları belirtme adlı makaleyi inceleyin
Yanıtı Oluştur'u tıklayın.
Açıklama metni ayrıntıları
Gerçek zamanlı teklif verme protokolü, real-time-bidding-proto.txt dosyasını kullanın ve istek hakkında videoya özgü ek bilgiler sağlayın.
İç içe yerleştirilmiş video mesajda bulunan alanların listesi ayrıntılı açıklamalara ve örneklere de yer verir:
description_url
-
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
EndCapSupport
- .
Etkinleştirildiğinde tamamlayıcı reklam seçilebilir
video alanında bitiş resmi olarak (bilgi kartı) oluşturulacak
Video reklamın oynatılması bittikten sonra.
END_CAP_NOT_ENABLED
Tamamlayıcı reklam, bitiş resmi olarak oluşturulmaz. END_CAP_OPTIONAL
Yanıt, uygun bir anahtar kelime içeriyorsa bitiş resmi oluşturulur ancak tamamlayıcı banner gerekli değildir. END_CAP_FORBIDDEN
Tamamlayıcı reklam içeren yanıtlar filtrelenir. END_CAP_REQUIRED
Tamamlayıcı reklam içermeyen yanıtlar filtrelenir. is_embedded_offsite
- .
true
olarak ayarlanırsa Video, yayıncının alanı dışındaki sayfalara yerleştirilmişse. is_rewarded
- .
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. max_ad_duration
-
Döndürülen reklam için milisaniye cinsinden izin verilen maksimum süre.
0
olarak ayarlandığında maksimum süre yoktur. max_ads_in_pod
- . Authorized Buyers video kapsülündeki maksimum reklam sayısı. Sıfır olmayan bir değer, mevcut reklam alanının bir video kapsülü olduğunu gösterir. video reklam gösterebiliyor. Gösterilen video reklamların gerçek sayısı: ondan küçük veya ona eşittir ancak bunu aşamaz.
min_ad_duration
- . Reklamın, milisaniye cinsinden döndürmeniz gereken minimum süresi. Bu ayarlanmazsa veya sıfıra eşit ya da sıfırdan küçük bir değere sahipse minimum süre yoktur.
Placement
- .
Videonun nerede oynatılacağını açıklar.
UNKNOWN_PLACEMENT
Yerleşim bilinmiyor veya belirsiz. INSTREAM
Yayın içi, reklamın başka bir yayın öncesinde, sırasında veya sonrasında oynatılması anlamına gelir. video içeriği. Bu, geleneksel bir TV reklamına benzer. Kullanıcının izlediği video içeriği, reklam oynatılıyor. INTERSTITIAL
Geçiş reklamı, video reklamın ekranın video olmayan içerik (örneğin, haber makalesi veya video oyunu). Reklam, ekrandaki alanın tamamını veya neredeyse tamamını kaplar içerikle yer kaplıyor ve kullanıcı işleme devam edemiyor. reklam tamamlanana veya atlanana kadar bu içeriğin devam etmesi gerekir. IN_FEED
Feed içi video biçimi, kullanıcı içerik feed'i (genellikle bir sosyal medya uygulaması feed'i) makale vb. gösterilir. Video, ana özet akışında ve kullanıcının görme ve okuma akışı üzerinde çalışıyor. Video, videoda olduğu gibi kenara yansıtılmıyor banner içi video. skippable_max_ad_duration
- . Reklamın milisaniye cinsinden maksimum süresi Bu reklam atlanabilirse döndürmeniz gereken bir satırdır. Bu, genellikle maksimum süreden farklıdır. atlanamayan reklamlarda kullanılabilir. Bu alan ayarlanmazsa veya sıfırdan küçük ya da sıfıra eşit bir değere sahipse herhangi bir süreye izin verilir.
VideoPlaybackMethod
- .
Video reklamın nasıl oynatılacağını açıklar.
Oynatma yönteminin otomatik oynat veya tıkla oynat olarak belirlendiği belirlenirse
e-tablonuz otomatik olarak oluşturulur.
AUTO_PLAY_SOUND_ON
reklamın ses açıkken otomatik olarak oynatıldığı anlamına gelir. AUTO_PLAY_SOUND_OFF
reklamın ses kapalıyken otomatik olarak oynatıldığı anlamına gelir. CLICK_TO_PLAY
reklamın, tıklanana kadar oynatılmayacağı anlamına gelir. video_ad_skippable
- Bu,
SkippableBidRequestType
değeridir şu değerlerden birini içeren bir URL oluşturun: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 itibaren milisaniye cinsinden süre reklamın gösterildiği noktaya kadar gelir. 0 videodan önce gösterilen reklam ve -1 videodan sonra gösterilen reklam anlamına gelir. Diğer tüm pozitif değerler alanı belirtir videonun ortasındadır.
Değer, yalnızca bu parametre ayarlanmışsa geçerlidir. Ayarlanmazsa görüntüleme konumu bilinmiyor.
Bu sinyaller video reklam öğelerine özel değildir, ancak teklif verenlerin aşağıdakileri okuması özellikle değerlidir:
advertising_id
- Bu alan, yalnızca SSL kullanılırken ayarlanan 16 baytlık bir UUID'dir.
Bu,
encrypted_advertising_id
ürününün şifrelenmemiş sürümüdür. iOS cihazlarda Reklamverenler için Tanımlayıcı (IDFA) içerir. 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 için varsayılan değerdir. HIGHEND_PHONE
video özellikli cep telefonları da dahildir. TABLET
tablet cihazları da içerir. PERSONAL_COMPUTER
masaüstü ve dizüstü cihazlar dahildir. CONNECTED_TV
her iki bağlı TV'yi (yani akıllı TV'leri) içerir ve bağlı cihazlara (ör. Roku, Apple TV vb.) dokunun. GAME_CONSOLE
özel oyun cihazları dahildir. brand
- Cihazın markasını (ör. Nokia veya Samsung) belirtir. Bu alan isteğe bağlıdır. varsayılan olarak belirtilmemiştir.
model
- Cihazın tam modelini (ör. N70 veya Galaxy) belirtir. Bu alan isteğe bağlıdır. 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
. viewability
- .
Bu zaman aralığı için olasılık hakkında bir tahmin sunar.
ne sıklıkla görüntülere sahip olduğuna bağlı olarak son kullanıcı
görüntülenebilirdi. Yüzde olarak ifade edilir
[0, 100] aralığındadır. Varsayılan değer
-1
geçmiş görüntülenebilirlik verilerinin mevcut olmadığını gösterir. content_attributes.duration_seconds
- .
Videonun kaç saniye oynatıldığı (ör. 200).
Bu,
ContentAttributes
mesajında beyan edilmiştir. Bu, video meta verilerinde belirtilen değere ayarlanır video yayıncısı tarafından sağlanır.
Video teklif isteği, envanter hakkında bilgiler de içerir. Örneğin sektör, izin verilen tedarikçi firmalar ve kanal bilgileri gibi. 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.
allowed_vendor_type
- . İzin verilen tedarikçi firma. Bkz. vendors.txt dosyasına bakın. Örneğin, 309 = Campaign Manager Video Birimi.
allowed_video_formats
- .
İzin verilen video teknolojilerini açıklar
bu isteğe yanıt olarak sunulan reklamlar için geçerlidir.
Yanıtta, en az birinin desteklendiği belirtilmelidir.
Bu tekrarlanan alanın değerleri, VideoFormat numaralandırmasından gelir:
VIDEO_FLASH
Flash Video (FLV) biçimini kullanan videolara izin verir. VIDEO_HTML5
HTML5 video biçimini kullanan videolara izin verir. VPAID_FLASH
Video Oynatıcı Reklam Sunumunu kullanarak videolara izin verir Arayüz Tanımı (VPAID) Flash video biçimi. VPAID_JS
Şu etiketi kullanan videolara izin verir: VPAID JavaScript video biçimi. companion_slot
- .
Bu alan bir CompanionSlot mesajını temsil eder
şu alanları içerir:
height
Bu alan için kullanılabilir yükseklikler. width
Bu alan için kullanılabilir genişlikler. CreativeFormat
Reklam öğesi biçimi, olası biçimleri temsil eder bu tamamlayıcı alandaki reklam öğesidir. url
-
Video izleme sayfasının URL'si veya sayfanın URL'si Videonun yerleştirildiği video. Örneğin:
http://www.publisher.com/watchpagelink
Video isteklerine yanıt verirken
teklif verenin bir VAST yönlendirme URL'si döndürmesi gerekir
video_url
alanına girin.
Teklif yanıtı,
Video reklam için uygun beyan.
Aşağıda uygun bir video teklif yanıtının bir özeti bulunmaktadır:
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 reklamlar için tüm özellikler. Bkz.
alıcı-declarable-creative-attributes.txt dosyasını yükleyin.
Bu özelliklerden hiçbirinin
excluded_attribute
listesi. Bu alanı yalnızca HTML snippet'i veya video reklam döndürülürse ayarlayın. Örneğin, bu alanın30
değerine ayarlanması, Reklamın oluşturulması için VPAID desteği gerekiyor. protocol
- .
Video reklam istekleri için yayıncının desteklediği VAST sürümlerini açıklar.
belirtilen sürüm de dahil olmak üzere VAST reklamlarına izin verme
Desteklenen bir video reklam protokolleri dizisi içerir.
Bu, OpenRTB 2.4'teki davranışa karşılık gelir ve bu davranışla eşleşir.
Aşağıdaki 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. Örnek:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
. 'nı inceleyin.
- Alıcılar videoyu nasıl ekleyebilir?
- Tüm video biçimleri için OpenRTB tarafından önerilen sinyaller
- Authorized Buyers tüm video biçimleri için önerilen sinyaller protokolü
- Yayıncılar videoya nasıl izin verebilir veya videoya nasıl izin vermeyebilir?
- Uç durumlar
Ön hedefleme
Video envanteri almak için GZT alıcılarının bir ön hedefleme yapılandırması video envanteri içeren GZT için geçerlidir.
Örnek teklif istekleri ve yanıtlar
AdX Video Biçimleri
Alıcılar videoyu nasıl ekleyebilir?
Aşağıdaki tablolarda, alıcıların reklam öğelerine video ekleyebilecekleri ve web ve mobil uygulama için sunulabilecek yerleşimleri belirler.
Web
Video reklam öğesi | Yayın içi (tümü) | Feed içi/makale | Yerel feed içi/makale | Geçiş reklamı | Banner içi |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
PPID + 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ş reklamı | Banner içi |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
PPID + JS |
|||||
Özel JS |
|||||
Yerel + VAST |
Anahtar: | Biçim/teknoloji mevcut değil | Video reklam öğesi bu yerleşimde kabul edilir, yayıncı engellemelerine tabidir |
Video reklam öğesi bu yerleşimde kullanılamıyor |
---|
Önerilen OpenRTB sinyalleri
Aşağıdaki tablolarda, OpenRTB tarafından önerilen tüm video biçimleri için masaüstü ve mobil web ve mobil uygulama.
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 & |
|
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 |
YEREL 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 |
YEREL nesne mevcut ve |
|
Geçiş reklamı (VAST) |
VIDEO nesnesi mevcut & |
|
Geçiş reklamı (VAST yok) |
VIDEO nesnesi mevcut & |
Filtrelenen |
Banner içi (DFP) |
Video nesnesi yok ve |
|
Banner içi (Windows yok) |
Video nesnesi yok ve |
AdX protokolü önerilen sinyalleri
Aşağıdaki tablolarda, Display & Video 360'taki tüm video biçimleri için Authorized Buyers protokolünde önerilen sinyaller gösterilmektedir masaüstü ve mobil web ile mobil uygulama
Masaüstü ve Mobil web
Video biçimi | Videoyla alakalı önerilen sinyaller | Videoyla alakalı ilgili sinyaller |
---|---|---|
Yayın iç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 mesaj mevcut & |
|
Banner içi |
|
|
Mobil uygulama
Aşağıdaki tablolarda, masaüstü ve mobil web ile mobil uygulama
Video biçimi | Videoyla alakalı teklif isteği ayrıntıları | Videoyla alakalı ilgili sinyaller |
---|---|---|
Yayın içi |
VİDEO mesaj mevcut |
|
Feed içi |
VİDEO mesaj mevcut & |
|
Yazı içi |
VİDEO mesaj mevcut & |
|
Yerel biçim |
YEREL mesaj mevcut & |
|
Geçiş reklamı |
VİDEO mesaj mevcut & |
|
Banner içi (DFP) |
|
|
Banner içi (Windows yok) |
|
|
Yayıncılar videolara nasıl izin verebilir veya videolara nasıl izin vermeyebilir?
Aşağıdaki tablolar, yayıncıların ve bunun bir reklam grubu için teklif isteğinde OpenRTB ve AdX Proto.
OpenRTB
Pub seçeneği | Geçerli biçimler | Teklif isteğinde şu şekilde açıklanır: |
---|---|---|
Yayın içi videoya bir birim 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ş reklamı |
|
Yayın dışı özelliğini etkinleştirme (talimatlar) |
Feed içi Yazı içi |
Video nesnesi mevcut ve |
Yayın dışı özelliğini etkinleştirme (talimatlar) |
Yerel biçim |
Yerel nesne mevcut |
Video geçiş reklamını engelleme |
Geçiş reklamı uygulaması |
VIDEO nesnesi yok |
AdX Protokolü
Pub seçeneği | Geçerli biçimler | Teklif isteğinde şöyle açıklanır (NOT: Bunlar, teklif isteği - Önerilen sinyaller için aşağıdaki tabloya bakın) | Varsayılan ayar |
---|---|---|---|
Yayın içi videoya bir birim 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ş reklamı |
|
Devre dışı |
Yayın dışı'na dahil olmayı seçme (talimatlar) |
Feed içi Yazı içi |
Video mesaj mevcut ve |
Devre dışı |
Yayın dışı'na dahil olmayı seçme (talimatlar) |
Yerel biçim |
YEREL mesaj mevcut ve Yerel mesajda |
Devre dışı |
Video geçiş reklamını engelleme |
Geçiş reklamı uygulaması |
VİDEO mesajı mevcut değil ve |
Etkinleştirdi |
Sıra dışı durumlar
# | Destek Kaydı Açıklaması | Yorumlar | Teklif isteği |
---|---|---|---|
1 |
Googlebot kullanılarak gecikmeli özel kapatma |
Geçiş reklamlarında, reklamın kapatılması MRAID üzerinden Alıcı'ya bir bildirim gönderebilir. hiç kullanmasalar bile. AdX tarafından uygulanan X, özel kapatma işlemi gerçekleşse bile her zaman özel kapatmaların üzerinde görünür. 5 saniye sonra altında görünür |
Sözlük
Bkz. Authorized Buyers video sözlüğü.
Yayın İçi ve Yayın Dışı biçimlerindeki AdX ve OpenRTB alanları
AdX Protokolü
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
OpenRTB Proto
Bkz. OpenRTB 2.5 (47. sayfadan itibaren)
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
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.
|
||||
videoad_start_delay
|
|
Teklif isteği değer kaynağı
OpenRTB Nesne | Alanlar | AdX /Exchange Teklif: Yayın dışı |
Örnek Değerler | Bunu kim belirliyor? . /Bu değerin türetildiği yerler nereden? |
---|---|---|---|---|
Nesne | ||||
Video | pandomimler | evet | ["application/javascript", "video/mp4"]", |
|
Minduration | hayır | Yayıncı Tarafından Yapılandırılan | ||
maxduration | evet | Yayıncı Tarafından Yapılandırılan | ||
oynatmametresi Hod |
evet | [6] | Genellikle Yayıncı Yapılandırıldı |
|
api (Googlebot) | 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ı uygulamasına izin verilip verilmeyeceğine karar verir atlanabilen, atlanamayan veya her ikisi birden. . Ödül reklamları, her zaman atlanmaz; |
|
min bit hızı | Hayır | |||
maks. 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ğerine ayarlanır çünkü reklam etiketi her zaman güvenli |