Parameter yang diperlukan untuk aplikasi

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 tersebut diperlukan bagi solusi video berbasis tag untuk aplikasi saat tidak berintegrasi dengan IMA SDK.

Lihat daftar parameter yang diperlukan untuk web atau parameter yang direkomendasikan untuk Monetisasi terprogram.

 Langsung ke parameter tertentu dalam daftar

an correlator description_url env gdfp_req idtype

is_lat iu msid output pvid pvid_s

rdid sz unviewed_position_start url wta

 

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