Iklan Video

Panduan ini menguraikan persyaratan integrasi, konfigurasi, dan kolom protokol OpenRTB yang relevan yang dapat Anda gunakan saat mengajukan bid pada inventaris video. Protokol Google RTB tidak digunakan lagi, dan tidak akan menjadi fokus dalam panduan ini. Untuk informasi tentang iklan video dalam protokol Google RTB, lihat panduan Iklan Video di Google RTB.

Google mendukung iklan video in-stream, native, dan interstisial. Lihat panduan untuk format iklan Native dan Interstisial untuk mengetahui detail selengkapnya tentang format tersebut.

Persyaratan pembeli

Protokol RTB

Panduan ini umumnya akan merujuk pada format Protobuf, tetapi nama dan jalur kolom setara antara format tersebut dan format JSON, kecuali jika dinyatakan lain.

Anda dapat menemukan proto OpenRTB dan ekstensi OpenRTB khusus Google di halaman Proto dan data referensi. Untuk informasi selengkapnya tentang cara mengembangkan bidder, lihat Memproses Permintaan dan Mem-build Respons.

Peninjauan materi iklan

Google merekomendasikan agar Anda mengirimkan materi iklan untuk disetujui sebelum melakukan bidding dengan materi iklan tersebut. Anda dapat menggunakan Resource materi iklan Real-time Bidding API untuk memulai proses peninjauan.

Konfigurasi pra-penargetan

Untuk menerima inventaris video, akun Authorized Buyers Anda harus membuat konfigurasi pra-penargetan yang menyertakan inventaris video.

Makro

Anda dapat menentukan makro di link URL video atau VAST XML yang ditentukan di BidResponse.seatbid.bid.adm. Selain itu, jika menentukan URL video, Anda juga dapat menempatkan makro dalam dokumen XML VAST tertaut. Makro berikut didukung untuk materi iklan video:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Makro klik seperti CLICK_URL_ESC tidak didukung karena Authorized Buyers menyertakan pelacak kliknya dalam wrapper VAST. Untuk informasi selengkapnya tentang makro yang didukung, lihat Menentukan makro.

Detail info

Anda dapat menggunakan kolom BidRequest.imp.video OpenRTB untuk mengidentifikasi apakah permintaan bid yang masuk ditujukan untuk inventaris video in-stream atau interstisial dan menemukan informasi khusus video tambahan tentang permintaan tersebut. Selain itu, untuk inventaris iklan native, Anda dapat menggunakan BidRequest.imp.native.{request/request_native}.assets.video untuk informasi khusus video yang serupa.

BidRequest.{app/site}.content.producer.domain

URL, tanpa parameter, dari halaman yang menjelaskan konten video. Penayang mengirimkan URL ini ke Google. Contoh:

http://www.publisher.com/watchpagelink
banner.vcm
Jika ditetapkan ke true, iklan pengiring dapat dipilih untuk dirender sebagai penutup akhir (kartu info) di slot video setelah iklan video selesai diputar. Jika tidak, iklan pengiring tidak akan dirender sebagai penutup akhir.
BidRequest.imp.rwdd
Jika ditetapkan ke true, ini menunjukkan bahwa pengguna menerima reward karena menonton iklan video. Reward yang umum mungkin berupa membaca artikel tambahan secara gratis, menerima nyawa tambahan dalam game, atau mendapatkan sesi musik bebas iklan bersponsor.
BidRequest.imp.video.maxduration

Durasi maksimum yang diizinkan dalam detik untuk iklan yang harus Anda tampilkan. Jika tidak ditetapkan, tidak ada durasi maksimum. Jika BidRequest.imp.video.skip adalah true, hal ini dapat berperilaku berbeda. Lihat Durasi maksimal video yang dapat dilewati untuk mengetahui detail selengkapnya.

BidRequest.imp.video.maxseq

Jumlah maksimum iklan dalam pod video. Jika tidak ditetapkan, slot iklan tidak merupakan bagian dari pod video.

Jumlah sebenarnya iklan video yang ditampilkan dapat kurang dari atau sama dengan nilai ini, tetapi tidak boleh melebihinya.

