Panduan ini menguraikan persyaratan integrasi untuk pembelian RTB menggunakan protokol OpenRTB. Panduan ini harus digunakan bersama dengan panduan Integrasi OpenRTB yang menjelaskan kolom yang dibahas di sini secara mendetail.
Jika membeli di aplikasi iOS dengan cuplikan HTML yang menyertakan tag <video>
, Anda
harus menyertakan atribut playsinline
di tag video. Jika tidak, pengguna akan mengalami
pengalaman yang sangat buruk, ketika iklan video yang seharusnya diputar dalam materi iklan tampak muncul
dalam layar penuh. Iklan yang tidak mematuhi persyaratan ini akan diblokir.
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. Untuk mengetahui 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%%
Perlu diperhatikan bahwa penggantian makro diizinkan di URL video, tetapi tidak dalam XML VAST yang sebenarnya.
Makro klik (seperti CLICK_URL_ESC
) tidak diperlukan
karena Authorized Buyers menyertakan pelacak kliknya di kode wrapper VAST.
Oleh karena itu, makro klik tidak didukung untuk iklan video in-stream.
Untuk informasi selengkapnya tentang makro yang didukung,
lihat Menentukan makro
di bagian Membuat Respons.
Detail objek video
Protokol OpenRTB menggunakan pesan Video
, yang ditentukan dalam file
openrtb-proto.txt untuk mengidentifikasi permintaan video dan memberikan informasi khusus video tambahan tentang permintaan tersebut.
Lihat daftar kolom pesan Video dalam panduan Integrasi OpenRTB untuk deskripsi dan contoh mendetail.
Kolom permintaan bid video lainnya
Sinyal di bawah ini tidak semuanya unik untuk materi iklan video, tetapi merupakan bagian penting dari permintaan bid.
Kolom objek imp
Objek ini menjelaskan penempatan iklan atau tayangan yang dilelang.
banner |
Objek Banner; diperlukan jika tayangan ditawarkan sebagai peluang iklan banner. |
video |
Menunjukkan jenis tayangan yang ditawarkan, dalam hal ini video. Perhatikan bahwa video dalam banner diizinkan jika objek imp menyertakan objek banner dan video . |
tagid |
ID untuk penempatan iklan atau tag iklan tertentu yang digunakan untuk memulai lelang. Hal ini dapat berguna untuk proses debug masalah apa pun, atau untuk pengoptimalan oleh pembeli. |
bidfloor |
Bid minimum untuk tayangan ini yang dinyatakan dalam CPM. |
bidfloorcur |
Mata uang tunggal, yang diperoleh dari billing_id. yang disertakan |
Lihat bagian Objek Imp dalam panduan OpenRTB untuk detail tambahan.
Kolom objek perangkat
Kolom dalam objek Device
memberikan informasi tentang perangkat yang ditargetkan.
ua |
String agen pengguna browser. |
ip |
Alamat IPv4 yang paling dekat dengan perangkat. |
geo |
Lokasi perangkat diasumsikan sebagai lokasi pengguna saat ini yang ditentukan oleh objek Geo . |
devicetype |
Jenis perangkat umum. |
ifa |
Tanda pengenal diberi sanksi jika digunakan oleh pengiklan secara jelas (misalnya, tidak di-hash). ifa didukung untuk perangkat TV yang terhubung seperti Roku, Apple TV, Fire TV, Xbox. |
Lihat bagian Objek perangkat di panduan OpenRTB untuk detail tambahan.
Objek situs
Kolom dalam objek Site
memberikan informasi tentang situs dengan konten yang didukung iklan.
page |
URL halaman tempat tayangan akan ditampilkan. |
publisher |
Detail tentang objek Publisher situs. |
content |
Detail tentang Content dalam situs. |
Lihat bagian objek Situs di panduan OpenRTB untuk detail selengkapnya.
Objek pengguna
Kolom dalam objek User
memberikan informasi tentang situs dengan konten yang didukung iklan.
id |
ID khusus bursa untuk pengguna. Sebaiknya pilih salah satu dari id atau buyerid . |
data |
Detail tentang objek Publisher situs. |
Lihat bagian Objek pengguna di panduan OpenRTB untuk detail tambahan.
Kolom inventaris permintaan bid
Permintaan bid video juga berisi informasi tentang jenis konten dan iklan pengiring tertentu.
mimes
- Daftar jenis MIME konten yang diizinkan didukung.
companionad
- Array objek Banner jika iklan pengiring tersedia.
id
- ID permintaan bid yang menjadi respons.
seatbid
- Array objek Seatbid; satu atau beberapa diperlukan jika bid akan dibuat.
seat
-
Objek
Seatbid
; ID slot pembeli (misalnya, pengiklan, agensi) yang diatasnamakan untuk bid ini. bid
- Array yang berisi satu atau beberapa objek Bid yang masing-masing terkait dengan tayangan.
Kolom respons bid
Kolom utama dalam respons bid video mencakup hal berikut:
Pra-penargetan
Untuk menerima inventaris video, pembeli OpenRTB harus memiliki konfigurasi pra-penargetan yang menyertakan inventaris video.