Iklan Video

Panduan ini menguraikan persyaratan integrasi, konfigurasi, dan kolom yang relevan yang dapat Anda gunakan saat mengajukan bid pada inventaris video.

Google mendukung iklan video in-stream, native, dan interstisial yang ditampilkan sebagai peluang iklan individual atau pod iklan video dinamis. Pod dinamis menjelaskan pengelompokan iklan video yang ditampilkan secara berurutan, dengan durasi maksimum pod dibagi menjadi satu atau beberapa video yang bervariasi panjangnya. Lihat panduan untuk format iklan Native dan Interstisial untuk mengetahui detail selengkapnya tentang format tersebut.

Persyaratan pembeli

Protokol RTB

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

Anda dapat menemukan proto OpenRTB dan ekstensi OpenRTB khusus Google di halaman Protos and reference data. Untuk informasi selengkapnya tentang mengembangkan bidder, lihat Memproses Permintaan dan Membangun Respons.

Peninjauan materi iklan

Google merekomendasikan agar Anda mengirimkan materi iklan untuk disetujui sebelum mengajukan bid 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 dalam BidResponse.seatbid.bid.adm. Selain itu, jika Anda menentukan URL video, Anda juga dapat menempatkan makro dalam dokumen XML VAST yang ditautkan. 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 pembungkus VAST. Untuk mengetahui 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 tambahan khusus video 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, dengan parameter yang dihapus, dari halaman yang mendeskripsikan konten video. Penayang mengirimkan URL ini ke Google. Contoh:

http://www.publisher.com/watchpagelink
banner.vcm
Jika disetel 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 dirender sebagai penutup akhir.
BidRequest.imp.rwdd
Jika disetel ke true, ini menunjukkan bahwa pengguna menerima reward karena menonton iklan video. Reward umum dapat berupa membaca artikel tambahan secara gratis, menerima nyawa tambahan dalam game, atau mendapatkan sesi musik bebas iklan yang disponsori.
BidRequest.imp.video.maxduration

Durasi maksimum yang diizinkan dalam detik untuk setiap iklan individual yang disertakan dalam respons bid. Jika tidak disetel, tidak ada durasi maksimum. Jika BidRequest.imp.video.skip adalah true, perilakunya bisa berbeda. Lihat Durasi video yang dapat dilewati maksimum untuk mengetahui detail selengkapnya.

BidRequest.imp.video.maxseq

Jumlah maksimum iklan yang mungkin ditayangkan ke dalam pod iklan video dinamis. Jika poddur disetel, tetapi maxseq tidak disetel atau 0, Anda tidak memiliki batasan jumlah iklan yang dapat ditayangkan ke dalam pod video. Google hanya mendukung pod dinamis.

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

BidRequest.imp.video.minduration
Durasi minimum dalam detik untuk setiap iklan yang disertakan dalam respons bid. Jika tidak disetel, 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 diminta konsumen. Video in-stream harus disetel ke "suara aktif" secara default saat pemutar dimulai, atau memiliki niat pengguna yang jelas 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 yang dapat dilihat dan memutar audio. Jika pemutar berubah menjadi mengambang/tetap, panggilan iklan berikutnya harus secara akurat menyampaikan ukuran pemutar yang diperbarui.
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 mulai diputar hanya saat memasuki area tampilan. Konten pengiring hanya boleh memulai pemutaran saat memasuki area pandang. Pemutar dapat dikonversi menjadi pemutar mengambang/tetap 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 tampilan dan tidak dapat di-scroll keluar dari tampilan. Hal ini dapat dilakukan di penempatan seperti video dalam aplikasi atau slide.
PLCMT_NO_CONTENT_STANDALONE Iklan video yang diputar tanpa konten video streaming. Iklan ini dapat berada di penempatan seperti slide, feed native, dalam konten, atau sticky/mengambang.
BidRequest.imp.video.playbackmethod
Menjelaskan cara memutar iklan video. Metode pemutaran ditentukan sebagai putar otomatis atau klik untuk memutar 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 kursor diarahkan ke atas dengan suara aktif.
ENTER_SOUND_ON Dimulai saat memasuki area tampilan dengan suara diaktifkan.
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 untuk dilewati, atau bahwa iklan yang dapat dilewati diizinkan. Jika tidak, nilai 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 tempat iklan ditampilkan.

BidRequest.imp.video.durfloors dan BidRequest.imp.audio.durfloors

Array objek DurFloors yang menunjukkan harga minimum masing-masing untuk materi iklan video atau audio dengan berbagai durasi yang dapat digunakan pembeli untuk mengajukan bid.