BidRequest.imp.video.minduration
Durasi minimum dalam detik untuk iklan yang harus Anda tampilkan. Jika tidak ditetapkan, tidak ada durasi minimum.
BidRequest.imp.video.plcmt
Menjelaskan tempat video akan diputar.
PLCMT_UNKNOWN Penempatan tidak diketahui atau tidak dapat ditentukan.
PLCMT_INSTREAM Iklan pre-roll, mid-roll, dan post-roll yang diputar sebelum, selama, atau setelah konten video streaming yang telah diminta konsumen. Video in-stream harus disetel ke "suara aktif" secara default saat pemutar dimulai, atau memiliki niat pengguna yang jelas secara eksplisit untuk menonton konten video. Meskipun mungkin ada konten lain di sekitar pemutar, konten video harus menjadi fokus kunjungan pengguna. Video tersebut harus tetap menjadi konten utama di halaman dan satu-satunya pemutar video dalam tampilan yang dapat memutar audio saat diputar. Jika pemutar dikonversi menjadi mengambang/melekat, panggilan iklan berikutnya harus menyampaikan ukuran pemutar yang diperbarui secara akurat.
PLCMT_ACCOMPANYING_CONTENT Iklan pre-roll, mid-roll, dan post-roll yang diputar sebelum, selama, atau setelah streaming konten video. Pemutar video dimuat dan diputar sebelum, di antara, atau setelah paragraf teks atau konten grafis, dan hanya mulai diputar saat memasuki area tampilan. Konten pengiring hanya boleh memulai pemutaran setelah memasuki area pandang. Iklan ini dapat dikonversi menjadi pemutar mengambang/melekat saat di-scroll keluar dari halaman.
PLCMT_INTERSTITIAL Iklan video yang diputar tanpa konten video. Selama pemutaran, iklan harus menjadi fokus utama halaman dan mengisi sebagian besar area pandang serta tidak dapat di-scroll keluar dari tampilan. Hal ini dapat dilakukan di penempatan seperti video dalam aplikasi atau slideshow.
PLCMT_NO_CONTENT_STANDALONE Iklan video yang diputar tanpa streaming konten video. Iklan ini dapat ditempatkan di penempatan seperti slideshow, feed native, dalam konten, atau melekat/mengambang.
BidRequest.imp.video.playbackmethod
Menjelaskan cara memutar iklan video. Metode pemutaran ditentukan sebagai putar otomatis atau klik untuk putar berdasarkan pengukuran terbaik yang tersedia.
AUTO_PLAY_SOUND_ON Dimulai saat halaman dimuat dengan suara aktif.
AUTO_PLAY_SOUND_OFF Dimulai saat halaman dimuat dengan suara nonaktif.
CLICK_TO_PLAY Dimulai saat diklik dengan suara aktif.
MOUSE_OVER Dimulai saat mouse diarahkan dengan suara aktif.
ENTER_SOUND_ON Dimulai saat memasuki area pandang dengan suara aktif.
ENTER_SOUND_OFF Dimulai saat memasuki area pandang dengan suara nonaktif secara default.
BidRequest.imp.video.skip
Jika true, ini menunjukkan bahwa pemutar akan mengizinkan video dilewati, atau iklan yang dapat dilewati diizinkan. Jika tidak, hal ini menunjukkan bahwa iklan yang dapat dilewati tidak diizinkan.
BidRequest.imp.video.startdelay

Nilai 0 berarti pre-roll, -1 berarti mid-roll, dan -2 berarti post-roll.

Nilai positif lainnya adalah waktu dalam detik dari awal video hingga titik iklan ditampilkan.

Sinyal ini tidak unik untuk materi iklan video, tetapi sangat berharga untuk dibaca oleh bidder:

BidRequest.device.ifa
Kolom ini adalah UUID 36 karakter yang hanya ditetapkan saat menggunakan SSL, dan tidak di-hash. Ini adalah versi BidRequest.device.dpidm5 yang tidak dienkripsi. Untuk perangkat iOS, kolom ini berisi ID untuk Pengiklan (IDFA) dalam huruf besar semua. Untuk perangkat Android, file ini berisi ID Android (ADID) dalam semua karakter huruf kecil. Untuk perangkat TV yang Terhubung, ID ini berisi ID unik (misalnya, RIDA Roku).
BidRequest.device.devicetype
Menentukan jenis perangkat.
MOBILE Alias yang tidak digunakan lagi untuk HIGHEND_PHONE atau TABLET.
PERSONAL_COMPUTER Mencakup perangkat desktop dan laptop.
CONNECTED_TV mencakup TV yang terhubung (yaitu, smart TV) dan perangkat yang terhubung (seperti Roku, Apple TV, dan sebagainya).
HIGHEND_PHONE Termasuk perangkat ponsel kelas atas.
TABLET Termasuk perangkat tablet.
CONNECTED_DEVICE Termasuk perangkat game khusus.
SET_TOP_BOX Mencakup perangkat dekoder.
OOH_DEVICE Mencakup perangkat iklan luar ruangan; misalnya, papan reklame digital.
BidRequest.device.make
Menentukan merek (seperti Nokia atau Samsung) perangkat.
BidRequest.device.model
Menentukan model perangkat yang tepat (seperti N70 atau Galaxy) jika tersedia, jika tidak, berisi model generik seperti "iphone" atau "ipad".
BidRequest.imp.metric
Jika Metric.type ditetapkan ke completion_rate, Metric.value akan berupa pecahan dalam rentang [0,0, 1,0] yang mewakili rasio penyelesaian historis untuk iklan video yang ditayangkan di slot iklan. Nilai default -1.0 menunjukkan bahwa data tingkat penyelesaian historis tidak tersedia.
BidRequest.imp.video.poddur
Durasi waktu dalam detik dari seluruh jeda iklan, termasuk semua slot yang terdiri dari pod. Nilai ini ditetapkan ke nilai yang ditentukan dalam metadata video yang diberikan oleh penayang video.

