Iklan Video

Panduan ini menguraikan persyaratan integrasi, konfigurasi, dan kolom protokol OpenRTB yang relevan, yang dapat Anda gunakan saat mengajukan bid pada video inventaris Anda. 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 {i>field<i} dan jalur yang setara antara jenis 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 menyarankan agar Anda mengirimkan materi iklan untuk disetujui sebelum menawar dengan mereka. 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 kode 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, halaman yang mendeskripsikan 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 ditampilkan sebagai batas akhir.
BidRequest.imp.rwdd
Jika ditetapkan ke true, hal ini menunjukkan bahwa pengguna menerima reward karena telah melihat iklan video. Reward yang biasa diberikan mungkin berupa artikel tambahan gratis, menerima nyawa tambahan dalam game, atau mendapatkan sesi musik bebas iklan bersponsor.
BidRequest.imp.video.maxduration

Durasi maksimum yang diizinkan dalam detik 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 Maksimal durasi video yang dapat dilewati untuk mengetahui detail selengkapnya.

BidRequest.imp.video.maxseq

Jumlah maksimum iklan dalam pod video. Jika tidak disetel, slot iklan tidak akan sebagai 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 iklan yang harus Anda tampilkan dalam detik. Jika tidak ditetapkan, tidak ada durasi minimum.
BidRequest.imp.video.plcmt
Menjelaskan di mana video akan diputar.
PLCMT_UNKNOWN Penempatan tidak diketahui atau tidak dapat ditentukan.
PLCMT_INSTREAM Iklan pre-roll, mid-roll, dan post-roll yang diputar sebelumnya, selama atau setelah konten video streaming yang ditonton konsumen diminta. Video in-stream harus disetel ke "suara aktif" secara default pada pemutar dimulai, atau secara eksplisit menunjukkan maksud pengguna untuk menonton konten video Anda. Meskipun mungkin ada konten lain seputar pemutar, konten video harus menjadi fokus dalam kunjungan pengguna. Ini harus tetap menjadi konten utama di halaman dan satu-satunya video pemutar video yang dapat terlihat saat diputar. Jika pemain dikonversi menjadi mengambang/melekat, panggilan iklan berikutnya harus akurat menyampaikan ukuran pemutar yang diperbarui.
PLCMT_ACCOMPANYING_CONTENT Iklan pre-roll, mid-roll, dan post-roll yang diputar sebelumnya, selama, atau setelah konten video streaming. Pemutar video dimuat dan diputar sebelum, di antara, atau setelah paragraf teks atau konten grafis, dan mulai diputar hanya saat memasuki area tampilan. Konten pengiring hanya boleh mulai diputar saat 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 diaktifkan.
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 dinonaktifkan 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 yang berarti post-roll.

Nilai positif lainnya adalah waktu dalam detik dari awal hingga ke titik tempat 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 yang tidak terenkripsi dari BidRequest.device.dpidm5. 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 sudah tidak digunakan untuk HIGHEND_PHONE atau TABLET.
PERSONAL_COMPUTER Mencakup perangkat desktop dan laptop.
CONNECTED_TV mencakup TV yang terhubung (yaitu, smart TV) dan TV 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 Termasuk 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 disetel ke completion_rate, Metric.value akan menjadi pecahan dalam rentang [0,0, 1,0] yang menampilkan rasio penyelesaian historis untuk iklan video yang ditayangkan dalam iklan slot waktu. 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.

Bidang 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 menyertakan 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 memastikan bahwa tidak satu pun dari atribut ini cocok dengan 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 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 pada 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 (khusus sinyal yang relevan dengan video)

In-stream (VPAID)

Objek VIDEO tersedia   &
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


video.linearity: linear bergantung pada performa
penempatan, nilai seperti di bawah ini
Video.startdelay = 0

Dalam Feed

Objek VIDEO tersedia   &
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 tersedia   &
video.placement = INSTREAM    &

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

Non-in-stream

Objek VIDEO ada


video.linearity: linear bergantung pada performa
penempatan, nilai seperti di bawah ini
Video.startdelay = 0

Dalam Feed

Objek VIDEO tersedia   &
video.placement = IN-FEED

Dalam artikel

Objek VIDEO ada   &
video.placement = IN-ARTICLE

Native

Objek NATIVE ada &

Interstisial (VAST)

Objek VIDEO tersedia   &
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 (Memulai Pengguna)

Dalam banner

(tidak ada MRAID)

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

Cara penayang mengizinkan/melarang video

Tabel berikut menggambarkan cara penayang dapat mengizinkan/melarang video di penempatan.

Opsi Pub Format yang berlaku Dijelaskan dalam permintaan bid sebagai

Menentukan unit video In-stream

In-stream (semua)

Objek video ada &
video.placement = INSTREAM

Memilih untuk menggunakan VPAID

In-stream web

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

Ikut serta dalam IBV

Dalam banner

Interstisial

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

Pilih ikut serta (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 tersedia

Blokir interstisial Video

Aplikasi interstisial

Objek VIDEO tidak ada

Kasus ekstrem

# Deskripsi Kasus Komentar Permintaan bid

1

Penutupan kustom 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: Dalam Banner

mApp

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

5: Interstisial

Native

3: Dalam Artikel
4: Dalam Feed

Rewarded

is_rewarded_inventory: Bool Ekstensi OpenRTB
linearity

Menunjukkan apakah tayangan harus linear, nonlinear, 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

OpenRTB
Objek		 Kolom Authorized Buyers
/Bursa
Bidding
Non-in-stream		 Nilai Contoh Siapa yang menentukannya?
/Tempat nilai ini berasal
dari?
Objek
Video mime ya [&quot;application/javascript&quot;,
"video/mp4"]",		 Google
minduration tidak Penayang Dikonfigurasi
maxduration ya Penayang Dikonfigurasi
playbackmet
hod		 ya [6] Biasanya Penerbit
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 maksimal tidak Google
pos ya 1 Google
Perangkat
Rasio px ya 1 Google
tayangan
Aman ya 1
Google default ke
benar (true) karena tag iklan selalu
aman