Parameter wajib dan yang direkomendasikan untuk Pembelian Terprogram

Menerapkan solusi video berbasis tag untuk permintaan Ad Exchange tanpa penggunaan IMA SDK merupakan penawaran beta dan mungkin tidak tersedia untuk jaringan Anda. Anda dapat menghubungi Account Manager Anda untuk mengetahui informasi selengkapnya.

Berikut adalah subbagian parameter URL tag iklan VAST. Parameter ini ditujukan untuk solusi video berbasis tag untuk Pembelian Terprogram saat tidak berintegrasi dengan IMA SDK.

Lihat daftar parameter wajib dan yang direkomendasikan untuk web atau parameter wajib untuk aplikasi.

 Langsung ke parameter tertentu dalam daftar

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Parameter	Detail
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
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
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
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
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
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
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
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
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
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