Permintaan bid video juga berisi informasi tentang inventaris seperti vertikal, vendor yang diizinkan, dan informasi saluran. Semua kolom lain yang ada dalam permintaan bid juga berlaku untuk video.

Kolom lebar dan tinggi dalam pesan AdSlot permintaan video sesuai dengan ukuran pemutar iklan video.

BidRequest.imp.ext.allowed_vendor_type
Vendor yang diizinkan. Lihat file vendors.txt dalam dokumentasi teknis untuk mengetahui daftar ID. Misalnya, 309 = Unit Video DFA.
BidRequest.imp.video.mimes
Daftar yang diizinkan yang menjelaskan jenis MIME konten yang didukung untuk iklan yang ditayangkan sebagai respons terhadap permintaan bid; misalnya, "video/mp4". Respons bid harus menunjukkan dukungan untuk setidaknya salah satunya.
BidRequest.imp.video.protocols
Menjelaskan versi VAST yang didukung penayang untuk permintaan iklan video. Berisi array nilai enum Protocol, termasuk: VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER, VAST_4_0, VAST_4_0_WRAPPER, dan lainnya.
BidRequest.imp.video.companionad
Kolom ini mencakup array objek Banner yang mewakili iklan pendamping jika tersedia.
BidRequest.site.page

URL halaman tonton video atau URL halaman tempat video disematkan. Contoh:

http://www.publisher.com/watchpagelink

Saat merespons permintaan video, bidder harus menampilkan URL pengalihan VAST, atau XML VAST di kolom BidResponse.seatbid.bid.adm. Respons bid juga harus berisi pernyataan yang tepat untuk iklan video. Berikut adalah cuplikan respons bid video yang tepat: 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Kolom penting dalam respons bid video adalah sebagai berikut:

BidResponse.seatbid.bid.ext.attribute
Atribut untuk iklan yang mungkin ditampilkan dari cuplikan ini. Lihat file buyer-declarable-creative-attributes.txt untuk mengetahui daftar ID. Kami memeriksa untuk memastikan tidak ada atribut ini yang cocok dengan atribut yang tidak diizinkan oleh penayang dalam permintaan bid. Misalnya, menetapkan apakah salah satu kolom menyertakan 30, yang akan menunjukkan bahwa iklan memerlukan dukungan VPAID untuk dirender.
BidResponse.seatbid.bid.adm

Untuk iklan video, ini adalah URL pengalihan VAST dari iklan video. Contoh:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

Atau, ini mungkin XML VAST mentah.

Contoh permintaan dan respons bid

Format Video

Cara pembeli dapat menyertakan video

Tabel berikut mengilustrasikan cara pembeli dapat menyertakan video dalam materi iklan dan penempatan yang dapat ditayangkan untuk web dan aplikasi seluler.

Web

Materi iklan video In-stream (semua) Dalam feed/artikel Native dalam feed/artikel Interstisial Dalam banner

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

JS kustom

 

Native + VAST

 

Aplikasi Seluler

Materi iklan video In-stream (semua) Dalam feed/artikel Native dalam feed/artikel 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 pada 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 untuk web desktop & seluler, dan aplikasi seluler.

Web desktop dan seluler

Format video Sinyal yang direkomendasikan (khusus sinyal yang relevan dengan video) Sinyal terkait (khusus sinyal yang relevan dengan video)

In-stream (VPAID)

Objek VIDEO ada   &
video.placement = INSTREAM   &

In-stream (tanpa VPAID)

Objek VIDEO ada   &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

Non-in-stream

Objek VIDEO ada

Penempatan video.linearity: linear
bergantung pada penempatan
yang sebenarnya, nilai seperti di bawah
Video.startdelay = 0

Dalam Feed

Objek VIDEO ada   &
video.placement = IN-FEED

Dalam artikel

Objek VIDEO ada   &
video.placement = IN-ARTICLE

Native

Objek NATIVE ada &

Dalam banner

Objek video tidak ada &
banner.battr ≠ 6 Video Dalam Banner (Putar Otomatis) &
banner.battr ≠ 7 Video Dalam Banner (Dimulai Pengguna)

Aplikasi seluler

Format video Detail permintaan bid (hanya detail yang relevan dengan video)

In-stream

Objek VIDEO ada   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 atau 2: VPAID 2.0

Non-in-stream

Objek VIDEO ada

