Dengan peluncuran dukungan iklan video, pembeli dapat membeli inventaris video melalui Authorized Buyers. Dokumen ini menguraikan persyaratan integrasi untuk pembelian melalui RTB menggunakan protokol Authorized Buyers. Untuk informasi tentang protokol yang tersedia, lihat Pilih protokol di panduan Memulai.
Pembeli dapat membeli inventaris video di berbagai penempatan, saat ini in-stream dan interstisial. Lihat Iklan Interstisial untuk mengetahui detailnya.
Persyaratan pembeli
Pembeli RTB baru harus mengembangkan bidder mereka menggunakan buffering protokol terbaru dan informasi yang diuraikan di bagian berikut. Untuk mendownload protokol, lihat halaman data referensi bidding real-time. Untuk mengetahui informasi tentang cara mengembangkan bidder, lihat Memproses Permintaan dan Buat Respons.
Makro yang didukung
Makro berikut didukung di materi iklan video in-stream:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Makro klik (seperti CLICK_URL_ESC
) tidak diperlukan
karena Authorized Buyers menyertakan pelacak kliknya dalam kode wrapper VAST.
Oleh karena itu, makro klik tidak didukung untuk iklan video in-stream.
Untuk informasi selengkapnya
tentang makro yang didukung,
lihat Tentukan makro
di bagian Buat Respons.
Detail info
Protokol bidding real-time menggunakan pesan video, yang ditentukan dalam file real-time-bidding-proto.txt untuk mengidentifikasi permintaan video dan untuk memberikan informasi tambahan khusus video tentang permintaan tersebut.
Daftar kolom berikut dalam pesan video bertingkat juga memberikan deskripsi dan contoh yang terperinci:
description_url
-
URL, tanpa parameter, halaman yang mendeskripsikan konten video. Penerbit mengirimkan URL ini ke Google. Contoh:
http://www.publisher.com/watchpagelink
EndCapSupport
-
Jika diaktifkan, iklan pengiring dapat dipilih
dirender sebagai batas akhir (kartu info) pada slot video
setelah iklan video selesai diputar.
END_CAP_NOT_ENABLED
Iklan pengiring tidak ditampilkan sebagai batas akhir. END_CAP_OPTIONAL
Batas akhir dirender jika respons berisi kata kunci yang memenuhi syarat banner pengiring, namun banner pengiring tidak wajib. END_CAP_FORBIDDEN
Respons dengan iklan pengiring difilter. END_CAP_REQUIRED
Respons tanpa iklan pengiring akan difilter. is_embedded_offsite
-
Jika ini disetel ke
true
, video disematkan pada halaman di luar domain penayang. is_rewarded
-
Jika ditetapkan ke
true
, hal ini menunjukkan bahwa pengguna menerima reward karena telah melihat iklan video. Reward yang umum biasanya berupa membaca artikel tambahan secara gratis, mendapatkan nyawa tambahan dalam game, atau mendapatkan sesi musik bebas iklan bersponsor. max_ad_duration
-
Durasi maksimum yang diizinkan untuk iklan yang ditampilkan dalam milidetik. Jika kebijakan disetel ke
0
, tidak ada durasi maksimum. max_ads_in_pod
- Jumlah maksimum iklan dalam pod video Authorized Buyers. Nilai yang bukan nol menunjukkan bahwa slot iklan saat ini adalah pod video yang dapat menampilkan beberapa iklan video. Jumlah iklan video sebenarnya yang ditampilkan dapat kurang dari atau sama dengan nilai ini tetapi tidak boleh melebihinya.
min_ad_duration
- Durasi minimum iklan yang harus Anda tampilkan dalam milidetik. Jika ini tidak diatur atau memiliki nilai kurang dari atau sama dengan nol, tidak ada durasi minimum.
Placement
-
Menjelaskan di mana video akan diputar.
UNKNOWN_PLACEMENT
Penempatan tidak diketahui atau tidak dapat ditentukan. INSTREAM
Instream berarti iklan diputar sebelum, selama, atau setelah konten video Anda. Hal ini mirip dengan iklan TV tradisional. Konten video yang ditonton pengguna tidak diputar saat iklan sedang diputar. INTERSTITIAL
Interstisial berarti iklan video diputar di depan konten non-video (misalnya, artikel berita atau video game). Iklan menutupi semua atau hampir semua ruang di layar penuh dengan konten dan pengguna tidak dapat melanjutkan hingga iklan selesai atau dilewati. IN_FEED
Format video dalam feed adalah materi iklan video yang ditampilkan saat pengguna adalah menelusuri feed konten, biasanya feed aplikasi sosial, artikel berita, dll. Video dirender di feed utama dan di feed pengguna penglihatan dan alur membaca. Video tidak dirender ke samping video dalam banner. skippable_max_ad_duration
- Durasi maksimum dalam milidetik untuk iklan yang harus ditampilkan jika iklan ini dapat dilewati. Ini umumnya berbeda dari durasi maksimum diizinkan untuk iklan yang tidak dapat dilewati. Jika isian ini tidak disetel atau memiliki nilai kurang dari atau sama dengan nol, berapa pun durasi yang diizinkan.
VideoPlaybackMethod
-
Menjelaskan cara memutar iklan video.
Metode pemutaran ditentukan sebagai putar otomatis atau klik untuk putar
berdasarkan pengukuran terbaik yang tersedia.
AUTO_PLAY_SOUND_ON
berarti iklan diputar secara otomatis dengan suara diaktifkan. AUTO_PLAY_SOUND_OFF
berarti iklan diputar otomatis dengan suara dinonaktifkan. CLICK_TO_PLAY
berarti iklan tidak diputar sampai diklik. video_ad_skippable
- Ini adalah nilai
SkippableBidRequestType
yang berisi salah satu nilai berikut:ALLOW_SKIPPABLE
berarti iklan yang dapat dilewati dan yang tidak dapat dilewati diizinkan. REQUIRE_SKIPPABLE
berarti hanya iklan yang dapat dilewati yang akan ditampilkan. BLOCK_SKIPPABLE
berarti hanya iklan yang tidak dapat dilewati yang boleh ditampilkan. Setelan default-nya adalah mengizinkan iklan yang dapat dilewati jika kolom ini tidak disetel.
videoad_start_delay
-
Waktu dalam milidetik sejak awal video ke titik tempat iklan ditampilkan. 0 berarti pre-roll dan -1 berarti post-roll. Nilai positif lainnya menunjukkan slot di tengah-tengah video.
Nilai hanya valid jika parameter ini ditetapkan. Jika tidak disetel, posisi tampilan tidak diketahui.
Sinyal ini tidak khusus untuk materi iklan video, tetapi sangat berharga bagi bidder untuk dibaca:
advertising_id
- Kolom ini adalah UUID 16 byte yang hanya disetel saat menggunakan SSL.
Ini adalah versi
encrypted_advertising_id
yang tidak dienkripsi. Untuk perangkat iOS, ID ini berisi ID untuk Pengiklan (IDFA). Untuk perangkat Android, file ini berisi ID Android (ADID). Untuk perangkat TV yang Terhubung, kartu ini berisi ID uniknya (misalnya, RIDA Roku). device_type
- Menentukan jenis perangkat.
UNKNOWN_DEVICE
adalah nilai default untuk kolom ini. HIGHEND_PHONE
termasuk ponsel dengan kemampuan video. TABLET
termasuk perangkat tablet. PERSONAL_COMPUTER
termasuk perangkat {i>desktop<i} dan laptop. CONNECTED_TV
mencakup kedua TV yang terhubung (yaitu, smart TV) dan perangkat terhubung (seperti Roku, Apple TV, dan sebagainya). GAME_CONSOLE
mencakup perangkat game khusus. brand
- Menentukan merek (seperti Nokia atau Samsung) perangkat. Bidang ini bersifat opsional; secara {i>default<i} tidak ditentukan.
model
- Menentukan model yang tepat (seperti N70 atau Galaxy) dari perangkat. Bidang ini bersifat opsional; secara {i>default<i} tidak ditentukan.
screen_orientation
-
Menentukan orientasi perangkat saat permintaan iklan dikirim.
Nilai yang valid adalah
LANDSCAPE
,PORTRAIT
, danUNKNOWN_ORIENTATION
. viewability
-
Memberikan perkiraan kemungkinan bahwa slot ini
akan dapat dilihat oleh pengguna akhir
berdasarkan seberapa sering ia memiliki
pernah dilihat sebelumnya. Dinyatakan sebagai
persentase dalam
kisaran [0, 100]. Nilai default
-1
menunjukkan bahwa data visibilitas historis tidak tersedia. content_attributes.duration_seconds
-
Berapa detik (misalnya, 200) video diputar.
Hal ini dideklarasikan dalam pesan
ContentAttributes
. Ini disetel ke nilai yang ditentukan dalam metadata video yang disediakan oleh penayang video.
Permintaan bid video juga berisi informasi tentang inventaris seperti vertikal, vendor yang diizinkan, dan informasi saluran. Semua kolom lainnya yang ada dalam permintaan bid juga berlaku untuk video.
Bidang lebar dan tinggi dalam pesan AdSlot permintaan video sesuai dengan ukuran pemutar iklan video.
allowed_vendor_type
- Vendor yang diizinkan. Lihat vendors.txt di dokumentasi teknis untuk daftar tanda pengenal. Misalnya, 309 = Unit Video DFA.
allowed_video_formats
-
Menjelaskan teknologi video yang diizinkan
untuk iklan yang ditayangkan sebagai respons terhadap permintaan ini.
Respons harus menunjukkan dukungan untuk setidaknya salah satunya.
Nilai untuk kolom berulang ini berasal dari pencacahan VideoFormat:
VIDEO_FLASH
Mengizinkan video menggunakan format Video Flash (FLV). VIDEO_HTML5
Mengizinkan video menggunakan format video HTML5. VPAID_FLASH
Mengizinkan video menggunakan Penayangan Iklan Pemutar Video Format video Flash Interface Definition (VPAID). VPAID_JS
Izinkan video yang menggunakan Format video VPAID JavaScript. companion_slot
-
Kolom ini mewakili pesan CompanionSlot
yang mencakup kolom berikut:
height
Ketinggian yang tersedia untuk slot ini. width
Lebar yang tersedia untuk slot ini. CreativeFormat
Format materi iklan mewakili kemungkinan format untuk materi iklan dalam slot pengiring ini. url
-
URL halaman tonton video atau URL halaman tempat video disematkan. Contoh:
http://www.publisher.com/watchpagelink
Saat menanggapi permintaan video,
bidder harus menampilkan URL alihan VAST
di kolom video_url
.
Respons bid juga harus berisi
pernyataan yang tepat untuk iklan video.
Di bawah ini adalah ekstrak respons bid video yang tepat:
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" }
Kolom penting dalam respons bid video adalah sebagai berikut:
attribute
-
Semua atribut untuk iklan yang mungkin ditampilkan dari cuplikan ini. Lihat
pembeli-declarable-creative-attributes.txt untuk daftar ID.
Kami memeriksa untuk memastikan bahwa tidak satu pun dari atribut ini
Daftar
excluded_attribute
Permintaan Bid. Hanya tetapkan kolom ini jika cuplikan HTML atau iklan video ditampilkan. Misalnya, menetapkan kolom ini ke30
menunjukkan bahwa iklan membutuhkan dukungan VPAID untuk dirender. protocol
-
Menjelaskan versi VAST yang didukung penayang untuk permintaan iklan video,
memungkinkan iklan VAST hingga dan
menyertakan versi yang ditentukan.
Berisi array protokol iklan video yang didukung.
Hal ini sesuai dengan dan mencocokkan perilaku di OpenRTB 2.4.
Nilai berikut mungkin muncul:
VAST_2_0
,VAST_3_0
,VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
, danVAST_4_0_WRAPPER
. video_url
-
URL alihan VAST iklan video. Contoh:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
- Cara pembeli dapat menyertakan video
- Sinyal yang direkomendasikan OpenRTB untuk semua format video
- Sinyal yang direkomendasikan proto Authorized Buyers untuk semua format video
- Cara penayang mengizinkan/melarang video
- Kasus ekstrem
Pra-penargetan
Untuk menerima inventaris video, pembeli RTB harus memiliki konfigurasi pra-penargetan untuk RTB yang mencakup inventaris video.
Contoh permintaan dan respons bid
Format Video AdX
Cara pembeli dapat menyertakan video
Tabel berikut menggambarkan cara pembeli dapat menyertakan video dalam materi iklan dan penempatan yang dapat menayangkan iklan untuk web dan aplikasi seluler.
Web
Materi iklan video | In-stream (semua) | Dalam feed/artikel | Dalam feed/artikel native | Interstisial | Dalam banner |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
JS Kustom |
|
||||
Native + VAST |
|
Aplikasi Seluler
Materi iklan video | In-stream (semua) | Dalam feed/artikel | Dalam feed/artikel native | Interstisial | Dalam banner |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
JS Kustom |
|||||
Native + VAST |
Kunci: | Format/teknologi tidak tersedia | Materi iklan video diterima di penempatan ini, tunduk kepada pemblokiran penayang |
Materi iklan video tidak tersedia di penempatan ini |
---|
Sinyal yang direkomendasikan OpenRTB
Tabel berikut menggambarkan sinyal yang direkomendasikan OpenRTB untuk semua format video untuk desktop & web seluler, dan aplikasi seluler.
Web seluler dan desktop
Format video | Sinyal yang direkomendasikan (hanya sinyal video yang relevan) | Sinyal terkait (hanya sinyal yang relevan untuk video) |
---|---|---|
In-stream (VPAID) |
Objek VIDEO tersedia & |
|
In-stream (tanpa VPAID) |
Objek VIDEO tersedia & |
|
Outstream |
Objek VIDEO tersedia
|
|
Dalam Feed |
Objek VIDEO tersedia & |
|
Dalam artikel |
Objek VIDEO tersedia & |
|
Native |
Objek NATIVE ada & |
|
Dalam banner |
Objek video tidak ada & |
Aplikasi seluler
Format video | Detail permintaan bid (hanya detail video yang relevan) | |
---|---|---|
In-stream |
Objek VIDEO tersedia & |
|
Outstream |
Objek VIDEO tersedia
|
|
Dalam Feed |
Objek VIDEO tersedia & |
|
Dalam artikel |
Objek VIDEO tersedia & |
|
Native |
Objek NATIVE ada & |
|
Interstisial (VAST) |
Objek VIDEO tersedia & |
|
Interstisial (tanpa VAST) |
Objek VIDEO tersedia & |
Difilter |
Dalam banner (MRAID) |
Objek video tidak ada & |
|
Dalam banner (tanpa MRAID) |
Objek video tidak ada & |
Sinyal yang direkomendasikan proto AdX
Tabel berikut menggambarkan sinyal yang direkomendasikan proto Authorized Buyers untuk semua format video untuk web desktop dan seluler, serta aplikasi seluler.
Desktop dan Web seluler
Format video | Rekomendasi sinyal yang relevan dengan video | Sinyal terkait video yang relevan |
---|---|---|
In-stream (VPAID) |
Pesan VIDEO ditampilkan & |
|
In-stream (tanpa VPAID) |
Pesan VIDEO ditampilkan & |
Allowed_video_formats = VIDEO_HTML5 & |
Dalam Feed |
Pesan VIDEO ditampilkan & |
Allowed_video_formats = VIDEO_HTML5 & |
Dalam artikel |
Pesan VIDEO ditampilkan & |
|
Native |
Pesan NATIVE ditampilkan & |
|
Dalam banner |
|
|
Aplikasi seluler
Tabel berikut menggambarkan sinyal yang direkomendasikan proto AdX untuk semua format video untuk web desktop dan seluler, serta aplikasi seluler.
Format video | Detail permintaan bid yang relevan untuk video | Sinyal terkait yang relevan dengan video |
---|---|---|
In-stream |
Pesan VIDEO ditampilkan |
|
Dalam Feed |
Pesan VIDEO ditampilkan & |
|
Dalam artikel |
Pesan VIDEO ditampilkan & |
|
Native |
Pesan NATIVE ditampilkan & |
|
Interstisial |
Pesan VIDEO ditampilkan & |
|
Dalam banner (MRAID) |
|
|
Dalam banner (tanpa MRAID) |
|
|
Cara penayang mengizinkan/melarang video
Tabel berikut menggambarkan cara penayang dapat mengizinkan/melarang video di penempatan dan bagaimana hal tersebut ditampilkan dalam permintaan bid untuk OpenRTB, dan AdX Proto.
OpenRTB
Opsi Pub | Format yang berlaku | Dijelaskan dalam permintaan bid sebagai |
---|---|---|
Menentukan unit Video Instream |
In-stream (semua) |
Objek video ada & |
Memilih untuk menggunakan VPAID |
Web Instream |
Objek video ada & |
Ikut serta dalam IBV |
Dalam banner Interstisial |
|
Memilih untuk menggunakan Outstream (petunjuk) |
Dalam Feed Dalam artikel |
Objek video ada & |
Memilih untuk menggunakan Outstream (petunjuk) |
Native |
Objek native tersedia |
Blokir interstisial Video |
Aplikasi interstisial |
Objek VIDEO tidak ada |
Prototipe AdX
Opsi Pub | Format yang berlaku | Dijelaskan dalam permintaan bid sebagai (CATATAN: ini adalah SEMUA indikator opsi penayang dalam permintaan bid - untuk sinyal yang direkomendasikan, lihat tabel di bawah ini) | Setelan default |
---|---|---|---|
Menentukan unit Video Instream |
In-stream (semua) |
Pesan video ditampilkan & |
t/a |
Memilih untuk menggunakan VPAID |
Web Instream |
Pesan video ditampilkan &
|
Memilih tidak ikut |
Ikut serta dalam IBV |
Dalam banner Interstisial |
|
Memilih tidak ikut |
Ikut serta dalam Outstream (petunjuk) |
Dalam Feed Dalam artikel |
Pesan video ditampilkan & |
Memilih tidak ikut |
Ikut serta dalam Outstream (petunjuk) |
Native |
Pesan NATIVE &
|
Memilih tidak ikut |
Blokir interstisial Video |
Aplikasi interstisial |
Pesan VIDEO tidak ada & |
Diikutsertakan |
Kasus ekstrem
# | Deskripsi Kasus | Komentar | Permintaan bid |
---|---|---|---|
1 |
Penutupan kustom tertunda menggunakan MRAID |
Untuk interstisial, menutup iklan dapat mengirimkan notifikasi kepada Pembeli menggunakan MRAID, bahkan jika mereka tidak menggunakan {i>custom close<i}. AdX yang diterapkan X akan selalu muncul di atas penutupan kustom, meskipun muncul di bawah setelah 5 detik |
Glosarium
Lihat Glosarium video Authorized Buyers.
Kolom AdX dan OpenRTB dalam format Instream dan Outstream
Prototipe AdX
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
Prototipe OpenRTB
Lihat OpenRTB 2.5 (mulai dari halaman 47)
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
Menunjukkan apakah tayangan harus linear, nonlinear, dll. Jika tidak ada yang ditentukan, asumsikan bahwa semua diizinkan.
|
||||
videoad_start_delay
|
|
Sumber nilai permintaan bid
OpenRTB Objek | Kolom | AdX /Bursa Bidding Outstream |
Nilai Contoh | Siapa yang menentukan? /Tempat nilai ini berasal dari? |
---|---|---|---|---|
Objek | ||||
Video | pantomim | ya | ["application/javascript", "video/mp4"]", |
|
durasi minimum | tidak | Penayang Dikonfigurasi | ||
maxduration (durasi maksimum) | ya | Penayang Dikonfigurasi | ||
pemutaran Hod |
ya | [6] | Biasanya Penerbit Dikonfigurasi |
|
api (MRAID) | ya | [1,2] | ||
protokol | ya | [2,3,5,6,7,8] | ||
linearitas | ya | [1] | ||
penempatan | ya | [1] | ||
lebar pemain | ya | 400.400.300 | ||
tinggi pemutar | ya | 225.300.153 | ||
penundaan mulai | ya | 0 | Google, default 5 detik | |
lewati | ya | 1 | Penayang/Google - untuk Interstisial => Google - untuk Instream => Penerbit memutuskan apakah akan mengizinkan dapat dilewati, tidak dapat dilewati, atau keduanya. Iklan reward, selalu tidak dapat dilewati; |
|
kecepatan bit min | Tidak | |||
kecepatan bit maksimal | tidak | |||
pos | ya | 1 | ||
Perangkat | ||||
Rasio Px | ya | 1 | ||
tayangan | ||||
Aman | ya | 1 | Google default ke benar (true) karena tag iklan selalu aman |