Siapkan Spesifikasi OpenRTB 2.6 saat membaca halaman ini.
Display & Video 360 tidak mendukung setiap kolom dalam spesifikasi OpenRTB, dan nuansa dapat berlaku. Bagian dalam dokumen ini berisi informasi dan rekomendasi khusus untuk penerapan Display & Video 360. Anda juga harus mengikuti panduan yang disajikan dalam spesifikasi OpenRTB, kecuali jika diinstruksikan sebaliknya.
Beberapa kolom tidak didukung, tetapi masih diuraikan. Kolom ini harus diformat dengan benar, tetapi tidak akan memengaruhi hasil bidding.
Spesifikasi permintaan bid
Permintaan bid adalah permintaan HTTP Post dengan isi objek permintaan bid. Format isi ditentukan di header
Content-Type
.
Respons yang sesuai adalah HTTP 204 tanpa isi untuk tidak ada bid, atau HTTP 200 dengan isi respons bid.
Jika permintaan bid salah format, respons bid bid
response dengan isi HTTP 200 dan kolom nbr
yang terisi dapat ditampilkan.
Format respons dikontrol oleh header Accept
.
Format JSON
Format default digunakan jika tidak ada jenis MIME yang diterima.
Permintaan dan respons JSON mengikuti Spesifikasi OpenRTB 2.6 IAB. Dokumentasi berikut menjelaskan dukungan ekstensi dan kolom.
Header Content-Type
: application/json
menunjukkan permintaan bid JSON,
Accept
: application/json
menunjukkan bahwa respons bid harus dalam format
JSON.
Format Protobuf
CATATAN: Dukungan Protobuf masih dalam versi beta. Hubungi DV360 jika Anda tertarik.
Permintaan dan respons JSON mengikuti Spesifikasi Protobuf OpenRTB 2.6 IAB.
Ekstensi memiliki dukungan terbatas, hubungi DV360 jika Anda tertarik.
Kirim header Content-Type
: application/x-protobuf
untuk menunjukkan permintaan bid Protobuf, dan tetapkan Accept
: application/x-protobuf
untuk menerima respons bid Protobuf.
Objek permintaan bid
Kolom | Jenis | Detail |
---|---|---|
id |
String | Wajib. ID unik permintaan bid. Ini dapat digunakan untuk mengidentifikasi permintaan individual untuk waktu yang sangat terbatas setelah ditayangkan. |
imp |
Array Imp | Diperlukan minimal 1 objek imp .
Untuk pod audio, lebih dari satu objek |
site |
Situs | Wajib untuk permintaan situs.site dan app tidak dapat muncul bersamaan. |
app |
Aplikasi | Diperlukan untuk permintaan aplikasi.app dan site tidak dapat muncul bersamaan. |
device |
Perangkat | Wajib. |
user |
Pengguna | Wajib. |
test |
Bilangan bulat | Tidak didukung. |
at |
Bilangan bulat |
1 : Lelang harga pertama dengan pengiklan ditagih
jumlah bidnya.2 (default): Lelang harga kedua di mana pengiklan
ditagih tepat di atas bidder tertinggi kedua.3 : Harga minimum ada dalam permintaan, dan tidak ada hubungannya
dengan bid yang bersaing.
|
tmax |
Bilangan bulat | Opsional, defaultnya adalah kustom per integrasi. |
wseat |
Array string | Daftar slot pembeli yang diizinkan. Direkomendasikan kecuali semua pengiklan diizinkan untuk mengajukan bid. Tidak ditetapkan berarti tidak ada batasan. |
bseat |
Array string | Daftar kursi pembeli yang bid-nya harus diblokir. Pembeli yang tercantum akan diblokir untuk mengajukan bid pada transaksi dan lelang terbuka. |
allimps |
Bilangan bulat | Tidak didukung. |
cur |
Array string | Opsional, tetapi sangat direkomendasikan. Default-nya adalah per integrasi. Mata uang dalam permintaan bid harus cocok dengan salah satu mata uang yang terdaftar selama integrasi. Sangat disarankan untuk mendukung satu mata uang per bursa. |
wlang |
Array string | Tidak didukung. |
bcat |
Array string | Kategori pengiklan yang diblokir menggunakan kategori konten IAB. Tidak ditetapkan berarti tidak ada kategori yang diblokir. |
badv |
Array string | Tentukan pengiklan yang diblokir berdasarkan domain yang diberikan oleh
pengiklan. Tidak disetel berarti tidak ada pengiklan yang diblokir. |
bapp |
Array string | Tidak didukung. |
source |
Sumber | Setengah wajib untuk schain . |
regs |
Regs | Opsional. |
ext |
Ekstensi permintaan bid | Opsional. |
Objek ekstensi permintaan bid
Kolom | Jenis | Detail |
---|---|---|
schain |
Supply chain |
integrasi baru harus menggunakan kolom BidRequest.source.schain di Sumber.
|
purch |
Bilangan bulat |
Parameter Traffic yang Dibeli adalah traffic yang dialihkan dari
properti selain yang dimiliki, diperoleh, atau aktivitas yang diberi insentif. Hal ini sesuai dengan MRC IVT 2.0 Spec yang baru.
Kolom ini akan disebut Sumber Traffic Penayang dalam pelaporan yang ditampilkan kepada pembeli dan akan memiliki salah satu nilai berikut : |
gdemsignals |
String | Blob sinyal SCAR API dari GMA SDK. Direkomendasikan jika traffic GMA SDK, dilarang jika tidak. |
disable_gma_format |
int |
Opsional jika gdemsignals diberikan, dilarang jika tidak.0 (default): Jika gdemsignals diisi, adm respons
bid adalah blob json.1 : Tag iklan juga akan diberikan, bukan blob
json. |
Objek sumber
Kolom | Jenis | Detail |
---|---|---|
fd |
Bilangan bulat | Entitas yang bertanggung jawab atas keputusan penjualan tayangan akhir0 (Default): Exchange memutuskan.1 : Sumber upstream yang memutuskan.
|
tid |
String | Tidak didukung. |
pchain |
String | Tidak didukung. |
schain |
Supply chain |
Wajib dalam hampir semua kasus.
Kolom ini lebih disarankan daripada memberikan |
ext |
Ekstensi sumber | Opsional. |
Objek ekstensi sumber
Ekstensi ini sangat direkomendasikan karena memengaruhi cara pengukuran keterlihatan dilaporkan di DV3 kepada pelanggan. Jika nama partner OMID TIDAK ada dalam daftar sertifikasi IAB, kami diwajibkan oleh MRC untuk melaporkan metrik visibilitas secara terpisah dari metrik bersertifikasi MRC. Pelajari lebih lanjut.
Kolom | Jenis | Detail |
---|---|---|
omidpn |
String | ID integrasi OM SDK. Ini sama dengan parameter "name" dari objek Partner OMID. |
omidpv |
String | Versi integrasi OM SDK. Ini sama dengan parameter "versionString" objek Partner OMID. |
schain |
Supply chain |
integrasi baru harus menggunakan kolom
schain di
Sumber.
|
Objek Regs
Kolom | Jenis | Detail |
---|---|---|
coppa |
Bilangan bulat | 0 (default): COPPA tidak berlaku untuk permintaan ini.1 : Permintaan ini berlaku untuk COPPA. |
ext |
Ekstensi peraturan | Opsional. |
Objek ekstensi peraturan
Kolom | Jenis | Detail |
---|---|---|
gdpr |
Bilangan bulat | Menunjukkan apakah permintaan bid berasal dari wilayah EEA.0 (default): Wilayah non-EEA.1 : Wilayah EEA,Lihat Solusi Penyedia yang Memiliki Izin untuk GDPR untuk mengetahui detail selengkapnya. |
us_privacy |
String | Ikuti spesifikasi
teknis yang disediakan oleh IAB Tech Lab untuk menerapkan
string us_privacy .
Saat kami menerima string |
Objek Imp
Kolom | Jenis | Detail |
---|---|---|
id |
String | ID unik untuk tayangan ini dalam konteks permintaan bid (biasanya, nilai dimulai dengan 1, dan bertambah hingga n untuk n tayangan). |
metric |
Objek | Tidak didukung. |
banner |
Banner | Wajib untuk peluang iklan banner. |
video |
Video | Diperlukan untuk peluang iklan video. |
audio |
Audio | Wajib untuk peluang iklan audio. |
native |
Native | Wajib untuk peluang iklan native. |
pmp |
Pmp | Transaksi marketplace pribadi yang berlaku untuk tayangan ini. |
displaymanager |
String | Nama partner mediasi iklan, teknologi SDK, atau pemutar yang bertanggung jawab untuk merender iklan (biasanya video atau seluler). Digunakan oleh beberapa server iklan untuk menyesuaikan kode iklan menurut partner. Direkomendasikan untuk video dan/atau aplikasi. |
displaymanagerver |
String | Versi partner mediasi iklan, teknologi SDK, atau pemutar yang bertanggung jawab untuk merender iklan (biasanya video atau seluler). Digunakan oleh beberapa server iklan untuk menyesuaikan kode iklan menurut partner. Direkomendasikan untuk video dan/atau aplikasi. |
instl |
Bilangan bulat |
0 (default): tidak interstisial.1 : iklan adalah interstisial atau layar penuh.
|
tagid |
String | 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 |
Float | Bid minimum untuk tayangan iklan ini yang dinyatakan dalam CPM. |
bidfloorcur |
String |
Mata uang yang ditentukan menggunakan kode alfa ISO-4217. |
clickbrowser |
Bilangan bulat |
Menunjukkan jenis browser yang dibuka saat mengklik materi iklan di aplikasi. Perhatikan bahwa Safari View Controller di perangkat iOS 9.x dianggap sebagai browser bawaan untuk tujuan kolom ini. |
secure |
Bilangan bulat |
Jika tayangan ini memerlukan URL HTTPS yang aman, atau URL HTTP yang tidak aman.0 (default):tidak aman1 : aman
|
iframebuster |
Array string | |
exp |
Bilangan bulat | Masa berlaku bid ditetapkan oleh DV360 tanpa memperhatikan nilai yang dikirim oleh partner di kolom ini. Peristiwa tayangan iklan yang diterima setelah periode keusangan tayangan iklan (biasanya 1 jam) akan dihapus karena usang dan tidak dianggap dapat ditagih oleh DV360. |
rwdd |
Bilangan bulat |
Menunjukkan apakah pengguna menerima reward karena melihat iklan.0 (default): Tidak diberi reward1 : Diberi reward
Biasanya, penerapan iklan video memungkinkan pengguna membaca artikel berita tambahan secara gratis, menerima nyawa tambahan dalam game, atau mendapatkan sesi musik bebas iklan bersponsor. Reward biasanya didistribusikan setelah iklan video selesai. |
Objek ekstensi tayangan iklan
Kolom | Jenis | Detail |
---|---|---|
bcrid |
String | Daftar ID materi iklan yang harus diblokir. |
Objek banner
Kolom | Jenis | Detail |
---|---|---|
format |
Array format | Daftar format yang didukung. |
w |
Bilangan bulat |
format .
|
h |
Bilangan bulat |
format .
|
wmax |
Bilangan bulat | Tidak didukung. |
hmax |
Bilangan bulat | Tidak didukung. |
wmin |
Bilangan bulat | Tidak didukung. |
hmin |
Bilangan bulat | Tidak didukung. |
btype |
Array bilangan bulat |
Daftar jenis iklan Banner yang tidak diizinkan:
|
battr |
Array bilangan bulat | Mendukung nilai berikut:
|
pos |
Bilangan bulat |
Posisi iklan:
|
mimes |
Array string |
Tidak didukung.
DV360 akan menggunakan text/html untuk semua materi iklan banner. |
topframe |
Bilangan bulat |
0 (default): Banner ditayangkan di iframe.1 : Tidak didukung: Banner ditampilkan di frame atas.
|
expdir |
Array bilangan bulat |
1 : Kiri2 : Kanan3 : Atas4 : Bawah5 : Layar Penuh yang Dapat Diluaskan
|
api |
Array bilangan bulat |
Framework API yang Didukung
|
id |
String |
ID untuk objek banner dan harus unik dalam tayangan iklan.
Direkomendasikan saat objek |
vcm |
Bilangan bulat |
Hanya relevan untuk 0 : Banner terlihat bersamaan dengan materi iklan video.1 : Banner adalah kartu akhir setelah video.
|
Objek format
Kolom | Jenis | Detail |
---|---|---|
w |
Bilangan bulat | Lebar dalam piksel mandiri perangkat (DIPS). |
h |
Bilangan bulat | Tinggi dalam piksel independen perangkat (DIP). |
wratio |
Bilangan bulat | Tidak didukung. |
hratio |
Bilangan bulat | Tidak didukung. |
wmin |
Bilangan bulat | Tidak didukung. |
Objek video
Sebaiknya tentukan penempatan video dalam permintaan bid. Kolom penempatan yang tidak ada diklasifikasikan sebagai penempatan yang tidak diketahui. Lihat artikel tentang penargetan posisi untuk mengetahui detail selengkapnya.
Kolom | Jenis | Detail |
---|---|---|
mimes |
Array string |
Setidaknya diperlukan satu jenis MIME.
|
minduration |
Bilangan bulat | Durasi minimum video dalam hitungan detik, defaultnya tidak ada minimum. |
maxduration |
Bilangan bulat | Durasi maksimum video dalam detik, defaultnya adalah tidak ada durasi maksimum. |
protocols |
Array bilangan bulat |
Setidaknya diperlukan satu protokol yang didukung.
|
w |
Bilangan bulat | Lebar pemutar video dalam piksel independen perangkat (DIP). |
h |
Bilangan bulat | Tinggi pemutar video dalam piksel independen perangkat (DIP). |
startdelay |
Bilangan bulat | Penundaan mulai dalam detik untuk penempatan iklan pre-roll, mid-roll, atau post-roll. |
placement |
Bilangan bulat | Sangat direkomendasikan untuk menentukan plcmt (dan/atau) penempatan video dalam permintaan bid.
Jika kedua kolom tidak ada, penempatan akan diklasifikasikan sebagai penempatan tidak diketahui.
|
plcmt |
Bilangan bulat | Sangat direkomendasikan untuk menentukan plcmt (dan/atau) penempatan video dalam permintaan bid.
Jika kedua kolom tidak ada, penempatan akan diklasifikasikan sebagai penempatan tidak diketahui.
Catatan: Agar dianggap In-Stream (Jenis Penempatan atau Plcmt 1), penempatan/impresi video harus disetel ke “suara aktif” dan diberi sinyal dengan benar dalam Metode Pemutaran (Semua nilai 1, 3, 4, dan 5 memenuhi syarat).
Catatan: Jika memberikan plcmt: Accompanying Content (2) dianggap placement: In Article (3) plcmt: No Content/Standalone (4) dianggap placement: In feed (4) placement: In Banner tidak memiliki pemetaan di plcmt
|
linearity |
Bilangan bulat | Tidak didukung. |
skip |
Bilangan bulat |
Jika pemutar video akan mengizinkan iklan dilewati.
|
skipmin |
Bilangan bulat | Tidak didukung. |
skipafter |
Bilangan bulat | Tidak didukung. |
sequence |
Bilangan bulat | Jika beberapa tayangan iklan ditawarkan dalam permintaan bid yang sama, nomor urut akan memungkinkan penayangan beberapa materi iklan secara terkoordinasi. |
battr |
Array bilangan bulat | Atribut materi iklan yang diblokir. |
maxextended |
Bilangan bulat |
Durasi iklan video panjang maksimum, jika perpanjangan diizinkan.
|
minbitrate |
Bilangan bulat | Kecepatan bit minimum dalam Kbps. |
maxbitrate |
Bilangan bulat | Kecepatan bit maksimum dalam Kbps. |
boxingallowed |
Bilangan bulat |
Menunjukkan apakah tampilan lebar konten 4:3 ke jendela 16:9 diizinkan
|
playbackmethod |
Array bilangan bulat |
Metode pemutaran yang mungkin sedang digunakan. Jika tidak ada yang ditentukan, metode apa pun dapat digunakan.
|
playbackend |
Bilangan bulat |
Peristiwa yang menyebabkan pemutaran berakhir.
|
delivery |
Array bilangan bulat | Metode pengiriman yang didukung. Jika tidak ada yang ditentukan, asumsikan semua didukung.
|
pos |
Bilangan bulat |
Posisi iklan di layar.
|
companionad |
Array Banner | Iklan pengiring, jika tersedia. |
api |
Array bilangan bulat |
|
companiontype |
Array bilangan bulat | Tidak didukung. |
maxseq |
Bilangan bulat | Jumlah maksimum iklan yang akan ditampilkan dalam pod video dinamis. |
poddur |
Array bilangan bulat | Panjang maksimum pod video dinamis dalam detik. |
Ekstensi yang didukung untuk objek video
Kolom | Jenis | Detail |
---|---|---|
rewarded |
Bilangan bulat | Kolom ini untuk memberi sinyal apakah permintaan diberi reward atau tidak. Nilai ini harus
dikirim sebagai bilangan bulat.
|
Objek audio
Kolom | Jenis | Detail |
---|---|---|
mimes |
Array string |
Setidaknya diperlukan satu jenis MIME.
|
minduration |
Bilangan bulat | Durasi iklan minimum dalam detik. |
maxduration |
Bilangan bulat | Durasi iklan maksimum dalam detik. |
protocols |
Array bilangan bulat |
|
startdelay |
Bilangan bulat | Penundaan mulai dalam detik untuk penempatan iklan pre-roll, mid-roll, atau post-roll.
|
sequence |
Bilangan bulat | Tidak didukung. |
battr |
Array bilangan bulat | Tidak didukung. |
maxextended |
Bilangan bulat | Tidak didukung. |
minbitrate |
Bilangan bulat | Kecepatan bit minimum dalam Kbps. |
maxbitrate |
Bilangan bulat | Kecepatan bit maksimum dalam Kbps. |
delivery |
Array bilangan bulat | Tidak didukung. |
companionad |
Array Banner object | Slot materi iklan pengiring banner. |
api |
Array bilangan bulat |
Daftar framework API yang didukung untuk tayangan ini.
|
companiontype |
Array bilangan bulat | Tidak didukung. |
maxseq |
Array bilangan bulat | Tidak didukung. |
feed |
Bilangan bulat |
Jenis feed audio.
|
stitched |
Bilangan bulat | Tidak didukung. |
nvol |
Bilangan bulat | Tidak didukung. |
Objek native
Lihat spesifikasi iklan native DV360 untuk mengetahui detail selengkapnya.
Kolom | Jenis | Detail |
---|---|---|
request |
String | Objek JSON native yang dienkode string. |
ver |
String |
1.0 : Tidak didukung1.1 : Tidak didukung1.2
|
api |
Array bilangan bulat |
Daftar framework API yang didukung untuk tayangan ini.
|
battr |
Array bilangan bulat | Tidak didukung. |
Objek PMP
Kolom | Jenis | Detail |
---|---|---|
private_auction |
Bilangan bulat |
0 (Default): Semua bid diizinkan1 : Hanya penawaran
|
deals |
Array objek transaksi | Kesepakatan yang akan disertakan. |
Objek transaksi
Kolom | Jenis | Detail |
---|---|---|
id |
String | Objek PMP tidak boleh berisi lebih dari satu objek transaksi per ID. |
bidfloor |
Ganda |
Bid minimum untuk tayangan iklan ini dalam CPM.
Wajib jika |
bidfloorcur |
String |
Mata uang yang ditentukan menggunakan kode alfa ISO-4217.
Jika tidak ditentukan, defaultnya adalah mata uang permintaan bid. |
at |
Bilangan bulat |
Nilai defaultnya adalah bid_request.at jika tidak ditentukan.
|
wseat |
Array string |
ID partner dari partner yang memenuhi syarat untuk transaksi.
Tidak ada kursi berarti tidak ada batasan kursi. |
wadomain |
Array string |
Domain pengiklan yang diizinkan untuk mengajukan bid pada transaksi ini.
Tidak ada kursi berarti tidak ada batasan domain. |
guar |
Bilangan bulat |
Kolom ini digunakan untuk menandakan apakah kesepakatan adalah kesepakatan yang dijamin. Nilai ini harus dikirim sebagai bilangan bulat.
Exchange harus masuk daftar yang diizinkan agar DV360 dapat menerima transaksi dijamin; hubungi kami untuk meminta hal ini. Jika saat ini bursa Anda menggunakan mekanisme yang berbeda untuk menandai transaksi yang dijamin dengan DV360, hubungi kami untuk membahas peralihan ke ekstensi pilihan ini.
|
ext |
Ekstensi penawaran | Opsional. |
Ekstensi yang didukung untuk objek transaksi
Kolom | Jenis | Detail |
---|---|---|
guaranteed |
Bilangan bulat |
Kolom ini digunakan untuk menandakan apakah kesepakatan adalah kesepakatan yang dijamin. Nilai ini harus dikirim sebagai bilangan bulat.
Exchange harus masuk daftar yang diizinkan agar DV360 dapat menerima transaksi dijamin; hubungi kami untuk meminta hal ini. Jika saat ini bursa Anda menggunakan mekanisme yang berbeda untuk menandai transaksi yang dijamin dengan DV360, hubungi kami untuk membahas peralihan ke ekstensi pilihan ini.
Sebaiknya gunakan |
Objek situs
Kolom | Jenis | Detail |
---|---|---|
id |
String | ID situs di bursa. |
name |
String | Tidak didukung. |
domain |
String |
Domain situs.
Sebaiknya kirim URL lengkap di site.page, bukan hanya mengisi site.domain. |
cat |
Array string | Tidak didukung. |
sectioncat |
Array string | Tidak didukung. |
pagecat |
Array string | Tidak didukung. |
page |
String |
URL lengkap tempat tayangan iklan akan ditampilkan.
Sebaiknya kirimkan URL lengkap untuk tujuan penargetan. |
ref |
String | URL perujuk yang menyebabkan navigasi ke halaman saat ini. |
search |
String | Tidak didukung. |
mobile |
Bilangan bulat | Tidak didukung. |
privacypolicy |
Bilangan bulat | Tidak didukung. |
publisher |
Objek penayang | Detail tentang penayang situs. |
content |
Objek konten | Detail tentang konten dalam situs. |
keywords |
String (format CSV) | Tidak didukung. |
ext |
Ekstensi situs | Ekstensi untuk objek situs. |
Objek ekstensi situs
Kolom | Jenis | Detail |
---|---|---|
inventorypartnerdomain |
String | Digunakan untuk berbagi inventaris CTV, lihat Penjelasan penambahan aplikasi CTV IAB. |
Objek aplikasi
Kolom | Jenis | Detail |
---|---|---|
id |
String | ID aplikasi di bursa. |
name |
String |
Nama aplikasi, yang dapat diberi alias atas permintaan penayang.
Nama aplikasi untuk permintaan tanpa SDK (sebagian besar TV yang terhubung) dapat diberikan oleh penayang langsung dalam permintaan. |
bundle |
String |
Wajib.
Untuk iOS, kolom ini harus berupa ID app store numerik. Kami tidak menerima ID paket gaya DNS terbalik. Untuk aplikasi CTV, sebaiknya teruskan ID aplikasi yang ditentukan app store. Harap patuhi pedoman ID yang ditetapkan untuk Toko IAB OTT/CTV yang dipublikasikan baru-baru ini. |
domain |
String | Domain, misalnya mygame.foo.com |
storeurl |
String | Diperlukan untuk verifikasi app-ads.txt dan validasi app store TV yang Terhubung. |
cat |
Array string | Tidak didukung. |
sectioncat |
Array string | Tidak didukung. |
pagecat |
Array string | Tidak didukung. |
ver |
String | Tidak didukung. |
privacypolicy |
Bilangan bulat | Tidak didukung. |
paid |
Bilangan bulat | Tidak didukung. |
publisher |
Objek penayang | Informasi tentang penerbit aplikasi. |
content |
Objek konten | Informasi tentang konten aplikasi. |
keywords |
String (format CSV) | Tidak didukung. |
ext |
Ekstensi aplikasi | Ekstensi untuk objek aplikasi. |
Objek ekstensi aplikasi
Kolom | Jenis | Detail |
---|---|---|
inventorypartnerdomain |
String | Digunakan untuk berbagi inventaris CTV, lihat Penjelasan penambahan aplikasi CTV IAB. |
Objek konten
Sebaiknya teruskan atribut ini jika tersedia.
Kolom | Jenis | Detail |
---|---|---|
id |
String | ID yang mengidentifikasi konten secara unik. |
episode |
Bilangan bulat | Nomor episode konten (biasanya untuk konten video). |
title |
String | Direkomendasikan untuk permintaan CTV, video, dan audio. |
series |
String | Direkomendasikan untuk permintaan CTV, video, dan audio. |
season |
String | Label untuk musim konten. |
artist |
String | Artis yang dikreditkan dengan konten. |
genre |
String | Genre yang paling tepat menggambarkan konten. DV360 merekomendasikan penyediaan sinyal ini untuk permintaan CTV, video, dan audio.
DV360 mendukung beberapa taksonomi nilai genre video untuk kolom ini: |
album |
String | Album tempat konten berada, biasanya untuk audio. |
isrc |
String | International Standard Recording Code yang sesuai dengan ISO-3901. |
producer |
Objek produsen | Detail tentang produser konten. |
url |
String | URL konten. |
cat |
Array string | Kategori konten IAB yang menjelaskan konten. |
prodq |
Bilangan bulat |
Kualitas produksi:
|
videoquality |
Bilangan bulat | Tidak didukung. |
context |
Bilangan bulat |
Jenis konten:
|
contentrating |
String | Direkomendasikan untuk Audio & Video/CTV, karena kami akan mulai membuat keputusan berdasarkan atribut ini. |
userrating |
String | Jumlah bintang, suka, dll... |
qagmediarating |
Bilangan bulat |
Peringkat media per [pedoman QAG](http://www.iab.net/ne_guidelines).
|
keywords |
String (format CSV) | Tidak didukung. |
livestream |
Bilangan bulat |
Jika konten adalah konten live stream.
|
sourcerelationship |
Bilangan bulat |
|
len |
Bilangan bulat |
Durasi konten dalam detik.
Direkomendasikan untuk permintaan CTV/video dan audio. |
language |
String (ISO-639-1-alpha-2) | Bahasa konten. |
embeddable |
Bilangan bulat |
Indikator apakah konten dapat disematkan atau tidak (misalnya, pemutar video yang dapat disematkan)
|
data |
Array Objek data | Data tambahan. |
Objek produser
Kolom | Jenis | Detail |
---|---|---|
id |
String | Tidak didukung. |
name |
String | Tidak didukung. |
cat |
Array string | Tidak didukung. |
domain |
String | Domain tingkat tertinggi produsen. |
Objek data
Kolom | Jenis | Detail |
---|---|---|
id |
String | ID penyedia data. |
name |
String | Nama pertukaran untuk penyedia data. |
segment |
Array objek Segmen | Nilai data sebenarnya. |
ext |
Ekstensi data | Ekstensi untuk objek Data. |
Ekstensi yang didukung untuk objek data
Kolom | Jenis | Detail |
---|---|---|
segtax |
Bilangan bulat | ID Taksonomi, lihat Taksonomi Segmen untuk mengetahui detail selengkapnya. |
segclass |
String | Versi pengklasifikasi yang menghasilkan ID segmen dalam taksonomi. |
Objek segmen
Kolom | Jenis | Detail |
---|---|---|
id |
String | ID segmen data yang khusus untuk penyedia data. |
name |
String | Nama segmen data. |
value |
String | Nilai segmen data. |
Objek penayang
Kolom | Jenis | Detail |
---|---|---|
id |
String | Wajib. |
name |
String | Tidak didukung. |
cat |
Array string | Tidak didukung. |
domain |
String | Tidak didukung. |
Objek perangkat
Kolom | Jenis | Detail |
---|---|---|
ua |
String | Wajib. |
sua |
Objek UserAgent | Informasi agen pengguna terstruktur. |
geo |
Objek geografis | Lokasi perangkat. |
dnt |
Bilangan bulat |
Tanda Jangan Lacak sebagaimana ditetapkan di header browser.
|
lmt |
Bilangan bulat |
Sinyal Batasi Pelacakan Iklan yang didukung secara komersial.
|
ip |
String |
Wajib jika IPv4.
Jika alamat IP dipangkas, alamat IP harus dideklarasikan di |
ipv6 |
String |
Wajib jika IPv6.
Jika alamat IP dipangkas, alamat IP harus dideklarasikan di |
devicetype |
Bilangan bulat | Sangat direkomendasikan untuk semua jenis inventaris. Digunakan untuk meningkatkan pengenalan jenis perangkat. |
make |
String | |
model |
String | |
os |
String |
Sistem operasi perangkat.
Kolom ini tidak peka huruf besar/kecil. |
osv |
String | Tidak didukung. |
hwv |
String | Versi hardware perangkat. |
h |
Bilangan bulat | Tinggi fisik layar dalam piksel. |
w |
Bilangan bulat | Lebar fisik layar dalam piksel. |
ppi |
Bilangan bulat | Tidak didukung. |
pxratio |
Ganda | Rasio piksel fisik terhadap piksel mandiri perangkat. |
js |
Bilangan bulat | Tidak didukung. |
geofetch |
Bilangan bulat | Tidak didukung. |
flashver |
String | Tidak didukung. |
language |
String (ISO-639-1-alpha-2) | Bahasa perangkat. |
carrier |
String | Tidak didukung. |
mccmnc |
String | Tidak didukung. |
connectiontype |
Bilangan bulat | Jenis koneksi jaringan |
ifa |
String | ID yang disetujui untuk digunakan pengiklan tanpa enkripsi. |
didsha1 |
String | Tidak didukung. |
didmd5 |
String | Tidak didukung. |
dpidsha1 |
String | Tidak didukung. |
dpidmd5 |
String | Tidak didukung. |
macsha1 |
String | Tidak didukung. |
macmd5 |
String | Tidak didukung. |
ext |
Ekstensi perangkat | Ekstensi untuk objek perangkat. |
Ekstensi yang didukung untuk objek perangkat
Jika ip
diubah atau dipangkas, sebaiknya kirim ekstensi berikut untuk mencegah traffic dinyatakan sebagai traffic tidak valid.
Kolom | Jenis | Detail |
---|---|---|
truncated_ip |
Bilangan bulat |
Menunjukkan apakah alamat IP di kolom device.ip pada
permintaan bid dipangkas atau tidak.
Default tidak dipangkas, dan diperlukan jika alamat IP dipangkas. Jika tidak dideklarasikan, permintaan bid dapat diklasifikasikan sebagai traffic tidak valid. |
ifa_type |
String |
Menunjukkan asal kolom device.ifa, apakah disediakan dari
perangkat itu sendiri atau dibuat oleh penayang atau SSP dalam rantai suplai.
|
attestation_token |
String (encoding base64) | Token pengesahan berbasis perangkat untuk bursa yang mendukung tingkat validasi perangkat tersebut. |
atts |
Bilangan bulat |
(Khusus iOS) Bilangan bulat yang diteruskan untuk merepresentasikan status otorisasi pelacakan aplikasi.
|
cdep |
String |
Label penghentian penggunaan cookie pihak ketiga Chrome.
Lihat Pengujian yang difasilitasi Chrome dan Spesifikasi Komunitas IAB |
Objek UserAgent
Kolom | Jenis | Detail |
---|---|---|
browsers |
Array objek BrandVersion | Setiap objek BrandVersion mengidentifikasi browser atau komponen software serupa. |
platform |
Objek BrandVersion | Mengidentifikasi platform. |
mobile |
Bilangan bulat |
0 (default): Agen lebih memilih konten "desktop" atau "lengkap".
1 : Agen lebih memilih konten "seluler".
|
architecture |
String | Arsitektur perangkat, misalnya, "x86" atau "arm". |
bitness |
String | Bit perangkat, misalnya, "64" untuk arsitektur 64-bit. |
model |
String | Model perangkat. |
source |
Bilangan bulat | Sumber data yang digunakan untuk membuat objek ini, lihat List: User-Agent Source. Direkomendasikan saat meneruskan objek UserAgent. |
Objek BrandVersion
Kolom | Jenis | Detail |
---|---|---|
brand |
String | ID merek, misalnya, "Chrome" atau "Windows". Wajib. |
version |
Array string | Urutan komponen versi, dalam urutan hierarki menurun (major, minor, micro, dan sebagainya). |
Objek Geo
Kolom | Jenis | Detail |
---|---|---|
lat |
Ganda | Tidak didukung. |
lon |
Ganda | Tidak didukung. |
type |
Bilangan bulat | Tidak didukung. |
accuracy |
Bilangan bulat | Tidak didukung. |
lastfix |
Bilangan bulat | Tidak didukung. |
ipservice |
Bilangan bulat | Tidak didukung. |
country |
String | Tidak didukung. |
region |
String | Tidak didukung. |
regionfips104 |
String | Tidak didukung. |
metro |
String | Tidak didukung. |
city |
String | Tidak didukung. |
zip |
String | Tidak didukung. |
utcoffset |
Bilangan bulat | Tidak didukung. |
Objek pengguna
Kolom | Jenis | Detail |
---|---|---|
id |
String | Didukung jika Google menghosting tabel pencocokan ID. |
buyeruid |
String | Didukung jika SSP menghosting tabel pencocokan ID. |
yob |
Bilangan bulat | Direkomendasikan untuk penargetan demografi. |
gender |
String | Direkomendasikan untuk penargetan demografi. |
keywords |
String (CSV) | Tidak didukung. |
customdata |
String | Tidak didukung. |
geo |
Objek geografis | Tidak didukung. |
data |
Array Objek data | Data tambahan. |
eids |
Array objek ID yang Diperluas | Instance ID yang diperluas yang disediakan oleh bursa. |
ext |
Ekstensi pengguna | Ekstensi untuk objek pengguna. |
Ekstensi yang didukung untuk objek pengguna
Kolom | Jenis | Detail |
---|---|---|
consent |
String (base64 yang aman untuk web) |
String izin IAB.
Berisi metadata tentang informasi apa yang telah diizinkan pengguna untuk dikumpulkan, dan vendor mana yang diizinkan untuk menggunakan informasi tersebut. Nilainya adalah string biner berenkode base64 yang aman untuk web menggunakan format biner kustom. |
us_privacy |
String | Jika pengguna telah melihat kepatuhan terhadap CCPA atau hukum serupa. |
consented_providers_settings .consented_providers |
Objek luar (consented_providers_settings) yang membungkus array Integer dalam (consented_providers). | Jika izin GDPR dikumpulkan melalui TCF, kolom ini mencantumkan penyedia teknologi iklan yang disetujui pengguna yang tidak berpartisipasi dalam TCF. Lihat 'Spesifikasi teknis Izin Tambahan Google.' |
eids |
Array objek ID yang Diperluas | Instance ID yang diperluas yang disediakan oleh bursa. |
Objek ID yang diperluas
Kolom | Jenis | Detail |
---|---|---|
source |
String | Penyedia ID |
uids |
Array objek UID ID yang Diperluas | ID sebenarnya |
Objek UID ID yang diperluas
Kolom | Jenis | Detail |
---|---|---|
id |
String | ID itu sendiri. |
atype |
Bilangan bulat | Jenis agen pengguna yang terkait dengan ID ini. |
Objek supply chain
Kolom | Jenis | Detail |
---|---|---|
complete |
Bilangan bulat | 0 (default): Rantai pasokan tidak lengkap.1 : Rantai pasokan selesai hingga ke penayang.
|
ver |
String | Wajib. Nilai diformat "major.minor", misalnya, versi 1.0 adalah string "1.0". |
nodes |
Array node supply chain | Wajib. Dalam rantai pasokan yang lengkap, node pertama merepresentasikan sistem iklan awal dan ID penjual yang terlibat dalam transaksi, yaitu pemilik situs, aplikasi, atau media lainnya. Dalam rantai pasokan yang tidak lengkap, node ini mewakili node pertama yang diketahui. Node terakhir mewakili entitas yang mengirimkan permintaan bid ini. |
Objek node supply chain
Kolom | Jenis | Detail |
---|---|---|
asi |
String | Nama domain kanonis SSP, Exchange, Header Wrapper, dll.
sistem tempat bidder terhubung. Ini mungkin adalah domain operasional sistem, jika berbeda dengan domain perusahaan induk, untuk memfasilitasi pencarian IP balik dan WHOIS guna menetapkan kepemilikan yang jelas atas sistem yang didelegasikan.
Nilai ini harus sama dengan nilai yang digunakan untuk mengidentifikasi penjual dalam file ads.txt jika ada. |
sid |
String | ID yang terkait dengan akun penjual atau reseller dalam
sistem periklanan. Kolom ini harus berisi nilai yang sama dengan yang digunakan dalam
transaksi (yaitu permintaan bid OpenRTB) di kolom yang ditentukan oleh
SSP/bursa.
Biasanya, di OpenRTB, nilai ini adalah publisher.id. Untuk OpenDirect, biasanya nilai ini adalah ID organisasi penayang. Panjangnya harus dibatasi hingga 64 karakter. |
rid |
String | RequestId OpenRTB permintaan seperti yang dikeluarkan oleh penjual ini. |
name |
String | Nama perusahaan (entitas hukum) yang dibayar untuk inventaris yang ditransaksikan dengan seller_id tertentu. Nilai ini bersifat opsional dan JANGAN disertakan jika ada di file sellers.json sistem periklanan. |
domain |
String | Nama domain bisnis entitas yang diwakili oleh node ini.
Nilai ini bersifat opsional dan TIDAK boleh disertakan jika ada di file sellers.json sistem periklanan. |
hp |
Bilangan bulat | Menunjukkan apakah node ini akan terlibat dalam alur pembayaran
untuk inventaris.
Untuk SupplyChain versi 1.0, properti ini harus selalu 1. Secara eksplisit harus disertakan karena diharapkan versi spesifikasi mendatang akan memperkenalkan node penanganan non-pembayaran. Pelaksana harus memastikan bahwa mereka mendukung kolom ini dan meneruskannya saat membuat objek SupplyChain dalam permintaan bid yang dikirim ke sistem iklan downstream. |
Spesifikasi respons bid
Objek BidResponse
Atribut | Didukung | Detail implementasi | Selalu lulus |
---|---|---|---|
id | Jika terjadi error parsing, nilai ini mungkin '0', bukan ID permintaan bid. | Ya | |
seatbid | |||
bidid | |||
cur | Jika terjadi error penguraian, hal ini tidak akan diteruskan. Untuk traffic permintaan bid yang valid cur selalu diberikan. | Ya | |
customdata | |||
nbr |
Ini hanya disertakan jika masalah ditemukan pada permintaan bid. Kemungkinan nilai mencakup:2 : Permintaan Tidak Valid12 : Pelanggaran Otorisasi Ads.txt16 : SupplyChain Tidak Lengkap17 : Node SupplyChain DiblokirCatatan: Jika pelanggaran spesifik (app-)ads.txt atau SupplyChain terdeteksi, salah satu kode 12, 16, atau 17 akan diisi pada sebagian kecil (1%) respons. Kode 2 akan diisi untuk semua permintaan tidak valid lainnya. Permintaan yang menyertakan NBR akan terlihat seperti ini: { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } } |
||
ext | Jika ada masalah dengan permintaan bid, ekstensi mungkin berisi informasi untuk membantu mendiagnosis error, jika didukung. |
Ekstensi yang didukung untuk objek BidResponse
Atribut | Detail implementasi |
---|---|
err | Deskripsi error yang dapat dibaca manusia terkait permintaan bid. Kasus respons mencakup:
|
errHelp | Link ke halaman ini. |
Objek seatbid
Atribut | Didukung | Detail implementasi | Selalu lulus |
---|---|---|---|
bid | ya | ||
tempat | ya | ||
grup |
Objek bid
Atribut | Didukung | Detail implementasi | Selalu lulus |
---|---|---|---|
id | ya | ||
impid | ya | ||
harga | ya | ||
nurl | |||
burl | |||
lurl | |||
adm | |||
adid | |||
adomain | |||
bundle | |||
iurl | |||
cid | ya | ||
crid | ya | ||
taktik | |||
kucing | |||
attr | |||
api | |||
protokol | |||
qagmediarating | |||
language | |||
dealid | |||
w | |||
j | |||
wratio | |||
hratio | |||
exp |
Ekstensi yang didukung untuk objek bid
Atribut | Detail implementasi |
---|---|
apis |
DV360 akan mengirim seatbid.bid.apis jika OMID dan MRAID didukung. DV360 akan menetapkan OMID_1 dan MRAID sebagai array bilangan bulat. |
Opsi penayangan iklan
Di bagian 4.3 spesifikasi OpenRTB, ada dua opsi penayangan yang berbeda:
- Markup ditayangkan pada pemberitahuan kemenangan
- Markup ditayangkan dalam bid
DV360 mendukung kedua opsi tersebut.
- Untuk iklan Banner, DV360 selalu menampilkan markup di kolom
adm
. Markup yang ditayangkan pada pemberitahuan kemenangan bersifat opsional. - Untuk iklan Video/Audio yang menggunakan protokol VAST, DV360 mendukung pengembalian XML VAST di kolom
adm
atau dalam respons pemberitahuan kemenangan berdasarkan persyaratan dari partner bursa.
Lihat spesifikasi OpenRTB untuk mengetahui kelebihan dan kekurangan kedua opsi ini.
Praktik terbaik
Sebaiknya gunakan ID Partner Display & Video 360 sebagai ID tempat. Penggunaan ID tempat iklan khusus bursa tidak direkomendasikan.
Pastikan penayang Anda memiliki file ads.txt, atau aplikasi dengan file app-ads.txt terkait, dan mereka mencantumkan Anda dalam file tersebut sebagai penjual atau reseller resmi. Pelajari lebih lanjut.
Pastikan juga informasi yang konsisten diteruskan dalam permintaan bid. Misalnya, app.bundle
harus konsisten dengan informasi perangkat seluler dan
app.storeurl
.
TV yang terhubung
Patuhi pedoman IFA OTT IAB
dalam meneruskan device.ifa
dan device.lmt
. Anda juga harus menerapkan
device.ext.ifa_type
agar mematuhi pedoman. Semua kemampuan pembatasan frekuensi dan penargetan audiens CTV kami akan memerlukan kehadiran IFA.
Selain itu, patuhi pedoman ID yang Ditetapkan Toko OTT/CTV IAB yang baru dipublikasikan—hal ini mendefinisikan cara app.bundle
harus diteruskan untuk aplikasi CTV—sebagian besar menggunakan ID yang ditentukan app store.
Pengukuran Tampilan Aktif
Tampilan Aktif adalah teknologi Google yang digunakan untuk mengukur apakah tayangan iklan dapat dilihat dan berapa lama durasinya. Tampilan Aktif menggunakan OMID untuk iklan display dan video. Untuk mengaktifkan pengukuran menggunakan OMID, bursa harus menambahkan kolom berikut dalam permintaan OpenRTB agar DV360 mengetahui dukungan klien terhadap OMID.
- Wajib: Tambahkan Framework API (
Video.api=7
untukOMSDK
) ke permintaan bid. Hal ini wajib agar Tampilan Aktif dapat melakukan pengukuran menggunakan OMID. - Direkomendasikan: Menambahkan
omidpn
danomidpv
keSource.Ext
sangat direkomendasikan karena akan memengaruhi cara pengukuran keaktifan dilaporkan di DV360 kepada pelanggan. Jika nama partner OMID tidak ada dalam daftar sertifikasi IAB, kami diwajibkan oleh MRC untuk melaporkan metrik visibilitas secara terpisah dari metrik bersertifikasi MRC. Pelajari lebih Lanjut.
FAQ
- Apakah DV360 Mendukung ekstensi kustom bursa?
- Ya, selain ekstensi yang tercantum dalam spesifikasi ini, Display & Video 360 juga dapat mendukung ekstensi kustom berdasarkan kasus per kasus. Sebaiknya tentukan dan uji ekstensi kustom selama periode integrasi.
- Apakah DV360 mendukung video reward?
- Ya, kirimkan ekstensi video reward kepada kami.
- Banyak inventaris saya ditampilkan sebagai demografi tidak diketahui, bagaimana cara meningkatkan cakupan demografi?
- Isi
user.yob
danuser.gender
dalam permintaan bid ke DV360 untuk meningkatkan cakupan. - Apakah DV360 memiliki endpoint untuk setiap wilayah?
- Tidak, kami menggunakan satu endpoint secara global dan kami otomatis merutekan permintaan ke pusat data terdekat, jadi tidak ada endpoint khusus per region yang dapat kami berikan.
- Apa saja persyaratan untuk permintaan server-ke-server (s2s)?
- Hubungi kami untuk meminta penambahan ke daftar yang diizinkan. Agen Pengguna klien harus diteruskan, dan pastikan cookie dinonaktifkan/diabaikan dalam respons terhadap pengambilan VAST s2s.
- Apakah DV360 mendukung OMID?
- Kami dapat mengukur viewability menggunakan OMID selama OMID dinyatakan sebagai diaktifkan untuk OMID pada saat permintaan bid. Detail tentang hal ini diringkas di halaman 24-25.
- Versi Native mana yang Anda dukung? Apakah Anda memiliki persyaratan Native?
- Kami hanya mendukung Native Ver1.2. Spesifikasi native.
- Apakah DV360 mendukung permintaan bid yang dikirim sebagai GZIP?
- DV360 dapat menerima permintaan bid yang dikompresi gzip, dan akan merespons dengan respons yang dikompresi gzip jika header Accept-Encoding menunjukkan bahwa kompresi gzip didukung.
- Apakah DV360 mendukung DBURL?
- Tidak pada saat ini.
- Apakah DV360 mendukung notifikasi menang/kalah?
- Tidak pada saat ini. Jika menurut Anda sebaiknya kami mendukungnya, harap hubungi kami untuk memberikan detail selengkapnya.
- Apakah DV360 memerlukan App.name untuk penargetan?
- Tidak, DV360 menggunakan App.name untuk referensi, tetapi tidak diperlukan untuk penargetan,
App.bundle
digunakan untuk penargetan. - Dapatkah DV360 mendukung beberapa ukuran iklan yang dikirim dalam satu permintaan bid?
- Ya, kami akan mempertimbangkan semua ukuran materi iklan yang memenuhi syarat dalam banner.format.
- Apakah DV360 mendukung beberapa format dalam permintaan bid yang sama?
- Kami memiliki dukungan terbatas untuk permintaan bid multi-format, tetapi sedang berupaya meningkatkannya. Kami mendukung format display & video untuk iklan interstisial, tetapi saat ini tidak mendukung format display & native. Jika Anda mengirim permintaan bid multi-format, hubungi kami untuk meminta pengujian.
- Apakah DV360 mendukung jenis tayangan campuran dalam permintaan yang sama?
- Saat ini kami hanya mendukung interstisial video/banner. Kami sedang berupaya membuat banner & video/banner native. Jika ada kombinasi lain, hubungi tim kami.
- Dapatkah beberapa kursi masing-masing mengirimkan beberapa bid pada satu atau beberapa peluang tayangan iklan tersebut dalam permintaan yang sama?
- Ya.
- Apakah DV360 memiliki solusi atau kebutuhan khusus terkait pembatasan atau menampilkan pengiklan yang sama untuk beberapa peluang tayangan iklan tersebut dalam permintaan yang sama?
- DV360 menerapkan bahwa satu pengiklan hanya dapat mengajukan bid hingga satu peluang tayangan iklan untuk setiap permintaan. Kami berharap SSP mengelompokkan objek tayang iklan secara bermakna; misalnya, semua di halaman yang sama, semua di aplikasi yang sama, dll.
- Apakah DV360 mendukung beberapa tayangan iklan dalam permintaan bid yang sama?
- DV360 saat ini mendukung beberapa objek audio tayangan iklan. Namun, kami perlu menguji/mengaktifkan setiap bursa yang ingin menggunakan fitur ini. Lihat spesifikasi permintaan bid untuk mengetahui informasi selengkapnya. Kami sedang berupaya memperluas ketersediaan fitur ini ke format lainnya:
{ id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38", seatbid { bid { id: "0", impid: "234232", price: 41.373926619828261, adid: "123", adm: "...", adomain: "xxx.com", cid: "0", crid: "123", dealid: "sample-deal-id-1", language: "xx", }, bid { id: "1", impid: "234255", price: 2.34192037470726, adid: "234", adm: "...", adomain: "xyz.com", cid: "0", crid: "234", dealid: "sample-deal-id-2", language: "xx", }, seat: "123456" }, cur: "EUR" }
Hubungi kami
Jika ada pertanyaan atau masalah, hubungi tim dukungan bursa kami.