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 mengetahui informasi tentang protokol yang tersedia, lihat bagian Memilih protokol dari panduan Memulai.
Pembeli dapat membeli inventaris video di seluruh penempatan, yang 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 informasi tentang cara mengembangkan bidder, lihat Memproses Permintaan dan Membuat 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 di wrapper VAST.
Oleh karena itu, makro klik tidak didukung untuk iklan video in-stream.
Untuk mengetahui informasi selengkapnya tentang makro yang didukung,
lihat Menentukan makro
di bagian Membuat Respons.
Detail info
Protokol bidding real-time menggunakan pesan video, yang ditentukan dalam file real-time-bidding-proto.txt untuk mengidentifikasi permintaan video dan memberikan informasi khusus video tambahan tentang permintaan tersebut.
Daftar kolom berikut dalam pesan video bertingkat juga memberikan deskripsi dan contoh mendetail:
description_url
-
URL halaman yang mendeskripsikan konten video dengan menghapus parameter. Penerbit mengirimkan URL ini ke Google. Contoh:
http://www.publisher.com/watchpagelink
EndCapSupport
-
Jika diaktifkan, iklan pengiring dapat dipilih
untuk dirender sebagai batas akhir (kartu info) di slot video
setelah iklan video selesai diputar.
END_CAP_NOT_ENABLED
Iklan pengiring tidak dirender sebagai batas akhir. END_CAP_OPTIONAL
Batas akhir dirender jika respons berisi banner pengiring yang memenuhi syarat, tetapi banner pengiring tidak diperlukan. END_CAP_FORBIDDEN
Respons dengan iklan pengiring akan difilter. END_CAP_REQUIRED
Respons tanpa iklan pengiring akan difilter. is_embedded_offsite
-
Jika disetel ke
true
, video akan disematkan di halaman di luar domain penayang. is_rewarded
-
Jika ditetapkan ke
true
, hal ini menunjukkan bahwa pengguna menerima reward karena telah melihat iklan video. Reward pada umumnya berupa membaca artikel tambahan secara gratis, mendapatkan nyawa tambahan dalam game, atau mendapatkan sesi musik bersponsor bebas iklan. max_ad_duration
-
Durasi maksimum yang diizinkan untuk iklan yang ditampilkan dalam milidetik. Jika ditetapkan ke
0
, tidak ada durasi maksimum. max_ads_in_pod
- Jumlah iklan maksimum di pod video Authorized Buyers. Nilai bukan nol menunjukkan bahwa slot iklan saat ini adalah pod video yang dapat menampilkan beberapa iklan video. Jumlah iklan video sebenarnya yang ditampilkan bisa kurang dari atau sama dengan nilai ini, tetapi tidak boleh melebihinya.
min_ad_duration
- Durasi minimum dalam milidetik untuk iklan yang harus Anda tampilkan. Jika nilai ini tidak ditetapkan atau memiliki nilai kurang dari atau sama dengan nol, tidak ada durasi minimum.
Placement
-
Menjelaskan tempat video akan diputar.
UNKNOWN_PLACEMENT
Penempatan tidak diketahui atau tidak dapat ditentukan. INSTREAM
In-stream berarti iklan diputar sebelum, selama, atau setelah konten video lainnya. Hal ini mirip dengan iklan TV tradisional. Konten video yang ditonton pengguna tidak diputar saat iklan diputar. INTERSTITIAL
Interstisial berarti iklan video diputar di depan konten non-video (misalnya, artikel berita atau video game). Iklan menutupi semua atau hampir seluruh ruang pada layar yang ditempati oleh konten dan pengguna tidak dapat melanjutkan ke konten sampai iklan selesai atau dilewati. IN_FEED
Format video dalam feed adalah materi iklan video yang ditampilkan saat pengguna men-scroll feed konten, biasanya feed aplikasi sosial, artikel berita, dll. Video dirender dalam feed utama serta dalam alur visi dan membaca pengguna. Video tidak dirender ke samping seperti video dalam banner. skippable_max_ad_duration
- Durasi maksimum dalam milidetik untuk iklan yang harus Anda tampilkan jika iklan ini dapat dilewati. Durasi ini umumnya berbeda dengan durasi maksimum yang diizinkan untuk iklan yang tidak dapat dilewati. Jika kolom ini tidak ditetapkan atau memiliki nilai kurang dari atau sama dengan nol, semua durasi 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. AUTO_PLAY_SOUND_OFF
berarti iklan diputar secara otomatis dengan suara dinonaktifkan. CLICK_TO_PLAY
berarti iklan tidak diputar hingga 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 dapat ditampilkan. BLOCK_SKIPPABLE
berarti hanya iklan yang tidak dapat dilewati yang dapat ditampilkan. Jika kolom ini tidak ditetapkan, setelan default adalah mengizinkan iklan yang dapat dilewati.
videoad_start_delay
-
Waktu dalam milidetik dari awal video sampai saat iklan ditampilkan. 0 berarti pre-roll dan -1 berarti post-roll. Nilai positif lainnya menunjukkan bahwa slot berada di tengah video.
Nilai hanya valid jika parameter ini ditetapkan. Jika tidak disetel, posisi tampilan tidak diketahui.
Sinyal ini tidak unik untuk materi iklan video, tetapi sangat berharga untuk dibaca oleh bidder:
advertising_id
- Kolom ini adalah UUID 16 byte yang ditetapkan hanya 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, kode ini berisi ID Android (ADID). Untuk perangkat TV yang Terhubung, data ini berisi ID uniknya (misalnya, RIDA Roku). device_type
- Menentukan jenis perangkat.
UNKNOWN_DEVICE
adalah nilai default untuk bidang ini. HIGHEND_PHONE
meliputi ponsel dengan kemampuan video. TABLET
termasuk perangkat tablet. PERSONAL_COMPUTER
termasuk perangkat {i>desktop<i} dan laptop. CONNECTED_TV
mencakup TV yang terhubung (yaitu smart TV) dan perangkat yang terhubung (seperti Roku, Apple TV, dan sebagainya). GAME_CONSOLE
mencakup perangkat game khusus. brand
- Menentukan merek (seperti Nokia atau Samsung) perangkat. Kolom ini bersifat opsional, dan secara default tidak ditentukan.
model
- Menentukan model yang tepat (misalnya N70 atau Galaxy) dari perangkat. Kolom ini bersifat opsional, dan secara default tidak ditentukan.
screen_orientation
-
Menentukan orientasi perangkat saat permintaan iklan dikirim.
Nilai yang valid adalah
LANDSCAPE
,PORTRAIT
, danUNKNOWN_ORIENTATION
. viewability
-
Memberikan perkiraan kemungkinan slot ini
akan terlihat oleh pengguna akhir berdasarkan seberapa sering
slot ini dapat dilihat sebelumnya. Dinyatakan sebagai persentase dalam rentang [0, 100]. Nilai default
-1
menunjukkan bahwa data visibilitas historis tidak tersedia. content_attributes.duration_seconds
-
Durasi video diputar (misalnya, 200 detik).
Hal ini dideklarasikan dalam pesan
ContentAttributes
. Ini ditetapkan ke nilai yang ditentukan dalam metadata video yang disediakan oleh penayang video.
Permintaan bid video juga berisi informasi tentang inventaris, seperti informasi vertical, vendor yang diizinkan, dan informasi saluran. Semua kolom lain yang ada dalam permintaan bid juga berlaku untuk video.
Kolom lebar dan tinggi dalam pesan Slot Iklan permintaan video sesuai dengan ukuran pemutar iklan video.
allowed_vendor_type
- Vendor yang diizinkan. Lihat file vendors.txt dalam dokumentasi teknis untuk mengetahui daftar ID. 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 VideoFormat enumerasi:
VIDEO_FLASH
Mengizinkan video menggunakan format Flash Video (FLV). VIDEO_HTML5
Mengizinkan video menggunakan format video HTML5. VPAID_FLASH
Mengizinkan video yang menggunakan format video Flash Definisi Antarmuka Penayangan Iklan Pemutar Video (VPAID). VPAID_JS
Mengizinkan video menggunakan format video JavaScript VPAID. companion_slot
-
Kolom ini mewakili pesan CompanionSlot
yang menyertakan kolom berikut:
height
Ketinggian yang tersedia untuk slot ini. width
Lebar yang tersedia untuk slot ini. CreativeFormat
Format materi iklan merepresentasikan kemungkinan format untuk materi iklan dalam slot pendamping ini. url
-
URL halaman tonton video atau URL halaman tempat video disematkan. Contoh:
http://www.publisher.com/watchpagelink
Saat merespons permintaan video,
bidder harus menampilkan URL alihan VAST
di kolom video_url
.
Respons bid juga harus berisi
pernyataan yang sesuai untuk iklan video.
Di bawah ini adalah kutipan respons bid video yang sesuai:
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 file
Buyer-declarable-creative-attributes.txt untuk mengetahui daftar ID.
Kami memeriksa untuk memastikan bahwa tidak satu pun dari atribut tersebut ada dalam daftar
excluded_attribute
Permintaan Bid. Hanya tetapkan kolom ini jika cuplikan HTML atau iklan video ditampilkan. Misalnya, menetapkan kolom ini ke30
menunjukkan bahwa iklan memerlukan dukungan VPAID untuk dirender. protocol
-
Menjelaskan versi VAST yang didukung penayang untuk permintaan iklan video,
sehingga iklan VAST dapat ditayangkan hingga dan termasuk versi yang ditentukan.
Berisi array protokol iklan video yang didukung.
Hal ini sesuai dan cocok dengan 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 dari 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 penerbit dapat mengizinkan/melarang video
- Kasus ekstrem
Pra-penargetan
Untuk menerima inventaris video, pembeli RTB harus memiliki konfigurasi pra-penargetan untuk RTB yang menyertakan 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 tempat mereka dapat ditayangkan 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 yang diterima di penempatan ini, tunduk kepada pemblokiran penayang |
Materi iklan video tidak tersedia di penempatan ini |
---|
Sinyal yang direkomendasikan OpenRTB
Tabel berikut mengilustrasikan sinyal yang direkomendasikan OpenRTB untuk semua format video pada web desktop & seluler, dan aplikasi seluler.
Web seluler dan desktop
Format video | Sinyal yang direkomendasikan (hanya sinyal yang relevan video) | Sinyal terkait (hanya sinyal yang relevan video) |
---|---|---|
In-stream (VPAID) |
Objek VIDEO ditampilkan & |
|
In-stream (tanpa VPAID) |
Objek VIDEO ditampilkan & |
|
Outstream |
Objek VIDEO ditampilkan
|
|
Dalam Feed |
Objek VIDEO ditampilkan & |
|
Dalam artikel |
Objek VIDEO ditampilkan & |
|
Native |
Objek NATIVE ada & |
|
Dalam banner |
Objek video tidak ada & |
Aplikasi seluler
Format video | Detail permintaan bid (hanya detail yang relevan untuk video) | |
---|---|---|
In-stream |
Objek VIDEO ditampilkan & |
|
Outstream |
Objek VIDEO ditampilkan
|
|
Dalam Feed |
Objek VIDEO ditampilkan & |
|
Dalam artikel |
Objek VIDEO ditampilkan & |
|
Native |
Objek NATIVE ada & |
|
Interstisial (VAST) |
Objek VIDEO ditampilkan & |
|
Interstisial (tanpa VAST) |
Objek VIDEO ditampilkan & |
Difilter |
Dalam banner (MRAID) |
Objek video tidak ada & |
|
Dalam banner (tanpa MRAID) |
Objek video tidak ada & |
Sinyal yang direkomendasikan proto AdX
Tabel berikut mengilustrasikan sinyal yang direkomendasikan proto Authorized Buyers untuk semua format video pada web desktop dan seluler, serta aplikasi seluler.
Desktop dan Web seluler
Format video | Sinyal yang relevan dengan video yang direkomendasikan | Sinyal yang relevan dengan video terkait |
---|---|---|
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 ada & |
|
Dalam banner |
|
|
Aplikasi seluler
Tabel berikut mengilustrasikan sinyal yang direkomendasikan proto AdX untuk semua format video pada web desktop dan seluler, serta aplikasi seluler.
Format video | Detail permintaan bid yang relevan dengan 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 ada & |
|
Interstisial |
Pesan VIDEO ditampilkan & |
|
Dalam banner (MRAID) |
|
|
Dalam banner (tanpa MRAID) |
|
|
Cara penerbit dapat mengizinkan/melarang video
Tabel berikut menggambarkan cara penayang dapat mengizinkan/melarang video di penempatannya dan bagaimana hal tersebut muncul dalam permintaan bid untuk OpenRTB dan AdX Proto.
OpenRTB
Opsi pub | Format yang berlaku | Diuraikan dalam permintaan bid sebagai |
---|---|---|
Menentukan unit Video Instream |
In-stream (semua) |
Objek video ada & |
Memilih menggunakan VPAID |
Web in-stream |
Objek video ditampilkan & |
Ikut serta dalam IBV |
Dalam banner Interstisial |
|
Ikut serta dalam Outstream (instructions) |
Dalam Feed Dalam artikel |
Objek video ada & |
Ikut serta dalam Outstream (instructions) |
Native |
Objek native ada |
Blokir interstisial Video |
Aplikasi interstisial |
Objek VIDEO tidak ada |
Proto 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) | Setelan default |
---|---|---|---|
Menentukan unit Video Instream |
In-stream (semua) |
Pesan video ditampilkan & |
t/a |
Memilih menggunakan VPAID |
Web in-stream |
Pesan video ditampilkan &
|
Tidak diikutsertakan |
Ikut serta dalam IBV |
Dalam banner Interstisial |
|
Tidak diikutsertakan |
Ikut serta dalam Outstream (instructions) |
Dalam Feed Dalam artikel |
Pesan video ditampilkan & |
Tidak diikutsertakan |
Ikut serta dalam Outstream (instructions) |
Native |
Pesan NATIF ada &
|
Tidak diikutsertakan |
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, meskipun mereka tidak menggunakan penutupan khusus. AdX yang menerapkan X akan selalu muncul di atas penutupan kustom, meskipun penutupan kustom muncul di bawahnya setelah 5 detik |
Glosarium
Lihat Glosarium video Authorized Buyers.
Kolom AdX dan OpenRTB dalam format In-stream dan Outstream
Proto AdX
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
Proto 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 semuanya diizinkan.
|
||||
videoad_start_delay
|
|
Sumber nilai permintaan bid
Objek OpenRTB | Kolom | AdX /Exchange Bidding Outstream |
Nilai Contoh | Siapa yang menentukannya? /Dari mana nilai ini berasal ? |
---|---|---|---|---|
Object | ||||
Video | pantomim | ya | ["application/javascript", "video/mp4"]", |
|
durasi minimal | tidak | Dikonfigurasi oleh Penayang | ||
maxduration (durasi maksimal) | ya | Dikonfigurasi oleh Penayang | ||
playbackmet hod |
ya | [6] | Biasanya Penayang Dikonfigurasi |
|
api (MRAID) | ya | [1,2] | ||
protokol | ya | [2,3,5,6,7,8] | ||
linearitas | ya | [1] | ||
penempatan | ya | [1] | ||
lebar pemutar | 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 => Penayang memutuskan apakah akan mengizinkan yang dapat dilewati, tidak dapat dilewati, atau keduanya. Iklan reward, selalu jangan dilewati; |
|
kecepatan bit min | Tidak | |||
kecepatan bit maks | tidak | |||
pos | ya | 1 | ||
Perangkat | ||||
Rasio Px | ya | 1 | ||
tayangan | ||||
Keamanan | ya | 1 | Google ditetapkan secara default ke true karena adtag selalu aman |