Berikut adalah contoh tampilan durfloors yang ditentukan Google:

  1. {"maxdur": 16, "bidfloor": 5} yang merepresentasikan (0, 16) detik pada $5.
  2. {"mindur": 16, "maxdur": 31, "bidfloor": 10} yang mewakili [16, 31) detik pada $10.
  3. {"mindur": 31, "bidfloor": 20} yang merepresentasikan [31, inf) detik pada $20.

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

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, berisi ID Android (ADID) dalam semua karakter huruf kecil. Untuk perangkat TV yang Terhubung, kolom ini berisi ID uniknya (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 Mencakup perangkat ponsel kelas atas.
TABLET Mencakup perangkat tablet.
CONNECTED_DEVICE Mencakup 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 persisnya (seperti N70 atau Galaxy) perangkat 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 merepresentasikan rasio penyelesaian historis untuk iklan video yang ditayangkan di slot iklan. Nilai default -1.0 menunjukkan bahwa data rasio penyelesaian historis tidak tersedia.
BidRequest.imp.video.poddur
Durasi waktu dalam detik yang dapat Anda isi untuk pod iklan video dinamis. Kolom ini mengacu pada durasi seluruh jeda iklan. Jika tidak disetel, slot iklan bukan bagian dari pod.

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

Kolom lebar dan tinggi dalam pesan AdSlot dari 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
Mendeskripsikan 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 merepresentasikan iklan pengiring 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: "n40G42d551UX18627ao8lt"
seatbid {
  bid {
    id: "17u6BnD62h88r5q7066"
    impid: "1"
    price: 0.797848
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_987914"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 55383762512
      skadn {
        version: "4.0"
        network: "306el65O"
        itunesitem: "832461214"
        sourceapp: "977150768"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
        }
        sourceidentifier: "8396"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 20
}

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 bahwa tidak ada satu pun atribut ini yang cocok dengan atribut yang tidak diizinkan oleh penayang dalam permintaan bid. Misalnya, jika salah satu kolom menyertakan 30, hal itu 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 berupa XML VAST mentah.

Contoh permintaan dan respons bid

Format Video

Cara pembeli dapat menyertakan video

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

Web

Materi iklan video Dalam 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 Dalam 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 menggambarkan sinyal yang direkomendasikan OpenRTB untuk semua format video untuk web desktop & seluler, dan aplikasi seluler.

Web desktop dan seluler

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

Dalam stream (VPAID)

Objek VIDEO ada   &
video.placement = INSTREAM   &

Dalam stream (tanpa VPAID)

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

Bukan dalam stream

Objek VIDEO ada

video.linearity: linear
penempatan bergantung pada penempatan
aktual, 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 (Diprakarsai Pengguna)

Aplikasi seluler

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

Dalam stream

Objek VIDEO ada   &
video.placement = INSTREAM    &

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

Bukan dalam stream

Objek VIDEO ada

video.linearity: linear
penempatan bergantung pada penempatan
aktual, 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 (Diprakarsai Pengguna)

Dalam banner

(tanpa MRAID)

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

Cara penayang dapat mengizinkan/tidak mengizinkan video

Tabel berikut menggambarkan cara penayang dapat mengizinkan/tidak mengizinkan video di penempatannya.

Opsi pub Format yang berlaku Dideskripsikan dalam permintaan bid sebagai

Menentukan unit video dalam stream

Dalam stream (semua)

Objek video ada &
video.placement = INSTREAM

Memilih untuk menggunakan VPAID

Web dalam 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 (Diprakarsai Pengguna)

Pilih untuk ikut serta dalam (petunjuk)

Dalam feed

Dalam artikel

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

Memilih untuk ikut serta dalam Non-instream (petunjuk)

Native

Objek native ada

Blokir Iklan pengantara video

Aplikasi interstisial

Objek VIDEO tidak ada

Kasus ekstrem

# Deskripsi Kasus Komentar Permintaan bid

1

Penutupan kustom tertunda menggunakan MRAID

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


X yang diterapkan Authorized Buyers akan selalu muncul di atas penutupan kustom apa pun, meskipun penutupan kustom muncul di bawah setelah 5 detik

Glosarium

Lihat Glosarium video Authorized Buyers.

Kolom yang relevan untuk format In-stream dan Non-Instream

Lihat OpenRTB 2.5 (mulai dari halaman 47)

BidRequest.Video.
Placement
Dalam stream mWeb

1: In-Stream
2: In-Banner

mApp

1: In-Stream
2: In-Banner
Bukan dalam stream mApp Interstitial

5: Interstisial

Native

3: Dalam Artikel
4: Dalam Feed

Rewarded

rwdd: bool
linearity

Menunjukkan apakah tayangan iklan harus linier, non-linier, dll. Jika tidak ada yang ditentukan, anggap bahwa semuanya diizinkan.

Dalam stream mWeb

1: LINEAR (In-stream)

mApp

1: LINEAR (In-stream)
Bukan dalam stream mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
Dalam 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
Bukan dalam stream Rewarded

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

Sumber nilai permintaan bid

OpenRTB
Object		 Kolom Authorized Buyers
/Exchange
Bidding
Non-instream		 Nilai Contoh Siapa yang menentukannya?
/Dari mana nilai ini berasal?
Objek
Video mim 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 dtk
lewati ya 1 Penayang/Google
- untuk Iklan Interstisial => Google
- untuk Iklan In-stream => Penayang
memutuskan apakah akan mengizinkan
iklan yang dapat dilewati, tidak dapat dilewati, atau keduanya.
Iklan reward, selalu tidak dapat dilewati;
kecepatan bit min Tidak Google
kecepatan bit maks tidak Google
pos ya 1 Google
Perangkat
Rasio piksel ya 1 Google
tayangan
Aman ya 1 Google
secara default bernilai benar
karena tag iklan selalu
aman