Penempatan video.linearity: linear
bergantung pada penempatan
yang sebenarnya, nilai seperti di bawah
Video.startdelay = 0

Dalam Feed

Objek VIDEO ada   &
video.placement = IN-FEED

Dalam artikel

Objek VIDEO ada   &
video.placement = IN-ARTICLE

Native

Objek NATIVE ada &

Interstisial (VAST)

Objek VIDEO ada   &
video.placement = INTERSTITIAL

Interstisial (tanpa VAST)

Objek VIDEO ada   &
video.placement = INTERSTITIAL

Difilter

Dalam banner (MRAID)

Objek video tidak ada &
banner.battr ≠ 6 Video Dalam Banner (Putar Otomatis) &
banner.battr ≠ 7 Video Dalam Banner (Dimulai Pengguna)

Dalam banner

(tanpa MRAID)

Objek video tidak ada &
banner.battr ≠ 6 Video Dalam Banner (Putar Otomatis) &
banner.battr ≠ 7 Video Dalam Banner (Dimulai Pengguna)

Cara penayang dapat mengizinkan/melarang video

Tabel berikut mengilustrasikan cara penayang mengizinkan/melarang video di penempatan mereka.

Opsi pub Format yang berlaku Dijelaskan dalam permintaan bid sebagai

Menentukan unit video In-stream

In-stream (semua)

Objek video ada &
video.placement = INSTREAM

Ikut serta dalam VPAID

Web in-stream

Objek video ada &
video.api = 1 (VPAID 1.0) atau 2 (VPAID 2.0)

Mengaktifkan IBV

Dalam banner

Interstisial

banner.battr ≠ 6 Video dalam Banner (Putar Otomatis) &/atau 7 Video dalam Banner (Dimulai Pengguna)

Ikut serta dalam (petunjuk)

Dalam Feed

Dalam artikel

Objek video ada &
video.placement = IN-FEED atau IN-ARTICLE

Memilih ikut serta dalam Non-in-stream (petunjuk)

Native

Objek native ada

Memblokir Pengantara video

Aplikasi interstisial

Objek VIDEO tidak ada

Kasus ekstrem

# Deskripsi Kasus Komentar Permintaan bid

1

Penutupan kustom yang tertunda menggunakan MRAID

Untuk interstisial, menutup iklan dapat mengirim notifikasi ke Pembeli menggunakan MRAID, meskipun mereka tidak menggunakan penutupan kustom.


X yang diterapkan Authorized Buyers akan selalu muncul di atas penutup kustom, meskipun penutup kustom muncul di bawahnya setelah 5 detik

Glosarium

Lihat glosarium video Authorized Buyers.

Kolom yang relevan untuk format In-Stream dan Non-In-Stream

Lihat OpenRTB 2.5 (mulai dari halaman 47)

BidRequest.Video.
Placement
In-stream mWeb

1: In-Stream
2: In-Banner

mApp

1: In-Stream
2: In-Banner
Non-in-stream mApp Interstitial

5: Interstisial

Native

3: Dalam Artikel
4: Dalam Feed

Rewarded

is_rewarded_inventory: Boolean Ekstensi OpenRTB
linearity

Menunjukkan apakah tayangan harus linear, non-linear, dll. Jika tidak ada yang ditentukan, asumsikan bahwa semua diizinkan.

In-stream mWeb

1: LINEAR (In-stream)

mApp

1: LINEAR (In-stream)
Non-in-stream mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
In-stream mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
Non-in-stream Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Sumber nilai permintaan bid

Objek
OpenRTB		 Kolom Authorized Buyers
/Exchange
Bidding
Non-in-stream		 Nilai Contoh Siapa yang menentukannya?
/Dari mana nilai ini berasal dari
?
Objek
Video mime ya ["application/javascript",
"video/mp4"]",		 Google
minduration tidak Penayang Dikonfigurasi
maxduration ya Penayang Dikonfigurasi
playbackmet
hod		 ya [6] Biasanya
Penayang Dikonfigurasi
API (MRAID) ya [1,2] Google
protokol ya [2,3,5,6,7,8] Google
linearitas ya [1] Google
penempatan ya [1] Google
lebar pemutar ya 400.400.300 Google
tinggi pemutar ya 225.300.153 Google
penundaan mulai ya 0 Google, default 5 detik
lewati ya 1 Penayang/Google
- untuk Interstisial => Google
- untuk In-stream => Penayang
memutuskan apakah akan mengizinkan
yang dapat dilewati, tidak dapat dilewati, atau keduanya.
Iklan reward, selalu tidak dapat dilewati;
kecepatan bit minimum Tidak Google
kecepatan bit maksimum tidak Google
pos ya 1 Google
Perangkat
Rasio px ya 1 Google
tayangan
Aman ya 1
Google secara default adalah
true karena tag iklan selalu
aman