Parameter URL tag iklan VAST

URL tag iklan VAST digunakan oleh pemutar untuk mengambil iklan audio dan video. Anda dapat menyusun URL tag iklan VAST secara manual atau mengubah URL yang ada menggunakan parameter di bawah, lalu mengujinya dengan VAST suite inspector. Anda juga dapat meninjau dan menguji menggunakan contoh tag berikut.

Persyaratan URL umum

• Protokol: Tag iklan VAST mendukung http dan https. URL pelacak tayangan mematuhi setelan SSL saat ini dan menampilkan sebagai http atau https. Klik-tayang dan pelacakan klik menggunakan http karena keduanya mengalihkan dari halaman lain.
• Domain: Penggunaan domain dinamis, yang dibuat melalui makro pencocokan pola atau metode dinamis lainnya, tidak diizinkan dan akan menyebabkan error.
• Traffic live: URL tag iklan untuk video live stream harus berisi /live di jalur URL tersebut agar dapat memastikan kemampuan dalam menangani volume traffic yang besar, saat semua jeda iklan ditayangkan secara bersamaan.

Contoh tag iklan VAST

Contoh URL tag iklan VAST, dengan parameter dan nilai yang telah ditetapkan, akan terlihat seperti ini:

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

 Langsung ke parameter tertentu dalam daftar

aconp ad_rule ad_type addtl_consent afvsz allcues an ciu_szs correlator cmsid cust_params description_url env excl_cat gdfp_req gdpr gdpr_consent hl

iabexcl idtype ipd ipe is_lat iu lip ltd max_ad_duration min_ad_duration mridx msid nofb npa omid_p output plcmt pmad

pmnd pmxd pod pp ppt ppid ppos ppsj ptpl ptpln pubf pvid pvid_s pvtf rdid rdp scor sdk_apis

sdmax sid ssss sz tfcd trt unviewed_position_start url vad_type vconp vid vid_d vpa vpi vpmute vpos wta

