Iklan Video

Panduan ini menjelaskan 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 direpresentasikan sebagai peluang iklan individual atau pod iklan video dinamis. Pod dinamis menjelaskan pengelompokan iklan video yang ditampilkan secara berurutan, dengan durasi maksimum untuk pod dibagi menjadi satu atau beberapa video yang durasinya bervariasi. Lihat panduan untuk format iklan Native dan Interstisial untuk mengetahui detail selengkapnya tentang format tersebut.

Persyaratan pembeli

Protokol RTB

Panduan ini umumnya akan mengacu 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 mengetahui informasi selengkapnya tentang cara mengembangkan bidder, lihat Memproses Permintaan dan Membuat Respons.

Peninjauan materi iklan

Google merekomendasikan agar Anda mengirimkan materi iklan untuk mendapatkan persetujuan sebelum mengajukan bid dengan materi iklan tersebut. Anda dapat menggunakan resource Materi iklan Bidding real-time 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 XML VAST yang ditentukan di 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 wrapper 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, tanpa parameter, dari 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 end card (kartu info) di slot video setelah iklan video selesai diputar. Jika tidak, iklan pengiring tidak akan dirender sebagai end card.

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 yang disponsori.

BidRequest.imp.video.maxduration

Durasi maksimum yang diizinkan dalam detik untuk setiap iklan yang disertakan dalam respons bid. 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 yang mungkin ditayangkan ke dalam pod iklan video dinamis. Jika poddur ditetapkan, tetapi maxseq tidak ditetapkan atau 0, Anda tidak memiliki batasan jumlah iklan yang dapat ditayangkan ke pod video. Google hanya mendukung pod dinamis.

Jumlah sebenarnya iklan video yang ditampilkan 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 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 diminta konsumen. Video instream harus disetel ke "suara aktif" secara default saat pemutar dimulai, atau memiliki niat pengguna yang jelas dan 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 yang terlihat dan dapat memutar audio saat diputar. Jika pemutar berubah menjadi mengambang/statis, 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 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 pandang. Konten pengiring hanya boleh memulai pemutaran setelah memasuki area pandang. Pemutar ini dapat dikonversi menjadi pemutar mengambang/statis 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 serta tidak dapat di-scroll hingga tidak terlihat. Iklan ini dapat berada di penempatan seperti video dalam aplikasi atau slideshow.
PLCMT_NO_CONTENT_STANDALONE	Iklan video yang diputar tanpa konten video streaming. Iklan ini dapat berada di penempatan seperti slideshow, feed native, dalam konten, atau tetap/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 pemuatan halaman dengan suara aktif.
AUTO_PLAY_SOUND_OFF	Dimulai saat pemuatan halaman dengan suara nonaktif.
CLICK_TO_PLAY	Dimulai saat diklik dengan suara aktif.
MOUSE_OVER	Dimulai saat kursor diarahkan ke iklan 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, 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 diajukan bid oleh pembeli.

Berikut adalah contoh tampilan durfloors yang ditentukan Google:

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

Sinyal ini tidak hanya berlaku untuk materi iklan video, tetapi sangat berguna 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, parameter ini berisi ID untuk Pengiklan (IDFA) dalam huruf besar semua. Untuk perangkat Android, kolom ini berisi ID Android (ADID) dalam semua karakter huruf kecil. Untuk perangkat TV yang Terhubung, parameter ini berisi ID uniknya (misalnya, RIDA Roku).

BidRequest.device.devicetype

Menentukan jenis perangkat.

MOBILE	Alias yang sudah 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 terhubung (seperti Roku, Apple TV, dan sebagainya).
HIGHEND_PHONE	Mencakup 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 persis (seperti N70 atau Galaxy) perangkat jika tersedia, jika tidak, berisi model umum 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 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 ditetapkan, slot iklan bukan bagian dari pod.

Permintaan bid video juga berisi informasi tentang inventaris, seperti vertical, 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 panggilan 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 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 ekstrak respons bid video yang tepat:

id: "eW3q768m3k93fv93a80tGQ"
seatbid {
  bid {
    id: "0uMc95E6ClImM3p5FSe"
    impid: "1"
    price: 0.034745
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_168019"
    cat: "7"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 61170857882
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 30
}

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 atribut ini yang cocok dengan atribut yang tidak diizinkan oleh penayang dalam permintaan bid. Misalnya, jika salah satu kolom menyertakan 30, hal ini akan menunjukkan bahwa iklan memerlukan dukungan VPAID untuk dirender.

BidResponse.seatbid.bid.adm

Untuk iklan video, ini adalah URL pengalihan VAST 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

• Contoh permintaan bid video
• Respons bid video sampel

Koreksi yang dapat dilewati

Google otomatis menerapkan koreksi yang dapat dilewati ke bid Bidding Real-Time untuk inventaris video, yang dapat mencegah bid Anda difilter dari lelang karena perbedaan dalam opsi dapat dilewati yang diminta dalam permintaan bid, dan opsi dapat dilewati dari materi iklan yang Anda tampilkan dalam respons bid. Koreksi yang dapat dilewati tidak diterapkan dalam kasus berikut:

• Materi iklan yang Anda tentukan dalam respons bid diterapkan menggunakan VPAID. Anda dapat menentukan materi iklan video mana yang diterapkan menggunakan VPAID dengan kolom Creative.video.videoMetadata.isVpaid di Bidding Real-time API.
• Penayang akan merender materi iklan. Anda dapat menentukannya berdasarkan kolom BidRequest.imp.displaymanager, yang bernilai 'PUBLISHER' jika penayang akan merender materi iklan.

Berikut adalah contoh yang menjelaskan cara penerapan koreksi yang dapat dilewati:

• Skenario 1:
• Anda menerima permintaan bid dengan kolom BidRequest.imp.video.skip yang ditetapkan ke 0 untuk format JSON, atau false untuk format Protobuf.
• Anda mengajukan bid dengan materi iklan yang dapat dilewati.
• Hasil: Bid Anda akan diikutsertakan dalam lelang. Jika bid Anda menang dan materi iklan video dirender, materi iklan tersebut akan dirender sebagai tidak dapat dilewati.
• Skenario 2:
• Anda menerima permintaan bid dengan kolom BidRequest.imp.video.skip yang ditetapkan ke 1 untuk format JSON, atau true untuk format Protobuf.
• Anda mengajukan bid dengan materi iklan yang tidak dapat dilewati dengan durasi lebih lama dari durasi yang ditentukan di kolom BidRequest.imp.video.skipmin.
• Hasil: Bid Anda akan diikutsertakan dalam lelang. Jika bid Anda menang dan materi iklan video dirender, materi iklan tersebut akan dirender sebagai dapat dilewati.

Format Video

• Cara pembeli dapat menyertakan video
• Sinyal yang direkomendasikan OpenRTB untuk semua format video
• Sinyal yang direkomendasikan proto Authorized Buyers untuk semua format video
• Cara penayang dapat mengizinkan/tidak mengizinkan video
• Kasus ekstrem

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

Aplikasi Seluler

Sinyal yang direkomendasikan OpenRTB

Tabel berikut mengilustrasikan sinyal yang direkomendasikan OpenRTB untuk semua format video untuk desktop & web seluler, dan aplikasi seluler.

Web seluler dan desktop

Aplikasi seluler

Cara penayang dapat mengizinkan/tidak mengizinkan video

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

Kasus ekstrem

Glosarium

Lihat glosarium video Authorized Buyers.

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

Lihat OpenRTB 2.5 (mulai halaman 47)

Sumber nilai permintaan bid