Parameter	Detail
aconp (Pemutaran audio berkelanjutan)	Direkomendasikan berdasarkan Panduan Pengukuran Audio MRC Parameter pemutaran audio berkelanjutan menerima nilai konstan yang menunjukkan apakah pemutar bermaksud untuk memutar konten audio secara berkelanjutan. Parameter ini harus dibiarkan tidak disetel jika tidak diketahui. Contoh penggunaan Pemutaran berkelanjutan AKTIF: aconp=2 Pemutaran berkelanjutan NONAKTIF: aconp=1
ad_rule (Aturan iklan)	Parameter aturan iklan menerima nilai konstan yang menunjukkan apakah ingin menampilkan materi iklan VAST atau respons aturan iklan. Setelan default untuk aturan iklan bergantung pada setelan jaringan Ad Manager. Anda dapat mengganti setelan untuk tag iklan tertentu menggunakan contoh di bawah. Contoh penggunaan Permintaan untuk materi iklan VAST: ad_rule=0 Permintaan untuk aturan iklan (VMAP): ad_rule=1 Persyaratan Diperlukan untuk aturan iklan video
ad_type (Jenis iklan)	Parameter jenis iklan menerima nilai konstan yang menunjukkan jenis iklan yang harus ditampilkan untuk permintaan. Parameter ini hanya diperlukan untuk iklan audio. Jika ad_type disetel ke audio atau audio_video, parameter vpmute harus disetel ke 0. Contoh penggunaan Hanya mengizinkan iklan audio: ad_type=audio Mengizinkan iklan video yang dapat dilewati dan tidak dapat dilewati: ad_type=video Mengizinkan iklan audio dan video: ad_type=audio_video (Nilai ini memungkinkan kedua format bersaing, tetapi hanya satu yang ditayangkan.) Jenis iklan audio_video dimaksudkan agar hanya digunakan untuk menayangkan materi iklan video menjadi konten audio yang mendukung pemutaran iklan video atau materi iklan audio ke pemutar video in-stream untuk konten yang dapat bersifat "{i>listenable<i}". Misalnya, streaming olahraga, siaran video, berita, dll. Baca selengkapnya tentang audio dalam konten video. Hanya mengizinkan iklan video yang dapat dilewati: ad_type=skippablevideo Hanya mengizinkan iklan video yang tidak dapat dilewati: ad_type=standardvideo Persyaratan Diperlukan untuk iklan audio
addtl_consent (Izin Tambahan)	Parameter Izin Tambahan menerima nilai variabel dan digunakan oleh penayang yang ingin mengintegrasikan dengan TCF v2.0 IAB dan menggunakan vendor yang belum terdaftar di Global Vendor List IAB Eropa, tetapi ada dalam daftar Penyedia Teknologi Iklan (ATP) Google. Permintaan VAST langsung tidak otomatis membaca nilai, tetapi nilai tersebut diterima saat ditambahkan ke tag iklan. Anda dapat membaca selengkapnya tentang nilai yang diteruskan ke parameter ini di spesifikasi teknis Mode Izin Tambahan. Contoh penggunaan addtl_consent=1~1.35.41.101
afvsz (Ukuran iklan non-linear)	Parameter ukuran iklan non-linear menerima nilai konstan yang harus berupa daftar yang dipisahkan koma dari ukuran iklan non-linear yang dapat ditampilkan di slot iklan video. Ukuran ini harus berupa salah satu ukuran yang didukung: 200x200 250x250 300x250 336x280 450x50 468x60 480x90 729x90 Saat menggunakan IMA SDK, kolom ini akan ditimpa dan diisi dengan semua ukuran yang didukung yang berada dalam nonLinearAdSlotWidth dan nonLinearAdSlotHeight. Parameter ini dapat diabaikan atau dibiarkan kosong jika tidak ada ukuran non-linear yang didukung. Contoh penggunaan Semua ukuran didukung: afvsz=200x200,250x250,300x250,336x280, 450x50,468x60,480x90,728x90 Lebar maksimum adalah 250: afvsz=200x200,250x250 Tinggi maksimum adalah 60: afvsz=450x50,468x60 Lebar maksimum adalah 100: //kosong; tidak ada nilai yang didukung   Persyaratan Diperlukan untuk iklan video non-linear saat tidak menggunakan IMA SDK
allcues (Semua titik tanda)	Parameter ini menerima nilai variabel yang merupakan daftar titik tanda yang dipisahkan koma, dalam milidetik. Untuk setiap nilai, Ad Manager menampilkan jeda iklan. Parameter vid_d dan allcues digunakan untuk menayangkan iklan mid-roll tanpa penyerapan konten. Aturan iklan juga diperlukan untuk menampilkan mid-roll. Jika tanda berbasis waktu digunakan dalam aturan iklan Anda (misalnya, "Setiap N detik" atau "Pada waktu tetap"), tanda yang ditetapkan dalam aturan iklan akan digunakan, dan tanda yang diteruskan ke allcues akan diabaikan. Mid-roll masih memerlukan durasi, jadi vid_d harus tetap diteruskan. Contoh penggunaan Titik tanda pada 10 dan 20 detik: allcues=10000,20000
ciu_szs (Ukuran pengiring)	Parameter ukuran pengiring menerima nilai variabel yang merupakan daftar yang dipisahkan koma dari ukuran pengiring. Nilai yang dipisahkan dengan karakter pipa (|) menunjukkan slot iklan multiukuran. Contoh penggunaan ciu_szs=728x90,300x250 Ukuran dengan slot multiukuran: ciu_szs=728x90,300x200|300x250
cmsid (ID sumber konten) vid (ID Video)	Parameter ID sumber konten dan ID video menerima nilai variabel.  Agar dapat menargetkan iklan ke konten video, tag video master Anda harus menyertakan kedua parameter tersebut. cmsid merupakan nomor unik untuk setiap sumber konten. Untuk menemukannya di Ad Manager, klik Video  Sumber konten, lalu nama sumber. vid adalah string atau angka yang mengidentifikasi video tertentu. ID ini ditetapkan oleh CMS yang menghosting konten Anda. Untuk menemukannya di Ad Manager, klik Video  Konten, lalu konten video tertentu. Contoh penggunaan cmsid=[value]&vid=[value] Jika membuat tag untuk Penyisipan Iklan Dinamis dengan video on demand, sebaiknya Anda menggunakan makro yang akan menyisipkan secara dinamis ID video dan sumber konten.  Misalnya: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%% Persyaratan Diperlukan untuk penargetan konten video
correlator (Korelator)	Parameter korelator menerima nilai variabel yang digunakan bersama oleh beberapa permintaan yang berasal dari kunjungan halaman yang sama. Parameter digunakan untuk menerapkan pengecualian kompetitif, termasuk dalam lingkungan tanpa cookie. Jika IMA SDK digunakan, nilai korelator ditetapkan secara otomatis. Jika pemutar Anda mencoba menetapkan nilai ini, SDK akan menimpanya dengan nilainya sendiri. Jika IMA SDK tidak digunakan, pastikan Anda menetapkan nilai ini ke nilai bilangan bulat positif yang benar-benar acak yang tidak digunakan kembali oleh beberapa kunjungan halaman. Contoh penggunaan correlator=4345645667 Persyaratan Diperlukan untuk web dan aplikasi Direkomendasikan untuk Monetisasi terprogram
cust_params (Parameter nilai kunci kustom)	Parameter parameter kustom menerima nilai variabel yang merupakan pasangan nilai kunci yang memungkinkan Anda menetapkan penargetan khusus, seperti demografi, posisi tertentu dalam halaman, atau halaman tertentu. Contoh penggunaan Lihat contoh cara menambahkan pasangan nilai kunci.
description_url (URL deskripsi)	Parameter URL deskripsi menerima nilai variabel yang harus mendeskripsikan video yang diputar di halaman. Biasanya, ini adalah halaman dengan pemutar video, tetapi juga dapat berupa halaman dengan teks yang mendeskripsikan video. Nilai description_url harus dienkode ke URL untuk pemutar video pada halaman dan perangkat CTV/OTT, serta tidak dienkode untuk pemutar video dalam aplikasi seluler. Parameter tidak ditetapkan secara otomatis oleh IMA SDK. Parameter perlu ditetapkan secara manual. Contoh penggunaan URL yang dienkode: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html URL yang tidak dienkode: description_url= https://www.sample.com/golf.html Persyaratan Diperlukan untuk web, aplikasi, dan Ad Exchange Direkomendasikan untuk Monetisasi terprogram
env (Lingkungan)	Parameter lingkungan menerima nilai konstan yang menunjukkan permintaan in-stream, atau permintaan tersebut secara khusus berasal dari pemutar video. Nilai yang mungkin adalah instream, yang dapat digunakan untuk iklan audio dan video, atau vp yang hanya dapat digunakan untuk iklan video. Contoh penggunaan Video dan/atau audio: env=instream Khusus video: env=vp Persyaratan Diperlukan untuk web dan aplikasi
excl_cat (Kategori pengecualian)	Parameter kategori pengecualian menerima nilai variabel dan digunakan untuk memblokir item baris yang berisi label pengecualian tertentu yang tidak layak untuk menerima permintaan iklan yang ditentukan. Parameter ini berfungsi dengan cust_params. Contoh penggunaan &cust_params=excl_cat%3Dairline_excl_label%7C
gdfp_req (Indikator skema Ad Manager)	Parameter indikator skema Ad Manager menerima nilai konstan yang menunjukkan bahwa pengguna berada dalam skema Ad Manager. Contoh penggunaan gdfp_req=1 Persyaratan Diperlukan untuk web dan aplikasi
gdpr (GDPR)	Parameter Izin GDPR menerima nilai variabel dan digunakan oleh penayang yang ingin mengintegrasikan dengan TCF v2.0 IAB. Permintaan VAST langsung tidak otomatis membaca nilai, tetapi nilai tersebut diterima saat ditambahkan ke tag iklan. Hanya 0 dan 1 yang merupakan nilai valid untuk parameter ini, dengan 0 berarti GDPR tidak berlaku dan 1 berarti GDPR berlaku. Jika GDPR berlaku, Anda juga harus memberikan string TC yang valid menggunakan parameter gdpr_consent. Anda dapat membaca selengkapnya tentang nilai yang diteruskan ke parameter ini di panduan umum untuk menerapkan framework, atau di bagian string TC dalam spesifikasi TCF v2.0 IAB. Contoh penggunaan GDPR berlaku: gdpr=1 GDPR tidak berlaku: gdpr=0
gdpr_consent (Izin GDPR)	Parameter Izin GDPR menerima nilai variabel dan digunakan oleh penayang yang ingin mengintegrasikan dengan TCF v2.0 IAB. Permintaan VAST langsung tidak otomatis membaca nilai, tetapi nilai tersebut diterima saat ditambahkan ke tag iklan. Anda dapat membaca selengkapnya tentang nilai yang diteruskan ke parameter ini di panduan umum untuk menerapkan framework, atau di bagian string TC dalam spesifikasi TCF v2.0 IAB. Contoh penggunaan gdpr_consent=GDPR_CONSENT_123
hl (Bahasa)	Parameter bahasa menerima nilai konstan yang digunakan untuk meminta iklan dalam bahasa tersebut, dan untuk bahasa pemilihan iklan dan rendering iklan video dalam alokasi dinamis untuk Video Ad Exchange atau AdSense. Nilai parameter dapat berupa kode ISO 639-1 (dua huruf) atau ISO 639-2 (huruf). Lihat daftar kode yang valid. Jika dihilangkan, nilai akan ditetapkan secara default ke bahasa apa pun sesuai penargetan iklan berdasarkan bahasa dalam Ad Exchange. Contoh penggunaan hl=it Persyaratan Direkomendasikan untuk Monetisasi terprogram
iabexcl (URL pengecualian IAB)	Parameter URL iabexcl menerima daftar kategori yang dipisahkan koma. Contoh penggunaan iabexcl=3.14.527 tidak termasuk "Truk Komersial", "Kendaraan Off-Road" dan "Rugby". Pelajari Taksonomi Konten IAB lebih lanjut.
ipd (Domain partner inventaris)	Parameter domain partner inventaris menerima nilai variabel yang harus ditetapkan ke deklarasi inventorypartnerdomain di file app-ads.txt (atau ads.txt) penayang.  Parameter inventorypartnerdomain adalah spesifikasi IAB yang membantu penayang dalam menentukan domain partner pembagian inventaris untuk tujuan validasi file ads.txt/app-ads.txt. Deklarasi IPD sangat penting dalam kasus penggunaan pembagian inventaris dimana inventaris iklan tempat permintaan berasal mungkin dimiliki oleh partner lain (partner pembagian inventaris). Pelajari lebih lanjut file ads.txt/app-ads.txt dan partner pembagian inventaris.
ipe (Entitas yang melakukan ping pada tayangan)	Parameter entitas yang melakukan ping pada tayangan menerima nilai konstan yang digunakan untuk menunjukkan ping tayangan dan konversi yang berasal dari server, bukan klien. Contoh penggunaan Sisi server beaconing (SSB): ipe=ssb
iu (Unit iklan)	Parameter unit iklan menerima nilai variabel yang harus disetel ke unit iklan saat ini, dalam format: /network_id/.../ad_unit Contoh penggunaan iu=/6062/videodemo Persyaratan Diperlukan untuk web dan aplikasi
lip (Posisi terakhir dalam pod)	Parameter posisi terakhir dalam pod menerima nilai konstan untuk menunjukkan permintaan dari posisi terakhir dalam pod. Parameter ini hanya digunakan untuk pod standar. Contoh penggunaan lip=true
ltd (Iklan yang dibatasi)	Parameter iklan terbatas menerima nilai konstan yang menunjukkan apakah ingin menayangkan iklan secara terbatas jika tidak ada izin atas penggunaan cookie atau ID lokal lainnya. Tidak seperti parameter URL lainnya, menyetel ltd=1 akan mengubah perilaku IMA SDK untuk memperlakukan permintaan sebagai tanpa ID dan untuk melarang penyimpanan. Contoh penggunaan ltd=1
min_ad_duration (Durasi minimum iklan) max_ad_duration (Durasi maksimum iklan)	Parameter durasi iklan menerima nilai variabel yang, jika digabungkan, menentukan rentang durasi yang harus dipenuhi iklan, dalam hitungan milidetik. Gunakan parameter ini untuk membatasi durasi masing-masing iklan untuk iklan tunggal dan permintaan pod yang dioptimalkan. Contoh penggunaan min_ad_duration=15000&max_ad_duration=30000
mridx (Nomor mid-roll)	Parameter nomor mid-roll menerima nilai variabel yang menunjukkan nomor ordinal mid-roll (misalnya mid-roll 1, mid-roll 2, dll.). Contoh penggunaan mridx=2
msid (ID Aplikasi) an (Nama aplikasi)	Parameter nama aplikasi dan ID aplikasi menerima nilai variabel yang harus diterapkan ke permintaan yang dikirim dari aplikasi seluler dan perangkat TV yang terhubung, karena sebagian besar iklan video terprogram memerlukannya. IMA SDK akan mengisi kedua parameter secara otomatis, tetapi parameter tersebut harus ditentukan secara manual di lingkungan non-SDK, termasuk panggilan VAST langsung, atau saat menggunakan Library Akses Terprogram (PAL) atau Inventaris yang Diautentikasi Penayang (PAI). Meskipun nama aplikasi harus berupa nama yang dapat dibaca manusia, SDK tetap tidak dapat mengakses ID aplikasi di iOS dan tvOS. Dalam kasus ini, parameter msid tidak dikirim, dan SDK mengirim paket aplikasi melalui parameter an. Contoh penggunaan msid=com.package.publisher&an=sample%20app ID aplikasi diberi nama dan diformat berbeda di berbagai app store. Lihat pedoman IAB untuk identifikasi aplikasi, atau contoh ID unik yang umum. Untuk platform tempat app store tidak ada, IAB merekomendasikan penayang menggunakan format berikut untuk ID toko: com.publisher.deviceplatform Persyaratan Kedua parameter diperlukan untuk aplikasi Direkomendasikan untuk Monetisasi terprogram
nofb (Penggantian dinonaktifkan)	Parameter penggantian dinonaktifkan menerima nilai konstan untuk menunjukkan bahwa permintaan iklan tidak boleh menampilkan playlist iklan penggantian video. Contoh penggunaan Penggantian dinonaktifkan: nofb=1
npa (Iklan yang tidak dipersonalisasi)	Parameter iklan yang tidak dipersonalisasi menerima nilai konstan untuk menunjukkan bahwa permintaan iklan harus diperlakukan sebagai tidak dipersonalisasi. Anda harus menetapkan npa=1 secara spesifik atau hanya menyertakan npa (tanpa nilai yang ditetapkan) untuk menandai permintaan sebagai tidak dipersonalisasi. Permintaan iklan yang tidak memiliki parameter ini, atau yang ditetapkan ke npa=0, akan ditetapkan secara default ke iklan yang dipersonalisasi. Contoh penggunaan Iklan yang tidak dipersonalisasi: npa=1
omid_p (Nama partner OMID)	Parameter nama partner OMID menerima nilai variabel yang menunjukkan nama partner yang mengintegrasikan pengukuran OMID, dan versi partner. Parameter ini hanya berlaku untuk penayang yang menginginkan pengukuran Tampilan Aktif saat menggunakan Open Measurement SDK (OM SDK). Ini tidak boleh digunakan saat menggunakan IMA SDK karena telah ditetapkan secara otomatis. Untuk menunjukkan dukungan OMID saat menggunakan Library Akses Terprogram (PAL), Anda harus menggunakan omidPartnerName dan omidPartnerVersion API untuk menetapkan nama dan versi partner. Jika tidak menggunakan PAL atau IMA, Anda harus menetapkan parameter omid_p dan sdk_apis (API yang didukung, yang juga dapat menyertakan API lain yang dipisahkan koma). Contoh penggunaan Saat menggunakan PAL: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Jika tidak menggunakan PAL: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
output (Format output iklan)	Parameter format output iklan menerima nilai konstan yang harus ditetapkan ke format output iklan. Gunakan output=vast untuk versi VAST default yang ditetapkan untuk jaringan Anda. Untuk tag iklan tertentu atau bagian situs Anda, Anda dapat meminta versi VMAP atau VAST tertentu. Untuk VAST, parameter output untuk permintaan iklan video akan selalu ditetapkan ke output=xml_vast4 jika pemutar video Anda menggunakan IMA SDK. Hal ini tidak berisiko mengganggu keandalan karena SDK memiliki kompatibilitas mundur dengan semua versi VAST yang dapat ditayangkan oleh server iklan pihak ketiga mana pun. Gunakan output=vmap untuk menampilkan versi VMAP default yang telah diaktifkan untuk jaringan Anda (misalnya VMAP 1). Jika menampilkan VAST dalam VMAP, Anda dapat menggunakan xml_vmap1_vast3 atau xml_vmap1_vast4 untuk menentukan versi VAST yang ingin ditampilkan. Contoh penggunaan Setelan VAST default jaringan Anda: output=vast VAST 4: output=xml_vast4 Setelan VAST default jaringan Anda: output=vmap VMAP 1: output=xml_vmap1 VMAP 1, menampilkan VAST 4: output=xml_vmap1_vast4 Persyaratan Diperlukan untuk web dan aplikasi
plcmt (Penempatan)	Parameter penempatan menerima nilai konstan yang digunakan untuk menunjukkan apakah inventaris in-stream dinyatakan sebagai in-stream atau pengiring atau tidak sesuai dengan panduan dalam spesifikasi IAB. Untuk permintaan non-in-stream, kolom ini diisi untuk pembeli secara otomatis berdasarkan format inventaris yang dinyatakan, dan akan mengganti pernyataan in-stream atau konten pengiring. Contoh penggunaan Permintaan in-stream: plcmt=1 Permintaan konten pengiring: plcmt=2 Persyaratan   Wajib untuk web dan Monetisasi terprogram
pmad (Iklan maksimum dalam pod)	Parameter maksimum iklan dalam pod menerima nilai variabel yang menunjukkan jumlah maksimum iklan dalam pod. Parameter ini dikhususkan untuk pod yang dioptimalkan, yang tersedia untuk penayang dengan paket video lanjutan. Parameter tidak boleh digunakan untuk VMAP (saat ad_rule=1). Contoh penggunaan pmad=4
pmnd (Durasi minimum pod) pmxd (Durasi maksimum pod)	Parameter durasi pod menerima nilai variabel yang, jika digabungkan, menentukan rentang durasi yang harus dipenuhi pod, dalam hitungan milidetik. Parameter tersebut digunakan untuk meminta beberapa iklan. Selain itu, parameter tersebut dikhususkan untuk pod yang dioptimalkan, yang tersedia untuk penayang dengan paket video lanjutan. Parameter tidak boleh digunakan untuk VMAP (saat ad_rule=1). Contoh penggunaan pmnd=0&pmxd=60000
pod (Nomor pod)	Parameter nomor pod menerima nilai variabel yang mewakili nomor ordinal pod dalam video (misalnya pod 1, pod 2, dll.). Contoh penggunaan pod=3 Persyaratan Diperlukan untuk pengecualian kompetitif, pembatasan frekuensi, dan fitur terkait agar berfungsi dengan baik.
pp (Profil materi iklan)	Parameter profil materi iklan menerima nilai variabel yang mengontrol kelayakan penayangan materi iklan berdasarkan penyiapan konfigurasi dalam profil materi iklan audio dan video. Contoh penggunaan pp=creative_profile Persyaratan Direkomendasikan untuk Monetisasi terprogram
ppt (Perlakuan Privasi Penayang)	Parameter Perlakuan Privasi Penayang menerima nilai konstan yang digunakan untuk menunjukkan apakah personalisasi iklan untuk permintaan iklan akan dinonaktifkan atau tidak. Pelajari Perlakuan Privasi Penayang lebih lanjut. Contoh penggunaan Nonaktifkan personalisasi iklan: ppt=1
ppid (ID yang diberikan penayang)	Parameter ID yang diberikan Penayang (PPID) menerima nilai variabel ID yang digunakan dalam pembatasan frekuensi, penargetan dan segmentasi audiens, rotasi iklan berurutan, serta kontrol penayangan iklan berbasis audiens lainnya di seluruh perangkat. Contoh penggunaan ppid=12JD92JD8078S8J29SDOAKC0EF230337
ppos (Posisi dalam pod)	Parameter posisi dalam pod menerima nilai variabel yang mewakili posisi dalam pod (misalnya posisi 1, posisi 2, dll.). Parameter ini hanya untuk pod standar dan penting bagi isi otomatis pengiring. Contoh penggunaan ppos=2 Persyaratan Diperlukan untuk pengecualian kompetitif, pembatasan frekuensi, dan fitur terkait agar berfungsi dengan baik.
ppsj (JSON sinyal yang diberikan penayang)	Parameter JSON sinyal yang diberikan penayang menerima objek JSON berenkode base64 yang berisi audiens dan data kontekstual yang disediakan oleh penayang untuk meningkatkan monetisasi terprogram. Pelajari lebih lanjut sinyal yang diberikan penayang dan taksonomi yang didukung. Lihat detail pasangan nilai kunci JSON yang valid di contoh IMA SDK HTML5. Contoh penggunaan Objek JSON: { "PublisherProvidedTaxonomySignals": [{ "taxonomy": "IAB_AUDIENCE_1_1", "values": ["6", "284"] }] } Nilai yang dienkode dengan base64: eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ
ptpl (ID template jeda iklan) ptpln (Nama template jeda iklan)	Nama dan ID template jeda iklan menerima nilai variabel dan menunjukkan template jeda iklan yang harus diterapkan ke permintaan pod yang dioptimalkan. Template jeda iklan memungkinkan Anda mengonfigurasi spot iklan atau spot iklan kustom yang harus disertakan dalam jeda iklan sekaligus urutan penayangannya. Hanya salah satu dari 2 parameter (nama atau ID) yang diperlukan untuk meminta template jeda iklan. Contoh penggunaan Detail selengkapnya tentang cara menyiapkan dan meminta template jeda iklan dapat ditemukan di sini.
pubf (Harga minimum publik di tag Ad Exchange) pvtf (Harga minimum pribadi di tag Ad Exchange)	pubf setara dengan google_ad_public_floor, dan pvtf setara dengan google_ad_private_floor. Hal ini digunakan untuk menambahkan harga minimum ke tag Ad Exchange. Contoh penggunaan pubf=123 pptf=123
pvid (ID kumpulan aplikasi) pvid_s (Cakupan kumpulan aplikasi)	Nilai ID kumpulan aplikasi diperlukan untuk monetisasi saat pengguna memilih tidak mengikuti personalisasi di perangkat Android. Parameter pvid menerima nilai variabel yang ditetapkan ke ID kumpulan aplikasi Android, dan parameter pvid_s menerima nilai konstan yang mewakili cakupan ID kumpulan aplikasi (scope_app atau scope_developer). Meskipun IMA/PAL SDK otomatis meneruskan kolom ini, penayang dengan penerapan non-SDK harus memanggil SDK kumpulan aplikasi dan meneruskan parameter ini secara manual berdasarkan permintaan iklan. Lihat Dokumentasi Android tentang cara mengambil ID kumpulan aplikasi. Contoh penggunaan pvid=[AppSetID_value] pvid_s=scope_app Persyaratan Diperlukan untuk aplikasi Direkomendasikan untuk Monetisasi terprogram
rdid idtype is_lat (ID perangkat yang dapat direset)	ID perangkat yang dapat direset menerima nilai variabel. Dengan aplikasi bawaan (bukan web atau web seluler), SDK meneruskan ID perangkat yang dapat direset bagi penargetan pengguna ke permintaan streaming dengan parameter rdid, idtype, dan is_lat. Pada streaming SSB, Anda harus meneruskannya sebagai parameter eksplisit, seperti yang Anda lakukan pada permintaan iklan sisi klien. Pelajari ID perangkat lebih lanjut. Hampir semua iklan video terprogram membutuhkan adanya nilai tersebut. Mulai iOS 14.5, Apple tidak lagi menggunakan sinyal LAT. Sebagai gantinya, Google mengandalkan keberadaan IDFA bukan nol untuk menunjukkan bahwa pengguna telah mengizinkan pelacakan pada versi iOS yang mendukung Transparansi Pelacakan Aplikasi. Dengan demikian, diperlukan UserAgent valid yang menunjukkan versi OS yang benar. Contoh penggunaan Lihat contoh mendetail terkait ID perangkat yang dapat direset. Persyaratan Diperlukan untuk aplikasi Direkomendasikan untuk Monetisasi terprogram
rdp (Membatasi pemrosesan data)	Parameter membatasi pemrosesan data menerima nilai konstan untuk menunjukkan bahwa permintaan iklan harus membatasi pemrosesan data. Anda harus menetapkan rdp=1 secara spesifik atau hanya menyertakan rdp (tanpa nilai yang ditetapkan) agar dapat membatasi pemrosesan data. Permintaan iklan yang tidak memiliki parameter ini, atau disetel ke rdp=0, tidak akan membatasi, kecuali jika pengaturan jaringan Pemrosesan Data yang Dibatasi diaktifkan. Contoh penggunaan rdp=1
scor (Korelator streaming)	Parameter korelator streaming menerima nilai variabel yang harus berupa integer yang dihasilkan untuk setiap streaming video. Angka tersebut harus sama dalam streaming dan unik dalam kunjungan halaman. Parameter digunakan untuk pengecualian kompetitif, pembatasan frekuensi, dan fitur terkait jika pengguna menonton beberapa video di halaman yang sama. Contoh penggunaan scor=17 Persyaratan Diperlukan untuk pengecualian kompetitif, pembatasan frekuensi, dan fitur terkait agar berfungsi dengan baik.
sdk_apis (Framework SDK API)	Parameter framework SDK API menerima daftar nilai bilangan bulat konstan yang dipisahkan koma yang menunjukkan semua framework API yang didukung oleh pemutar. Lihat daftar kemungkinan nilai Framework API. Parameter ini mendukung API di Library Akses Terprogram (PAL) untuk penayang yang tidak menggunakan IMA SDK. IMA SDK mengganti nilai apa pun yang ditetapkan dengan nilai yang didukung oleh IMA SDK. Contoh penggunaan sdk_apis=2,7,9
sdmax (Durasi iklan maksimum yang dapat dilewati)	Parameter permintaan iklan sdmax (durasi iklan maksimum yang dapat dilewati) menerima nilai variabel yang memungkinkan penayang menentukan durasi iklan maksimum yang diinginkan untuk iklan yang dapat dilewati. Dibutuhkan durasi dalam milidetik yang mewakili batas atas yang seharusnya diizinkan untuk durasi materi iklan video/audio yang dapat dilewati untuk permintaan iklan tertentu. Gunakan sdmax secara terpisah untuk iklan yang dapat dilewati, atau bersama dengan parameter max_ad_duration yang ada guna memberikan durasi maksimum yang berbeda untuk iklan yang dapat dilewati dan tidak dapat dilewati. Contoh penggunaan Menggunakan setelan berikut: max_ad_duration = 15.000 (15 detik) sdmax = 45.000 (45 detik) Untuk materi iklan berikut: Materi iklan A: tidak dapat dilewati; 30 dtk Materi Iklan B: dapat dilewati; 30 dtk Menghasilkan: Materi iklan A akan difilter karena tidak dapat dilewati dan durasinya melebihi batas maksimum (tidak dapat dilewati). Materi iklan B tidak akan difilter karena, meskipun durasinya melebihi max_ad_duration, materi iklan dapat dilewati, dan durasinya tidak melebihi jumlah maksimum yang dapat dilewati.
sid (ID sesi)	Parameter ID sesi menerima nilai variabel yang merupakan ID iklan dengan perlindungan privasi yang hanya dapat digunakan untuk tujuan pembatasan frekuensi. ID sesi didukung untuk permintaan video in-stream dari TV yang terhubung dan di inventaris video in-stream dari perangkat aplikasi seluler. Saat ini tidak didukung untuk web. Berdasarkan pedoman IFA IAB, parameter ini harus diisi dalam format UUID. Pelajari lebih lanjut ID perangkat yang dapat direset untuk penargetan pengguna. Anda dapat memilih untuk tidak meneruskan ID sesi dengan menyetel sid=0. Contoh penggunaan 123e4567-e89b-12d3-a456-426614174000 Persyaratan Direkomendasikan untuk Monetisasi terprogram
ssss (Sumber penggabungan sisi server)	Parameter sumber penggabungan sisi server menerima nilai konstan yang harus ditetapkan ke nilai yang diakui dan disediakan Google untuk vendor teknologi penggabungan video Anda. Vendor teknologi penggabungan yang menggunakan integrasi server ke server dengan Google diberi nilai ini dari Google dan dapat memberikannya kepada Anda. Anda dapat menghubungi Account Manager Google jika memiliki pertanyaan tentang nilai yang ditetapkan ke parameter ini. Contoh penggunaan ssss=mystitcher Persyaratan Diperlukan untuk penerapan sisi server
sz (Ukuran)	Parameter ukuran menerima nilai variabel yang harus ditetapkan ke ukuran slot iklan video master. Ukuran yang lebih dari satu sebaiknya dipisah dengan karakter pipa (|). Jangan mencantumkan "v" setelah ukuran. Contoh penggunaan sz=400x300 Persyaratan Diperlukan untuk web dan aplikasi Parameter ini opsional jika hanya meminta ad_type=audio.
tfcd (Tag yang ditujukan untuk anak-anak)	Parameter ditujukan untuk anak-anak menerima nilai konstan yang menandai permintaan iklan untuk perlakuan untuk anak-anak. Contoh penggunaan tfcd=1
trt (Jenis traffic)	Parameter jenis traffic menerima nilai konstan yang berfungsi untuk meminta traffic organik atau yang dibeli. IMA SDK tidak mengisi nilai default jika parameter jenis traffic tidak ada dalam permintaan. Dalam hal ini, server menyediakan nilai default 0 (traffic yang tidak ditentukan). Contoh penggunaan Permintaan untuk traffic yang dibeli: trt=1 Permintaan untuk traffic organik: trt=2
unviewed_position_start (Tayangan tertunda)	Parameter tayangan tertunda menerima nilai konstan guna menunjukkan tayangan tertunda untuk video. Contoh penggunaan unviewed_position_start=1 Persyaratan Diperlukan untuk web dan aplikasi
url (URL)	Parameter URL menerima nilai variabel yang harus ditetapkan ke URL lengkap dari tempat permintaan dikirim. Nilai ini diperlukan untuk membantu pembeli mengidentifikasi dan memahami konteks tempat permintaan ini berasal. Sejauh hal tersebut relevan, nilai ini harus diisi secara dinamis pada permintaan iklan.  Di halaman, ini adalah URL halaman yang menampilkan pemutar video. Jika Anda menggunakan IMA SDK, nilai URL akan ditetapkan secara otomatis. Jika pemutar Anda menetapkan nilai ini, IMA SDK akan mengikuti nilai yang ditetapkan. Dalam aplikasi (perangkat seluler atau CTV), nilai ini harus ditetapkan ke URL yang paling akurat mewakili inventaris video atau audio yang dimonetisasi. Misalnya, jika pengguna sedang menonton video dalam aplikasi seluler yang juga tersedia di URL yang setara dengan desktop.* Nilai parameter ini harus dienkode. Contoh penggunaan url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * Untuk aplikasi, jika tidak dapat menetapkan parameter ini ke nilai URL variabel, sebaiknya parameter disetel dengan pola berikut: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Persyaratan Diperlukan untuk web dan aplikasi Direkomendasikan untuk Monetisasi terprogram
vad_type (Jenis iklan video)	Parameter jenis iklan video menerima nilai konstan yang menunjukkan apakah iklan linear atau non-linear harus ditampilkan atau tidak. Contoh penggunaan Menampilkan iklan linear: vad_type=linear Menampilkan iklan non-linear: vad_type=nonlinear
vid_d (Durasi video)	Parameter ini menerima nilai variabel yang menentukan durasi konten, dalam detik.  Parameter vid_d dan allcues digunakan untuk menayangkan iklan mid-roll tanpa penyerapan konten. Aturan iklan juga diperlukan untuk menampilkan mid-roll. Contoh penggunaan Durasi konten video 90.000 detik (25 jam): vid_d=90000
vconp (Pemutaran video berkelanjutan)	Direkomendasikan berdasarkan Panduan Pengukuran Video MRC Parameter video berkelanjutan menerima nilai konstan yang menunjukkan apakah pemutar bermaksud untuk memutar konten video secara berkelanjutan, serupa dengan siaran TV. Parameter ini harus dibiarkan tidak disetel jika tidak diketahui. Contoh penggunaan Pemutaran berkelanjutan AKTIF: vconp=2 Pemutaran berkelanjutan NONAKTIF: vconp=1
vpa (Pemutaran video otomatis)	Direkomendasikan berdasarkan Panduan Pengukuran Video MRC Video Measurement Guidelines Parameter pemutaran video otomatis menerima nilai konstan yang menunjukkan apakah konten video dalam iklan dimulai melalui putar otomatis atau klik. Nilai yang memungkinkan adalah click jika halaman menunggu tindakan pengguna atau auto jika video diputar secara otomatis. Parameter ini harus dibiarkan tidak disetel jika tidak diketahui. Contoh penggunaan Putar otomatis: vpa=auto Klik untuk putar: vpa=click Persyaratan Direkomendasikan untuk Monetisasi terprogram
vpi (Inred playlist video)	Parameter inred playlist video menerima nilai konstan yang menunjukkan apakah akan menayangkan VMAP inline (menampilkan VAST di dalam VMAP). Parameter ini dapat digunakan untuk mengurangi latensi, serta menjamin pembatasan frekuensi dan pengecualian kompetitif di seluruh streaming video. Contoh penggunaan Menampilkan VAST: vpi=1 Menampilkan pengalihan: vpi=0
vpmute (Opsi membisukan pemutaran video)	Direkomendasikan berdasarkan Panduan Pengukuran Video MRC Video Measurement Guidelines Parameter video yang dibisukan menerima nilai konstan yang menunjukkan apakah pemutaran iklan dimulai saat pemutar video dibisukan. Contoh penggunaan Dibisukan: vpmute=1 Dibunyikan: vpmute=0 Persyaratan   Wajib untuk web dan Monetisasi terprogram
vpos (Posisi video)	Parameter posisi video menerima nilai konstan yang menunjukkan apakah permintaan iklan dikirim dari pre-roll, mid-roll, atau post-roll. Contoh penggunaan Pre-roll: vpos=preroll Mid-roll: vpos=midroll Post-roll: vpos=postroll Persyaratan Direkomendasikan untuk Monetisasi terprogram
wta (Mengapa iklan ini)	Parameter "Mengapa iklan ini?" menerima nilai konstan yang menunjukkan dukungan pemutar video untuk rendering "Mengapa Iklan ini?". Fungsionalitas "Mengapa iklan ini?" didukung secara otomatis saat menggunakan IMA SDK. Saat IMA SDK tidak digunakan, pemutar video harus menerapkan dukungan Icon dan IconClickFallbackImage VAST, seperti yang didokumentasikan dalam Standar VAST IAB. Permintaan iklan audio harus mengirimkan wta=1 jika ikon AdChoices, seperti yang diberikan dalam respons VAST, akan dirender sebagai pengiring atau diberikan kepada pengguna. Agar memenuhi syarat untuk Permintaan Google dan traffic reservasi yang dihosting Google di EEA, permintaan iklan harus mengirim wta=1 untuk menunjukkan bahwa ikon AdChoices, seperti yang diberikan dalam respons VAST, dirender pada iklan video, iklan pengiring, atau lainnya yang diberikan kepada pengguna untuk semua materi iklan. Contoh penggunaan Didukung: wta=1 Tidak didukung: wta=0 Persyaratan Diperlukan untuk Ad Exchange Diperlukan untuk traffic EEA web dan aplikasi Direkomendasikan untuk Monetisasi terprogram