Gunakan referensi ini untuk menemukan detail teknis, persyaratan, dan contoh penerapan untuk setiap parameter tag iklan VAST yang didukung. Panduan ini membantu Anda mengonfigurasi tag secara akurat untuk lingkungan web, aplikasi seluler, dan CTV.
Navigasi cepat ke parameter VAST mana punDi halaman ini:
- Parameter penayangan iklan
- Parameter pembelian terprogram
- Parameter yang direkomendasikan untuk pembelian terprogram
- Parameter lainnya
false/true, kami merekomendasikan 0/1 untuk parameter boolean (misalnya vpmute, wta, ad_rule, gdpr, dan sebagainya).Penting: URL tag iklan untuk video live stream dapat menyertakan /live di jalur URL tersebut untuk penayangan iklan dan monetisasi terprogram di seluruh lingkungan web, aplikasi seluler, TV yang terhubung (CTV), dan audio (tidak termasuk iklan digital luar ruangan/DOOH).
Sebaiknya klasifikasikan inventaris Anda seperti itu karena /live adalah komponen jalur URL, bukan parameter kueri. Oleh karena itu, ID harus dibuat langsung ke dalam struktur jalur, bukan ditambahkan sebagai parameter standar yang dibatasi oleh ampersand (&). Penyiapan ini dirancang untuk membantu sistem menangani lonjakan traffic tinggi saat semua jeda iklan ditayangkan secara bersamaan.
Perlu diperhatikan bahwa penambahan /live ditujukan khusus untuk acara live dengan konkurensi tinggi, bukan live umum di lingkungan produksi.
Karena merupakan elemen jalur, bukan parameter kueri, elemen ini tidak dikonfigurasi atau dicantumkan dalam tabel parameter di bawah.
Daftar parameter berdasarkan jenis penerapan
Jika menggunakan penerapan tertentu, Anda dapat menggunakan daftar parameter kustom yang menguraikan penggunaan dan persyaratan untuk penerapan tersebut. Gunakan daftar parameter kustom untuk:
Web Aplikasi seluler TV yang Terhubung Audio Iklan digital luar ruangan
Semua parameter
Parameter penayangan iklan
Secara umum, parameter ini diperlukan untuk penayangan iklan untuk sebagian besar penerapan. Namun, mungkin ada kejadian saat hal ini tidak diperlukan. Untuk mendapatkan listingan yang paling akurat, gunakan daftar parameter untuk jenis penerapan tertentu.
correlator (Korelator)
Deskripsi
Parameter korelator (correlator) menerima nilai variabel yang digunakan bersama oleh beberapa permintaan yang berasal dari tayangan halaman yang sama. Parameter digunakan untuk menerapkan pengecualian kompetitif, termasuk dalam lingkungan tanpa cookie.
Contoh penggunaan
correlator=4345645667
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk menerapkan penayangan iklan di web, aplikasi seluler, TV yang terhubung, audio, dan digital out-of-home.
Penggunaan SDK
- 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.
description_url (URL Deskripsi)
Deskripsi
Parameter URL deskripsi (description_url) menerima nilai variabel yang harus mendeskripsikan video yang diputar di halaman.
URL deskripsi harus berisi video yang diputar di halaman tertentu pada aplikasi web, aplikasi seluler, atau aplikasi TV. URL ini tidak boleh berupa domain level teratas untuk semua video atau semua permintaan iklan. Misalnya, jika Anda memiliki halaman https://www.sample.com/golf.html untuk menampilkan video tentang golf, tetapkan halaman tersebut sebagai nilai description_url.
Contoh penggunaan
Nilai description_url harus dienkode ke URL untuk halaman web dengan video dan perangkat CTV/OTT. Namun, nilai description_url tidak boleh dienkode untuk aplikasi seluler.
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 dan rekomendasi
Parameter ini diperlukan untuk menerapkan penayangan iklan di web dan aplikasi seluler. URL ini juga diperlukan jika Anda menggunakan Ad Exchange atau AdSense untuk alokasi dinamis.
Parameter ini direkomendasikan untuk monetisasi terprogram.
Penggunaan SDK
Parameter tidak ditetapkan secara otomatis oleh IMA SDK. Parameter harus ditetapkan secara manual.
Lihat panduan IMA SDK untuk platform Anda.
env (Lingkungan)
Deskripsi
Parameter lingkungan (env) 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 dan rekomendasi
Parameter ini diperlukan untuk menerapkan penayangan iklan di web, aplikasi seluler, TV yang terhubung, audio, dan digital out-of-home.
Parameter ini diperlukan untuk melaporkan jenis permintaan secara akurat yang dikelompokkan menurut "Tag video".
gdfp_req (Indikator skema)
Deskripsi
Parameter indikator skema Google Ad Manager (gdfp_req) menerima nilai konstan yang menunjukkan bahwa permintaan iklan ditujukan untuk inventaris Google Ad Manager.
Contoh penggunaan
gdfp_req=1
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk menerapkan penayangan iklan di web, aplikasi seluler, TV yang terhubung, audio, dan digital out-of-home.
iu (Unit iklan)
Deskripsi
Parameter unit iklan (iu) menerima nilai variabel yang harus ditetapkan ke unit iklan saat ini, dalam format: /network_code/.../ad_unit.
Contoh penggunaan
iu=/6062/videodemo
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk menerapkan penayangan iklan di web, aplikasi seluler, TV yang terhubung, audio, dan digital out-of-home.
output (Output)
Deskripsi
Parameter format output (output) menerima nilai konstan yang harus ditetapkan ke format output iklan.
Contoh penggunaan
Gunakan versi VAST default jaringan:
output=vast
Gunakan VAST 4 (Anda dapat menetapkan versi tertentu untuk tag tertentu):
output=xml_vast4
Gunakan setelan VMAP default jaringan Anda:
output=vmap
Gunakan VMAP 1:
output=xml_vmap1
Gunakan VMAP 1, yang menampilkan VAST 4 (jika Anda menampilkan VAST dalam VMAP):
output=xml_vmap1_vast4
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk menerapkan penayangan iklan di web, aplikasi seluler, TV yang terhubung, audio, dan digital luar ruangan. Format ini diperlukan untuk menghasilkan format respons penayangan iklan yang benar.
Penggunaan SDK
Untuk VAST, parameter output untuk panggilan 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.
Versi VAST untuk Authorized Buyers dan Bidding Terbuka
Jika ingin memfilter secara ketat berdasarkan versi VAST untuk Authorized Buyers dan Bidding Terbuka, Anda dapat mengaktifkan setelan "Filter versi VAST secara ketat" di setelan jaringan.
sz (Ukuran)
Deskripsi
Parameter ukuran (sz) menerima nilai variabel yang harus ditetapkan ke ukuran slot iklan video utama.
Ukuran yang lebih dari satu sebaiknya dipisah dengan karakter pipa (|).
Jangan mencantumkan "v" setelah ukuran.
Contoh penggunaan
Satu ukuran:
sz=400x300
Beberapa ukuran:
sz=300x250|400x300
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk menerapkan penayangan iklan di web, aplikasi seluler, TV yang terhubung, dan iklan digital luar ruangan.
Parameter ini opsional jika hanya meminta ad_type=audio.
unviewed_position_start (Tayangan iklan tertunda)
Deskripsi
Parameter tayangan iklan tertunda (unviewed_position_start) menerima nilai konstan untuk menunjukkan tayangan iklan tertunda untuk video.
Contoh penggunaan
unviewed_position_start=1
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk menerapkan penayangan iklan di web dan aplikasi seluler saat ada peluang tayangan iklan yang tertunda.
Parameter pembelian terprogram
ott_placement (Penempatan OTT)
Deskripsi
Parameter penempatan OTT (ott_placement) menerima nilai konstan yang menunjukkan permintaan untuk jenis penempatan spesifik.
1. Anda tidak perlu meneruskan parameter ini untuk iklan dalam stream standar.
Definisi penempatan untuk contoh di bawah:
- Jeda: Format di luar stream yang muncul melalui overlay di atas konten video saat pengguna menjeda pemutaran konten.
- Layar utama: Iklan yang muncul di layar utama perangkat CTV atau aplikasi OTT. Hal ini mencakup penerapan masthead, banner, dan kartu di layar utama.
- Picture-in-picture: Iklan video dalam stream yang diputar di pemutar video iklan terpisah di samping konten video. Biasanya memerlukan kompresi konten video dan pemuatan pemutar video kedua.
- Banner L: Iklan Display dalam stream yang melibatkan kompresi konten video dan pembuatan iklan di sekitar video. Biasanya, tetapi tidak terbatas pada, kotak konten iklan berbentuk L.
- Overlay: Semua format iklan dalam stream yang muncul di atas konten video, tetapi tidak menutupi seluruh layar. Dapat berupa iklan Display atau video.
Contoh penggunaan
Format yang didukung dan nilai yang sesuai:
Jeda:
ott_placement=1
Layar utama:
ott_placement=2
Picture-in-picture:
ott_placement=3
Banner L:
ott_placement=4
Overlay:
ott_placement=5
Kustom/lainnya:
ott_placement=99
Persyaratan dan rekomendasi
Parameter ini hanya diperlukan untuk monetisasi terprogram di web, aplikasi seluler, dan TV yang terhubung bagi penayang yang memonetisasi penempatan non-standar di lingkungan streaming OTT.
plcmt (Penempatan)
Deskripsi
Parameter penempatan (plcmt) 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 secara otomatis untuk pembeli berdasarkan format inventaris yang dinyatakan yang mengganti pernyataan in-stream atau pengiring.
Contoh penggunaan
Permintaan in-stream:
plcmt=1
Permintaan konten pengiring:
plcmt=2
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, audio, dan digital luar ruangan.
url (URL)
Deskripsi
Parameter URL (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. Selama memungkinkan, nilai ini harus diisi secara dinamis di permintaan iklan.
- Di web, parameter ini adalah URL halaman yang menampilkan pemutar video.
- Di lingkungan selain web, parameter 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 sama dengan desktop.*
Catatan: url berbeda dengan description_url karena url merujuk ke lokasi tempat permintaan iklan dibuat, sedangkan description_url adalah halaman web yang dapat di-crawl yang menjelaskan konten video.
Nilai parameter ini harus dienkode.
Contoh penggunaan
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* Untuk aplikasi, jika Anda tidak dapat menetapkan parameter ini ke nilai URL variabel, sebaiknya gunakan pola berikut: url=https%3A%2F%2F<app/bundleid>.example.com
Persyaratan dan rekomendasi
Parameter ini hanya diperlukan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, audio, dan digital luar ruangan.
Penggunaan SDK
Jika Anda menggunakan IMA SDK, nilai URL akan ditetapkan secara otomatis. Jika pemutar Anda menetapkan nilai ini, IMA SDK akan mengikuti nilai yang ditetapkan.
venuetype (Jenis tempat)
Deskripsi
Parameter jenis lokasi (venuetype) digunakan untuk menunjukkan jenis lokasi di luar ruangan. Nilai yang memenuhi syarat adalah ID enumerasi bilangan bulat yang didukung oleh taksonomi jenis lokasi OpenOOH 1.1 IAB.
Contoh penggunaan
Kamar hotel:
venuetype=80703
Tablet di kursi belakang taksi:
venuetype=103
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk monetisasi terprogram di iklan digital luar ruangan.
vpa (Pemutaran video otomatis)
Deskripsi
Parameter pemutaran video otomatis (vpa) 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 tidak mengubah status pemutar video, perilaku pemutaran harus ditangani langsung oleh pemutar video.
Contoh penggunaan
Putar otomatis:
vpa=auto
Klik untuk putar:
vpa=click
Jangan tetapkan parameter ini jika tidak diketahui.
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, dan audio.
Parameter ini juga direkomendasikan berdasarkan Pedoman Pengukuran Video Media Rating Council (MRC).
vpmute (Opsi membisukan pemutaran video)
Deskripsi
Parameter pemutaran video dibisukan (vpmute) menerima nilai konstan yang menunjukkan apakah pemutaran iklan dimulai saat pemutar video dibisukan. Parameter ini tidak mengubah status pemutar video, perilaku pemutaran harus ditangani langsung oleh pemutar video.
Contoh penggunaan
Pemutaran dimulai dengan dibisukan:
vpmute=1
Pemutaran dimulai tanpa dibisukan:
vpmute=0
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, audio, dan digital luar ruangan.
Parameter ini juga direkomendasikan berdasarkan Pedoman Pengukuran Video Media Rating Council (MRC).
Parameter yang direkomendasikan untuk pembelian terprogram
aconp (Pemutaran audio berkelanjutan)
Deskripsi
Parameter pemutaran audio (aconp) berkelanjutan menerima nilai konstan yang menunjukkan apakah pemutar bermaksud untuk memutar konten audio secara berkelanjutan. Hal ini membantu Google Ad Manager memilih iklan yang paling sesuai untuk pengalaman pengguna.
Contoh penggunaan
Pemutaran berkelanjutan aktif:
aconp=2
Pemutaran berkelanjutan nonaktif:
aconp=1
Jika Anda tidak tahu apakah audio diputar secara terus-menerus, parameter ini harus dibiarkan tidak ditetapkan atau ditetapkan ke aconp=0.
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, audio, dan media luar ruangan digital.
Parameter ini juga direkomendasikan berdasarkan Panduan Pengukuran Audio Media Rating Council (MRC).
an (Nama aplikasi)
Deskripsi
Parameter ID aplikasi (msid) dan parameter nama aplikasi (an) 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.
Nama aplikasi harus berupa nama yang dapat dibaca manusia.
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 dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di aplikasi seluler, TV yang terhubung, audio, dan iklan digital luar ruangan.
Untuk keamanan merek dan memberikan transparansi yang lebih besar kepada pembeli, sebaiknya sertakan informasi aplikasi.
Penggunaan SDK
Dengan pengecualian iOS dan tvOS, IMA SDK otomatis mengisi kedua parameter tersebut, tetapi parameter tersebut harus ditentukan secara manual di lingkungan non-SDK, termasuk panggilan VAST langsung, atau saat menggunakan Programmatic Access Library (PAL) atau Publisher Authenticated Inventory (PAI).
Di iOS dan tvOS, IMA SDK atau PAL tidak dapat mengakses ID aplikasi. Dalam kasus ini, parameter msid tidak dikirim, dan SDK mengirim paket aplikasi melalui parameter an.
Catatan: Jika IMA SDK HTML5 digunakan, info aplikasi tidak akan digunakan.
ct_ch (Saluran konten)
Deskripsi
Parameter saluran konten menerima nilai variabel yang berkaitan dengan saluran konten tempat iklan akan ditampilkan. Saluran ditentukan sebagai entitas yang menyeleksi koleksi konten, atau streaming dalam nama merek untuk penonton.
Parameter ini dapat digunakan untuk memberikan transparansi yang lebih besar kepada pembeli sebagai bagian dari sinyal pemrograman video dalam sinyal yang disediakan penayang.
Lihat definisi saluran konten IAB.
ct_ch=CNN International
ct_ch=ESPN2
ct_ne (Jaringan konten)
Deskripsi
Parameter jaringan konten menerima nilai variabel yang berkaitan dengan jaringan konten tempat iklan akan ditampilkan. Jaringan adalah organisasi penyiaran yang memiliki atau melisensikan sejumlah besar konten dan mendistribusikannya di area yang luas.
Parameter ini dapat digunakan untuk memberikan transparansi yang lebih besar kepada pembeli sebagai bagian dari sinyal pemrograman video dalam sinyal yang disediakan penayang.
Lihat definisi jaringan konten IAB.
ct_ne=WarnerMedia
ct_ne=ABCct_se (Seri konten)
Deskripsi
Parameter seri konten menerima nilai variabel yang berkaitan dengan seri konten tempat iklan akan ditampilkan.
Parameter ini dapat digunakan untuk memberikan transparansi yang lebih besar kepada pembeli sebagai bagian dari sinyal pemrograman video dalam sinyal yang disediakan penayang.
ct_se=game_of_thrones
ct_se=NBA_playoffsct_ti (Judul konten)
Deskripsi
Parameter judul konten menerima nilai variabel yang berkaitan dengan judul konten tempat iklan akan ditampilkan.
Parameter ini dapat digunakan untuk memberikan transparansi yang lebih besar kepada pembeli sebagai bagian dari sinyal pemrograman video dalam sinyal yang disediakan penayang.
ct_ti=game_of_thrones_s1e2
ct_ti=lakers_vs_celticsdevt (Jenis perangkat)
Deskripsi
Parameter jenis perangkat menerima nilai konstan yang memungkinkan penayang menargetkan dan melaporkan inventaris dekoder mereka. Selain itu, cara ini mengurangi risiko salah klasifikasi inventaris dekoder oleh Google dan pembeli. Parameter ini hanya boleh diteruskan untuk inventaris dekoder dan harus diteruskan bersama dengan dth=7 (petunjuk jenis perangkat).
Contoh penggunaan
devt=stb
Persyaratan dan rekomendasi
Parameter ini diperlukan untuk monetisasi terprogram dekoder.
dth (Petunjuk jenis perangkat)
Deskripsi
Parameter petunjuk jenis perangkat (dth) menerima nilai konstan yang membantu mengurangi kesalahan klasifikasi perangkat, khususnya di lingkungan TV yang terhubung dan dekoder.
Kesalahan klasifikasi perangkat dapat terjadi karena error yang tidak disengaja dari penayang atau OEM TV yang terhubung. Parameter ini akan digunakan bersama dengan sinyal lain agar Google dapat otomatis menandai kejadian jika inventaris TV yang terhubung mungkin diklasifikasikan ulang.
Contoh penggunaan
Permintaan dari:
- Ponsel menengah:
dth=1 - Smartphone:
dth=2 - Desktop:
dth=3 - Tablet:
dth=4 - TV yang Terhubung:
dth=5 - Konsol game:
dth=6 - Dekoder:
dth=7
Persyaratan dan rekomendasi
Meskipun parameter ini memang tidak diperlukan untuk menayangkan iklan untuk penerapan tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di web, aplikasi seluler, lingkungan TV yang terhubung dan dekoder, audio, dan iklan digital luar ruangan.
givn (Nonce video)
Deskripsi
Untuk integrasi yang menggunakan Library Akses Terprogram (PAL), parameter nonce video menerima nilai string variabel.
Nonce aman untuk URL—Anda tidak perlu mengenkodenya ke URL.
Catatan: Jika sebelumnya Anda memberikan nonce menggunakan parameter paln lama, sebaiknya bermigrasi ke parameter givn dan berhenti mengirim paln. Jangan sertakan kedua parameter.
Contoh penggunaan
Baca selengkapnya tentang nilai yang diteruskan ke parameter ini di panduan memulai untuk PAL.
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, audio, dan digital luar ruangan.
hl (Bahasa)
Deskripsi
Parameter bahasa (hl) 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.
Contoh penggunaan
Meminta iklan dalam bahasa Italia:
hl=it
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.
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, audio, dan media luar ruangan digital.
msid (ID Aplikasi)
Deskripsi
Parameter ID aplikasi (msid) dan parameter nama aplikasi (an) 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.
Nama aplikasi harus berupa nama yang dapat dibaca manusia.
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 dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di aplikasi seluler, TV yang terhubung, audio, dan iklan digital luar ruangan.
Untuk keamanan merek dan memberikan transparansi yang lebih besar kepada pembeli, sebaiknya sertakan informasi aplikasi.
Penggunaan SDK
Dengan pengecualian iOS dan tvOS, IMA SDK otomatis mengisi kedua parameter tersebut, tetapi parameter tersebut harus ditentukan secara manual di lingkungan non-SDK, termasuk panggilan VAST langsung, atau saat menggunakan Programmatic Access Library (PAL) atau Publisher Authenticated Inventory (PAI).
Di iOS dan tvOS, IMA SDK atau PAL tidak dapat mengakses ID aplikasi. Dalam kasus ini, parameter msid tidak dikirim, dan SDK mengirim paket aplikasi melalui parameter an.
Catatan: Jika IMA SDK HTML5 digunakan, info aplikasi tidak akan digunakan.
omid_p (Nama partner OMID)
Deskripsi
Parameter nama partner OMID (omid_p) menerima nilai variabel yang menunjukkan nama partner yang mengintegrasikan pengukuran OMID, dan versi partner.
Parameter SDK API yang didukung (sdk_apis) menerima nilai variabel yang dapat berupa daftar API yang didukung tunggal atau comma-separated list.
Parameter ini adalah bagian dari serangkaian parameter yang digunakan untuk visibilitas dan verifikasi iklan.
Contoh penggunaan
Jika tidak menggunakan PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Lihat daftar kemungkinan nilai Framework API.
Saat menggunakan PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, audio, dan digital luar ruangan.
Penggunaan SDK
- Parameter ini hanya berlaku untuk penayang yang menginginkan pengukuran Tampilan Aktif saat menggunakan Open Measurement SDK (OM SDK).
- Untuk menunjukkan dukungan OMID saat menggunakan Programmatic Access Library (PAL), Anda harus menggunakan
omidPartnerNamedanomidPartnerVersionuntuk menetapkan nama dan versi partner. Jika tidak menggunakan PAL atau IMA SDK, Anda harus menetapkan parameteromid_pdansdk_apis. - Ini tidak boleh digunakan saat menggunakan IMA SDK karena telah ditetapkan secara otomatis.
rdid (ID perangkat yang dapat direset)
Deskripsi
Parameter ID perangkat yang dapat direset (rdid, idtype, is_lat) menerima nilai variabel. Nilai ini disebut juga ID iklan (IFA).
Di aplikasi seluler yang menggunakan IMA SDK untuk Android atau iOS, IMA SDK akan meneruskan ID perangkat yang dapat direset untuk penargetan pengguna ke permintaan streaming dengan parameter untuk rdid, idtype, dan is_lat.
Jika IMA SDK tidak digunakan atau jika server-side beaconing (SSB) digunakan, Anda harus meneruskannya sebagai parameter eksplisit. Pelajari lebih lanjut ID perangkat.
Hampir semua iklan video terprogram membutuhkan adanya nilai tersebut.
|
Mulai iOS 14.5, Apple tidak lagi menggunakan sinyal |
Contoh penggunaan
Lihat contoh mendetail terkait ID perangkat yang dapat direset.
Persyaratan dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, tetapi sebaiknya gunakan parameter ini untuk monetisasi terprogram di aplikasi seluler, TV yang terhubung, audio, dan iklan digital luar ruangan.
Untuk penerapan web, ID perangkat yang dapat direset tidak digunakan.
Penggunaan SDK
IMA SDK akan otomatis meneruskan kolom ini kecuali jika idType ditetapkan ke dpid. Dalam hal ini, penayang harus meneruskan parameter rdid secara manual.
Penayang harus meneruskan parameter ini secara manual saat menggunakan PAL SDK.
sid (ID Sesi)
Deskripsi
Parameter ID sesi (sid) menerima nilai variabel yang merupakan ID iklan dengan perlindungan privasi yang hanya dapat digunakan untuk tujuan pembatasan frekuensi.
ID sesi didukung untuk permintaan video dalam stream dari TV yang terhubung dan di inventaris video dalam stream dari perangkat aplikasi seluler. Parameter ini belum didukung untuk web.
Anda dapat memilih untuk tidak meneruskan ID sesi dengan menetapkan sid=0.
Contoh penggunaan
sid=123e4567-e89b-12d3-a456-426614174000
Parameter ini harus diisi dalam format UUID. Pelajari lebih lanjut ID perangkat yang dapat direset untuk penargetan pengguna.
Persyaratan dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, tetapi tetapi sebaiknya gunakan parameter ini untuk monetisasi terprogram di iklan digital luar ruangan.
Parameter ini direkomendasikan untuk monetisasi terprogram di aplikasi seluler, TV yang terhubung, dan audio.
Penggunaan SDK
Parameter ini dikirim secara otomatis oleh IMA SDK.
vconp (Pemutaran video berkelanjutan)
Deskripsi
Parameter pemutaran video berkelanjutan (vconp) menerima nilai konstan yang menunjukkan apakah pemutar akan memutar konten video secara berkelanjutan, mirip dengan siaran TV.
Contoh penggunaan
Pemutaran berkelanjutan AKTIF:
vconp=2
Pemutaran berkelanjutan NONAKTIF:
vconp=1
Jangan tetapkan parameter ini jika tidak diketahui.
Persyaratan dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, tetapi tetapi sebaiknya gunakan parameter ini untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, dan audio.
Parameter ini juga direkomendasikan berdasarkan Pedoman Pengukuran Video Media Rating Council (MRC).
vid_d (Durasi video)
Deskripsi
Parameter durasi video (vid_d) menerima nilai variabel yang menentukan durasi konten dalam satuan detik.
- Parameter
vid_ddanallcuesdigunakan untuk menayangkan iklan mid-roll tanpa penyerapan konten. - Penggunaan aturan iklan diperlukan untuk menampilkan mid-roll. Jika Anda menggunakan indikator berbasis waktu dalam aturan iklan Anda (misalnya, "Setiap N detik" atau "Pada waktu yang ditetapkan"), indikator yang ditetapkan dalam aturan iklan tersebut akan digunakan, dan indikator yang diteruskan ke
allcuesakan diabaikan. Mid-roll masih memerlukan durasi, jadivid_dtetap harus diteruskan.
Contoh penggunaan
Durasi konten video 90.000 detik (25 jam):
vid_d=90000
Persyaratan dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, tetapi tetapi sebaiknya gunakan parameter ini untuk monetisasi terprogram di web, aplikasi seluler, dan TV yang terhubung.
vpos (Posisi video)
Deskripsi
Parameter posisi video (vpos) 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 dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, tetapi tetapi sebaiknya gunakan parameter ini untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, dan audio.
Jika aturan iklan digunakan, parameter ini tidak diperlukan karena akan otomatis ditambahkan oleh server iklan.
wta (Mengapa iklan ini)
Deskripsi
Parameter "Mengapa iklan ini?" (wta) menerima nilai konstan yang menunjukkan dukungan pemutar video untuk merender badge iklan.
Contoh penggunaan
Jika pemutar harus merender ikon AdChoices yang diberikan dalam respons VAST, gunakan:
wta=1(atau hapus parameterwta, atau teruskanwtatanpa menetapkan nilai)Permintaan audio harus menggunakan
wta=1jika ikon AdChoices yang diberikan dalam respons VAST akan dirender sebagai pengiring atau diberikan kepada pengguna.
Jika pemutar tidak boleh merender ikon AdChoices yang diberikan dalam respons VAST, gunakan:
wta=0
Persyaratan dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan untuk jenis penerapan tertentu, tetapi sebaiknya gunakan parameter ini untuk monetisasi terprogram untuk web, aplikasi seluler, TV yang terhubung, dan audio.
Jika parameter digunakan:
- Traffic
&wta=0tidak memenuhi syarat untuk jenis personalisasi tertentu dari Permintaan Google. - Traffic
&wta=0dari EEA tidak memenuhi syarat untuk materi iklan yang mengaktifkan badge iklan di item baris reservasi dan Dijamin Terprogram yang dikelola penayang.
Iklan harus mematuhi persyaratan peraturan yang berlaku untuk iklan yang ditayangkan di Wilayah Ekonomi Eropa (EEA). Hal ini mencakup mekanisme bagi pengguna untuk melaporkan konten ilegal. Penayang harus memberitahukan laporan konten ilegal apa pun kepada Google menggunakan formulir Laporkan Konten di Google.
Penggunaan SDK
Fungsi badge iklan secara otomatis didukung jika Anda menggunakan IMA SDK. Saat IMA SDK tidak digunakan, pemutar video harus menerapkan dukunganIcon dan IconClickFallbackImage VAST, seperti yang didokumentasikan dalam standar VAST IAB.Parameter lainnya
Meskipun tidak diperlukan untuk penayangan iklan dasar, parameter ini diperlukan untuk fitur atau jenis penerapan tertentu.
ad_rule (Aturan iklan)
Deskripsi
Parameter aturan iklan (ad_rule) menerima nilai konstan yang menunjukkan apakah ingin menampilkan materi iklan VAST atau respons aturan iklan.
Setelan default untuk aturan iklan bergantung pada setelan jaringan Google Ad Manager yang memungkinkan semua permintaan menjadi permintaan aturan iklan. Jika setelan jaringan digunakan, ad_rule tidak perlu ditetapkan di tag iklan. Jika ingin menonaktifkan berdasarkan permintaan iklan, Anda dapat meneruskan ad_rule=0 untuk mengganti setelan jaringan. Selain itu, jika aturan iklan tidak diaktifkan secara default, Anda dapat mengaktifkan/menonaktifkannya dengan meneruskan ad_rule=1 dan ad_rule=0.
Contoh penggunaan
Jika setelan aturan iklan dinonaktifkan:
- Permintaan untuk materi iklan VAST:
ad_rule=0atau jangan tetapkan
Jika setelan aturan iklan diaktifkan:
- Permintaan untuk materi iklan VAST:
ad_rule=0 - Permintaan untuk aturan iklan (VMAP):
ad_rule=1atau jangan tetapkan
Jika memilih untuk tidak menggunakan aturan iklan, Anda dapat menggunakan parameter tag iklan untuk menunjukkan jeda iklan dan durasi pod untuk tag VAST menggunakan pmnd, pmxd, dan pmad.
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan untuk jenis penerapan tertentu, parameter ini diperlukan untuk menggunakan aturan iklan video dengan benar.
addtl_consent (Izin tambahan)
Deskripsi
Parameter Izin Tambahan (addtl_consent) 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.
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
adtest (Pengujian iklan)
Deskripsi
Parameter pengujian iklan (adtest) harus digunakan untuk memastikan kueri yang digunakan untuk menguji inventaris pengisian ulang (tanpa jaminan) tidak diidentifikasi sebagai traffic tidak valid, dan tidak memiliki dampak terhadap pendapatan.
Saat menguji pengisian ulang, tetapkan parameter ini ke aktif untuk memastikan tidak ada iklan yang mencatat log tayangan iklan atau klik untuk digunakan selama pengujian. Tetapkan ke nonaktif di lingkungan non-pengujian untuk menagih secara normal. Jika tidak ditetapkan, parameter ini akan ditetapkan secara default ke nonaktif.
Catatan: Saat menguji item baris yang dijual langsung, Anda harus menggunakan item baris pengujian tanpa dampak pendapatan.
Contoh penggunaan
Aktif:
adtest=on
Nonaktif:
adtest=off
ad_type (Jenis iklan)
Deskripsi
Parameter jenis iklan (ad_type) menerima nilai konstan yang menunjukkan jenis iklan yang harus ditampilkan untuk permintaan.
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
audio_videoini memungkinkan kedua format bersaing, tetapi hanya satu yang ditayangkan. Jenis iklan ini 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}", seperti streaming olahraga, siaran video, berita, dll. Baca 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 dan rekomendasi
- Jika aplikasi Anda memiliki konten video, tetapkan parameter ini ke
video,audio_video, atau biarkan tidak ditetapkan. - Jika aplikasi Anda hanya memiliki konten audio (misalnya, aplikasi radio atau ucapan), Anda harus menetapkan parameter ini ke
audio. Jika tidak disetel, tidak ada iklan audio yang akan ditampilkan.
afvsz (Ukuran iklan non-linear)
Deskripsi
Parameter ukuran iklan non-linear (afvsz) menerima nilai konstan yang harus berupa comma separated list dari ukuran iklan non-linear yang dapat ditampilkan di slot iklan video.
Ukuran ini harus berupa salah satu ukuran yang didukung:
200x200250x250300x250336x280450x50468x60480x90729x90
Saat menggunakan IMA SDK, kolom ini 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 dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau penerapan tertentu, parameter ini diperlukan untuk menayangkan iklan video non-linear saat tidak menggunakan IMA SDK.
allcues (Semua tanda)
Deskripsi
Parameter semua tanda (allcues) menerima nilai variabel yang merupakan comma separated list titik tanda, dalam milidetik. Untuk setiap nilai, Google Ad Manager menampilkan jeda iklan.
- Parameter
vid_ddanallcuesdigunakan 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
allcuesakan diabaikan. Mid-roll masih memerlukan durasi, jadivid_dharus tetap diteruskan.
Contoh penggunaan
Titik tanda pada 10 dan 20 detik:
allcues=10000,20000
ciu_szs (Ukuran pengiring)
Deskripsi
Parameter ukuran pengiring (ciu_szs) menerima nilai variabel yang merupakan comma separated list ukuran pengiring.
Nilai yang dipisahkan dengan karakter pipa (|) menunjukkan slot iklan multiukuran.
Contoh penggunaan
ciu_szs=728x90,300x250
Ukuran dengan slot multi-ukuran:
ciu_szs=728x90,300x200|300x250
cmsid (ID sumber konten)
Deskripsi
Parameter ID sumber konten (cmsid) dan parameter ID video (vid) menerima nilai variabel.
Agar dapat menargetkan iklan ke konten video, tag video utama Anda harus menyertakan kedua parameter ini.
cmsidmerupakan nomor unik untuk setiap sumber konten. Untuk menemukannya di Google Ad Manager, buka Video, lalu klik Sumber konten, lalu nama sumber.vidadalah string atau angka yang mengidentifikasi video tertentu. ID ini ditetapkan oleh CMS yang menghosting konten Anda. Untuk menemukannya di Google Ad Manager, klik Video, lalu Konten, lalu konten video tertentu.
Contoh penggunaan
cmsid=[value]&vid=[value]
Jika membuat tag untuk video on demand dengan Penyisipan Iklan Dinamis, sebaiknya Anda menggunakan makro yang akan menyisipkan secara dinamis ID video dan sumber konten yang benar.
Misalnya: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau penerapan tertentu, parameter ini diperlukan untuk menggunakan penargetan konten video.
cust_params (Parameter kustom)
Deskripsi
Parameter parameter kustom (cust_params) 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.
excl_cat (Kategori pengecualian)
Deskripsi
Parameter kategori pengecualian (excl_cat) menerima nilai variabel dan digunakan untuk memblokir item baris yang berisi label pengecualian dalam panggilan iklan. Gunakan parameter cust_params untuk menetapkan kategori pengecualian dan label pengecualian.
Contoh penggunaan
Untuk menetapkan kategori pengecualian untuk dua label pengecualian (airline_excl_label dan train_excl_label), gunakan koma (,) untuk memisahkan label:
excl_cat=airline_excl_label%2Ctrain_excl_label
Kemudian, terapkan encoding URL dan gunakan string yang dienkode di cust_params:
&cust_params=excl_cat%3Dairline_excl_label%2Ctrain_excl_label
gdpr (GDPR)
Deskripsi
Parameter Izin GDPR (gdpr) menerima nilai konstan 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)
Deskripsi
Parameter Izin GDPR (gdpr_consent) 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
iabexcl (URL pengecualian IAB)
Deskripsi
Parameter URL pengecualian IAB (iabexcl) menerima nilai variabel, yang merupakan daftar kategori yang dipisahkan koma.
Contoh penggunaan
iabexcl=3.14.527 tidak termasuk "Truk Komersial", "Kendaraan Off-Road" dan "Rugby".
Anda dapat mendownload daftar kategori Taksonomi Konten IAB dan ID-nya.
idtype (Jenis perangkat)
Deskripsi
Parameter ID perangkat yang dapat direset (rdid, idtype, is_lat) menerima nilai variabel. Nilai ini disebut juga ID iklan (IFA).
Di aplikasi seluler yang menggunakan IMA SDK untuk Android atau iOS, IMA SDK akan meneruskan ID perangkat yang dapat direset untuk penargetan pengguna ke permintaan streaming dengan parameter untuk rdid, idtype, dan is_lat.
Jika IMA SDK tidak digunakan atau jika server-side beaconing (SSB) digunakan, Anda harus meneruskannya sebagai parameter eksplisit. Pelajari lebih lanjut ID perangkat.
Hampir semua iklan video terprogram membutuhkan adanya nilai tersebut.
|
Mulai iOS 14.5, Apple tidak lagi menggunakan sinyal |
Contoh penggunaan
Lihat contoh mendetail terkait ID perangkat yang dapat direset.
Persyaratan dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, tetapi sebaiknya gunakan parameter ini untuk monetisasi terprogram di aplikasi seluler, TV yang terhubung, audio, dan iklan digital luar ruangan.
Untuk penerapan web, ID perangkat yang dapat direset tidak digunakan.
Penggunaan SDK
IMA SDK akan otomatis meneruskan kolom ini kecuali jika idType ditetapkan ke dpid. Dalam hal ini, penayang harus meneruskan parameter rdid secara manual.
Penayang harus meneruskan parameter ini secara manual saat menggunakan PAL SDK.
ipd (Domain partner inventaris)
Deskripsi
Parameter domain partner inventaris (ipd) menerima nilai variabel yang harus ditetapkan ke pernyataan 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.
Contoh penggunaan
inventorypartnerdomain ada dalam file app-ads.txt yang mengarah ke file .txt partner yang dapat memonetisasi inventaris. Nilai dalam parameter ipd harus cocok dengan nilai dalam file app-ads.txt di salah satu item inventorypartnerdomain.Persyaratan dan rekomendasi
Parameter ini diperlukan untuk penayang yang memonetisasi inventaris yang tidak mereka miliki.
ipe (Entitas yang melakukan ping pada tayangan iklan)
Deskripsi
Parameter entitas yang melakukan ping pada tayangan (ipe) menerima nilai konstan yang digunakan untuk menunjukkan ping tayangan dan konversi yang berasal dari server, bukan klien.
Entitas ping tayangan digunakan saat server mengirim ping/beacon tayangan dari server.
Contoh penggunaan
Sisi server beaconing (SSB):
ipe=ssb
is_lat (Batasi pelacakan iklan)
Deskripsi
Parameter ID perangkat yang dapat direset (rdid, idtype, is_lat) menerima nilai variabel. Nilai ini disebut juga ID iklan (IFA).
Di aplikasi seluler yang menggunakan IMA SDK untuk Android atau iOS, IMA SDK akan meneruskan ID perangkat yang dapat direset untuk penargetan pengguna ke permintaan streaming dengan parameter untuk rdid, idtype, dan is_lat.
Jika IMA SDK tidak digunakan atau jika server-side beaconing (SSB) digunakan, Anda harus meneruskannya sebagai parameter eksplisit. Pelajari lebih lanjut ID perangkat.
Hampir semua iklan video terprogram membutuhkan adanya nilai tersebut.
|
Mulai iOS 14.5, Apple tidak lagi menggunakan sinyal |
Contoh penggunaan
Lihat contoh mendetail terkait ID perangkat yang dapat direset.
Persyaratan dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, tetapi sebaiknya gunakan parameter ini untuk monetisasi terprogram di aplikasi seluler, TV yang terhubung, audio, dan iklan digital luar ruangan.
Untuk penerapan web, ID perangkat yang dapat direset tidak digunakan.
Penggunaan SDK
IMA SDK akan otomatis meneruskan kolom ini kecuali jika idType ditetapkan ke dpid. Dalam hal ini, penayang harus meneruskan parameter rdid secara manual.
Penayang harus meneruskan parameter ini secara manual saat menggunakan PAL SDK.
lip (Posisi terakhir dalam pod)
Deskripsi
Parameter posisi terakhir dalam pod (lip) menerima nilai konstan untuk menunjukkan permintaan dari posisi terakhir dalam pod untuk penargetan atau pelaporan.
Catatan: Parameter ini tidak berlaku untuk pod yang dioptimalkan dan akan diabaikan jika digunakan.
Contoh penggunaan
lip=1
ltd (Iklan terbatas)
Deskripsi
Parameter iklan terbatas (ltd) menerima nilai konstan yang menunjukkan apakah ingin menayangkan iklan secara terbatas jika tidak ada izin atas penggunaan cookie atau ID lokal lainnya. Penayang dapat menambahkan parameter ini secara manual dan Google juga akan mencoba menayangkan iklan terbatas yang memenuhi syarat, di mana pun pengguna berada.
Parameter ini digunakan untuk menunjukkan permintaan iklan terbatas, dan berbeda dengan parameter is_lat. Tindakan ini akan menonaktifkan personalisasi dan penggunaan ID untuk tujuan tersebut.
ltd=1 akan mengubah perilaku IMA SDK untuk memperlakukan permintaan sebagai tanpa ID dan untuk melarang penyimpanan.Jika panggilan iklan berisi
ltd=1 (yaitu, panggilan iklan terbatas), domain akan beralih ke pagead2.googlesyndication.com saat SDK digunakan. Untuk integrasi Tanpa SDK, penayang harus mengubahnya secara manual ke domain pagead2.googlesyndication.com.Contoh penggunaan
ltd=1
max_ad_duration (Durasi iklan maksimum)
Deskripsi
Parameter durasi iklan minimum (min_ad_duration) dan parameter durasi iklan maksimum (max_ad_duration) menerima nilai variabel yang, jika digabungkan, menentukan rentang durasi yang harus dipenuhi iklan, dalam hitungan milidetik.
Parameter ini dapat digunakan untuk membatasi materi iklan ke durasi yang diperlukan dalam tag iklan untuk iklan tunggal atau dalam permintaan pod yang dioptimalkan.
Contoh penggunaan
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration (Durasi iklan minimum)
Deskripsi
Parameter durasi iklan minimum (min_ad_duration) dan parameter durasi iklan maksimum (max_ad_duration) menerima nilai variabel yang, jika digabungkan, menentukan rentang durasi yang harus dipenuhi iklan, dalam hitungan milidetik.
Parameter ini dapat digunakan untuk membatasi materi iklan ke durasi yang diperlukan dalam tag iklan untuk iklan tunggal atau dalam permintaan pod yang dioptimalkan.
Contoh penggunaan
min_ad_duration=15000&max_ad_duration=30000
mridx (Nomor mid-roll)
Deskripsi
Parameter nomor mid-roll (mridx) menerima nilai variabel yang menunjukkan nomor ordinal mid-roll (misalnya mid-roll 1, mid-roll 2, dll.).
Contoh penggunaan
mridx=2
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau implementasi tertentu, parameter ini diperlukan untuk menargetkan mid-roll tertentu, melaporkan mid-roll, dan memperkirakan mid-roll.
nofb (Tidak ada penggantian)
Deskripsi
Parameter tanpa penggantian (nofb) menerima nilai konstan untuk menunjukkan bahwa permintaan iklan tidak boleh menampilkan playlist iklan penggantian video.
Contoh penggunaan
Penggantian dinonaktifkan:
nofb=1
Penggantian iklan tunggal dan buffet iklan pod yang dioptimalkan dapat dinonaktifkan berdasarkan permintaan iklan dengan meneruskan nofb=1.
npa (Iklan yang tidak dipersonalisasi)
Deskripsi
Parameter iklan yang tidak dipersonalisasi (npa) 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
Persyaratan dan rekomendasi
Parameter ini hanya diperlukan jika pengguna menonaktifkan personalisasi. Penayang harus memastikan bahwa mereka menampilkan status pengguna yang akurat saat mereka mengontrol status.
paln (nonce Library Akses Terprogram – lama)
Deskripsi
Untuk integrasi yang menggunakan Library Akses Terprogram (PAL), parameter nonce video menerima nilai string variabel.
Nonce aman untuk URL—Anda tidak perlu mengenkodenya ke URL.
Catatan: Jika sebelumnya Anda memberikan nonce menggunakan parameter paln lama, sebaiknya bermigrasi ke parameter givn dan berhenti mengirim paln. Jangan sertakan kedua parameter.
Contoh penggunaan
Baca selengkapnya tentang nilai yang diteruskan ke parameter ini di panduan memulai untuk PAL.
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di web, aplikasi seluler, TV yang terhubung, audio, dan digital luar ruangan.
pmad (Iklan maksimum dalam pod)
Deskripsi
Parameter iklan maksimum dalam pod (pmad) menerima nilai variabel yang menunjukkan jumlah maksimum iklan dalam pod.
Parameter ini membatasi jumlah total iklan dalam pod yang dioptimalkan, yang merupakan fitur yang tersedia untuk penayang dengan paket video lanjutan.
Parameter ini tidak boleh digunakan untuk VMAP (saat ad_rule=1).
Contoh penggunaan
pmad=4
pmnd (Durasi minimum dalam pod)
Deskripsi
Parameter durasi minimum pod (pmnd) dan parameter durasi maksimum pod (pmxd) menerima nilai variabel yang, jika digabungkan, menentukan rentang durasi yang harus dipenuhi pod, dalam hitungan milidetik.
Parameter ini digunakan untuk meminta beberapa iklan dalam pod yang dioptimalkan, yang merupakan fitur yang tersedia untuk penayang dengan paket video lanjutan. Saat aturan iklan digunakan, Google Ad Manager akan otomatis menambahkan informasi ini.
Parameter ini tidak boleh digunakan untuk VMAP (saat ad_rule=1).
Contoh penggunaan
pmnd=0&pmxd=60000
pmxd (Durasi maksimum pod)
Deskripsi
Parameter durasi minimum pod (pmnd) dan parameter durasi maksimum pod (pmxd) menerima nilai variabel yang, jika digabungkan, menentukan rentang durasi yang harus dipenuhi pod, dalam hitungan milidetik.
Parameter ini digunakan untuk meminta beberapa iklan dalam pod yang dioptimalkan, yang merupakan fitur yang tersedia untuk penayang dengan paket video lanjutan. Saat aturan iklan digunakan, Google Ad Manager akan otomatis menambahkan informasi ini.
Parameter ini tidak boleh digunakan untuk VMAP (saat ad_rule=1).
Contoh penggunaan
pmnd=0&pmxd=60000
pmxfwt (Waktu tonton paksa maksimum dalam pod)
Deskripsi
Parameter waktu tonton paksa maksimum pod (pmxfwt) menerima nilai variabel yang menentukan durasi pod maksimum yang tidak dapat dilewati dalam milidetik.
Jika Anda mendukung pod dengan campuran iklan video yang dapat dilewati dan tidak dapat dilewati, serta ingin membatasi jumlah waktu iklan bagi pengguna, gunakan parameter ini untuk menentukan waktu iklan maksimum yang tidak dapat dilewati yang perlu dilihat pengguna.
Catatan: Parameter durasi pod maksimum (pmxd) menggantikan parameter ini dalam menentukan total durasi pod maksimum (termasuk durasi penuh untuk iklan yang dapat dilewati).
Contoh penggunaan
pmxfwt=30000
pod (Nomor pod)
Deskripsi
Parameter nomor pod (pod) menerima nilai variabel yang mewakili nomor ordinal pod dalam video (misalnya pod 1, pod 2, dll.).
Contoh penggunaan
pod=3
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau implementasi tertentu, parameter ini diperlukan untuk mengizinkan iklan yang sama ditayangkan di berbagai pod, dan untuk menggunakan pengecualian kompetitif, pembatasan frekuensi, dan fitur terkait dengan benar.
pp (Profil materi iklan)
Deskripsi
Parameter profil materi iklan (pp) 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 dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke implementasi tertentu, parameter ini diperlukan untuk membatasi file media untuk materi iklan yang dihosting Google Ad Manager dengan profil materi iklan video dan audio. Untuk iklan pengalihan atau terprogram, ini digunakan untuk memastikan bahwa persyaratan tersedia, tetapi tidak membatasi file media ke file yang dipilih di profil materi iklan.
ppt (Perlakuan Privasi Penayang)
Deskripsi
Parameter Perlakuan Privasi Penayang (ppt) menerima nilai konstan yang digunakan untuk menunjukkan apakah akan menonaktifkan personalisasi iklan untuk permintaan iklan.
Parameter ini menyediakan cara untuk menerapkan iklan yang tidak dipersonalisasi yang mungkin berbeda dari npa=1 dan rdp=1. Hal ini memengaruhi reservasi dan permintaan terprogram.
Pelajari lebih lanjut Perlakuan Privasi Penayang.
Contoh penggunaan
Menonaktifkan personalisasi iklan:
ppt=1
ppid (ID yang diberikan penayang)
Deskripsi
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.
Pelajari ID yang diberikan penayang lebih lanjut.
Contoh penggunaan
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Persyaratan dan rekomendasi
Meskipun parameter ini memang tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau implementasi tertentu, parameter ini harus menggunakan ID yang tidak bergantung pada platform yang konsisten. ID ini dapat digunakan jika ID lain tidak ada dan dapat diberikan kepada pembeli.
ppos (Posisi dalam pod)
Deskripsi
Parameter posisi dalam pod (ppos) menerima nilai variabel value which yang mewakili posisi dalam pod (misalnya posisi 1, posisi 2, dll.).
Parameter ini hanya untuk pod standar dan penting bagi isi otomatis pengiring. Saat aturan iklan digunakan, Google Ad Manager akan otomatis menambahkan informasi ini.
Contoh penggunaan
ppos=2
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau implementasi tertentu, parameter ini diperlukan untuk pod standar jika penargetan posisi diperlukan, serta untuk perkiraan dan pelaporan pada pod standar. Parameter ini juga diperlukan untuk menggunakan pengecualian kompetitif, pembatasan frekuensi, dan fitur terkait dengan benar.
ppsj (JSON sinyal yang diberikan penayang)
Deskripsi
Parameter JSON sinyal yang diberikan penayang (ppsj) menerima nilai variabel yang merupakan objek JSON dengan enkode base64 yang berisi data audiens dan kontekstual yang diberikan oleh penayang untuk meningkatkan monetisasi terprogram.
Parameter ini dapat digunakan untuk mengirim sinyal tertentu kepada pembeli/bidder.
Pelajari lebih lanjut sinyal yang diberikan penayang dan taksonomi yang didukung.
Contoh penggunaan
Objek JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Terapkan nilai dengan enkode Base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Lihat detail pasangan nilai kunci JSON yang valid di
contoh IMA SDK HTML5.
ptpl (ID template jeda iklan)
Deskripsi
Parameter ID template jeda iklan (ptpl) dan parameter nama (ptpln) menerima nilai variabel yang digunakan untuk menunjukkan template jeda iklan yang harus diterapkan ke permintaan pod yang dioptimalkan.
Template jeda iklan memungkinkan Anda mengonfigurasi spot iklan atau spot iklan kustom mana yang harus disertakan dalam jeda iklan, serta urutan penayangannya.
Hanya salah satu dari parameter ini yang diperlukan untuk meminta template jeda iklan.
Contoh penggunaan
Pelajari lebih lanjut cara menyiapkan dan meminta template jeda iklan.
Persyaratan dan rekomendasi
Parameter ini hanya diperlukan jika Anda langsung meminta template jeda iklan.
ptpln (Nama template jeda iklan)
Deskripsi
Parameter ID template jeda iklan (ptpl) dan parameter nama (ptpln) menerima nilai variabel yang digunakan untuk menunjukkan template jeda iklan yang harus diterapkan ke permintaan pod yang dioptimalkan.
Template jeda iklan memungkinkan Anda mengonfigurasi spot iklan atau spot iklan kustom mana yang harus disertakan dalam jeda iklan, serta urutan penayangannya.
Hanya salah satu dari parameter ini yang diperlukan untuk meminta template jeda iklan.
Contoh penggunaan
Pelajari lebih lanjut cara menyiapkan dan meminta template jeda iklan.
Persyaratan dan rekomendasi
Parameter ini hanya diperlukan jika Anda langsung meminta template jeda iklan.
pubf (Harga minimum publik di tag Ad Exchange)
Deskripsi
Harga minimum publik untuk parameter Ad Exchange (pubf) dan harga minimum pribadi untuk parameter Ad Exchange (pvtf) menerima nilai variabel yang digunakan untuk menambahkan harga minimum ke tag Ad Exchange.
Parameter ini setara dengan google_ad_public_floor dan google_ad_private_floor.
Contoh penggunaan
Harga minimum publik:
pubf=123
Harga minimum pribadi:
pvtf=123
Persyaratan dan rekomendasi
Parameter ini hanya tersedia untuk penayang di Wilayah Ekonomi Eropa ("EEA"), Swiss, atau Afrika Selatan yang telah disetujui untuk menggunakan fitur "Harga minimum".
Pelajari cara mengirim permintaan.
pvid (ID kumpulan aplikasi)
Deskripsi
Parameter ID kumpulan aplikasi (pvid) menerima nilai variabel yang ditetapkan ke ID kumpulan aplikasi Android, dan parameter cakupan kumpulan aplikasi (pvid_s) menerima nilai konstan yang mewakili cakupan ID kumpulan aplikasi (scope_app atau scope_developer).
Lihat Dokumentasi Android tentang cara mengambil ID kumpulan aplikasi.
Contoh penggunaan
pvid=[AppSetID_value]
pvid_s=scope_app
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke penerapan tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di aplikasi seluler di perangkat Android, termasuk CTV berbasis aplikasi (Android TV).
Penggunaan SDK
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 panggilan iklan.
pvid_s (Cakupan set aplikasi)
Deskripsi
Parameter ID kumpulan aplikasi (pvid) menerima nilai variabel yang ditetapkan ke ID kumpulan aplikasi Android, dan parameter cakupan kumpulan aplikasi (pvid_s) menerima nilai konstan yang mewakili cakupan ID kumpulan aplikasi (scope_app atau scope_developer).
Lihat Dokumentasi Android tentang cara mengambil ID kumpulan aplikasi.
Contoh penggunaan
pvid=[AppSetID_value]
pvid_s=scope_app
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke penerapan tertentu, parameter ini direkomendasikan untuk monetisasi terprogram di aplikasi seluler di perangkat Android, termasuk CTV berbasis aplikasi (Android TV).
Penggunaan SDK
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 panggilan iklan.
pvtf (Harga minimum pribadi di tag Ad Exchange)
Deskripsi
Harga minimum publik untuk parameter Ad Exchange (pubf) dan harga minimum pribadi untuk parameter Ad Exchange (pvtf) menerima nilai variabel yang digunakan untuk menambahkan harga minimum ke tag Ad Exchange.
Parameter ini setara dengan google_ad_public_floor dan google_ad_private_floor.
Contoh penggunaan
Harga minimum publik:
pubf=123
Harga minimum pribadi:
pvtf=123
Persyaratan dan rekomendasi
Parameter ini hanya tersedia untuk penayang di Wilayah Ekonomi Eropa ("EEA"), Swiss, atau Afrika Selatan yang telah disetujui untuk menggunakan fitur "Harga minimum".
Pelajari cara mengirim permintaan.
rdp (Pemrosesan data yang dibatasi)
Deskripsi
Parameter batasi pemrosesan data (rdp) menerima nilai konstan untuk menunjukkan bahwa permintaan iklan harus membatasi pemrosesan data.
Anda dapat membatasi pemrosesan data di tingkat jaringan dengan mengaktifkan setelan jaringan Batasi Pemrosesan Data.
Contoh penggunaan
Batasi pemrosesan data:
rdp=1 atau rdp (tanpa nilai yang ditetapkan)
Jangan batasi pemrosesan data:
rdp=0
scor (Korelator streaming)
Deskripsi
Parameter korelator streaming scor menerima nilai variabel yang harus berupa bilangan bulat yang dihasilkan untuk setiap streaming video.
Parameter scor dan correlator tidak harus memiliki nilai bilangan bulat yang sama. Namun, keduanya harus mempertahankan nilai masing-masing selama setiap pemutaran streaming video untuk mengidentifikasi sesi menonton yang unik.
Contoh penggunaan
scor=17
Persyaratan dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau penerapan tertentu, tetapi sebaiknya gunakan parameter ini untuk penayangan iklan di web, aplikasi seluler, TV yang terhubung, audio, dan digital luar ruangan.
Parameter ini digunakan untuk pengecualian kompetitif, pembatasan frekuensi, dan fitur terkait saat pengguna menonton beberapa video di halaman yang sama.
sdk_apis (framework SDK API)
Deskripsi
Parameter framework SDK API (sdk-apis) menerima daftar nilai bilangan bulat konstan yang dipisahkan koma, yang menunjukkan semua framework API yang didukung oleh pemutar.
Persyaratan dan rekomendasi
Penggunaan SDK
Parameter ini digunakan oleh penayang yang menggunakan Programmatic Access Library (PAL). Jika Anda mencoba menetapkan nilai ke parameter ini saat menggunakan IMA SDK, nilai tersebut akan diganti dengan nilai yang didukung oleh IMA SDK.
sdmax (Durasi iklan maksimum yang dapat dilewati)
Deskripsi
Parameter durasi iklan maksimum yang dapat dilewati (sdmax) 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
Hasilnya:
- 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 ini dapat dilewati, dan durasinya tidak melebihi batas maksimum yang dapat dilewati.
ssj (JSON sinyal aman)
Deskripsi
Parameter SSJ menampilkan nilai JSON sinyal aman yang dienkode.
Nilainya adalah nilai encoding After websafe64:
eyJzaWduYWxzIjpbeyJzb3VyY2UiOiJTT1VSQ0UxIiwiZGF0YSI6IkRBVEExIiwiaXNQdWJDcmVhdGVkIjpmYWxzZX0seyJzb3VyY2UiOiIxMjMiLCJkYXRhIjoiREFUQTIiLCJpc1B1YkNyZWF0ZWQiOnRydWV9XX0%3D
Contoh penggunaan
JSON, termasuk dua sinyal, satu sinyal yang diberikan oleh penyedia sinyal pihak ketiga bernama SOURCE1, dan sinyal kedua yang merupakan sinyal aman kustom penayang bernama 123 sesuai dengan kode jaringan penayang. DATA1 diperoleh dari fungsi yang disediakan oleh penyedia sinyal SOURCE1, DATA2 diperoleh dari fungsi yang dibuat oleh penayang:
{
"signals": [
{
"source": "SOURCE1",
"data": "DATA1",
"isPubCreated": false
},
{
"source": "123",
"data": "DATA2",
"isPubCreated": true
} ]
}
Persyaratan dan rekomendasi
Parameter ini tidak diperlukan untuk menayangkan iklan untuk jenis penerapan tertentu. Parameter ssj direkomendasikan jika Anda telah mengaktifkan Sinyal Aman di Jaringan Ad Manager Anda.
ssss (Sumber penggabungan sisi server)
Deskripsi
Parameter sumber penggabungan sisi server (ssss) menerima nilai konstan yang harus ditetapkan ke nilai yang diakui dan disediakan Google untuk vendor teknologi penggabungan video Anda.
Vendor teknologi penggabungan video 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 dan rekomendasi
Parameter ini memang tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau penerapan tertentu, tetapi tetapi sebaiknya gunakan parameter ini jika akan menggunakan penerapan sisi server.
tfat (Tag perlakuan berdasarkan usia)
Deskripsi
Parameter perlakuan berdasarkan usia (tfat) menerima nilai konstan yang menunjukkan bahwa permintaan menerima perlindungan perlakuan berdasarkan usia.
Contoh penggunaan
tfat=1 Perlakuan usia anak-anak ditentukan dengan nilai 1
tfat=2 Perlakuan usia remaja ditentukan dengan nilai 2
tfat=0 Tidak ada perlakuan usia spesifik yang ditentukan dengan nilai 0
tfcd (Tag ditujukan untuk anak-anak) (Tidak digunakan lagi)
Deskripsi
Parameter perlakuan ditujukan untuk anak-anak (tfcd) menerima nilai konstan yang menunjukkan bahwa permintaan harus diperlakukan sebagai ditujukan untuk anak-anak.
Contoh penggunaan
tfcd=1
trt (Jenis traffic)
Deskripsi
Parameter jenis traffic (trt) menerima nilai konstan yang berfungsi untuk meminta traffic organik atau yang dibeli.
Contoh penggunaan
Permintaan untuk traffic yang dibeli:
trt=1
Permintaan untuk traffic organik:
trt=2
Persyaratan dan rekomendasi
Penggunaan SDK
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).
us_privacy (Privasi IAB Amerika Serikat)
Deskripsi
Stringus_national tidak digunakan lagi oleh IAB dan diganti dengan GPP. Namun, Ad Manager akan terus membaca dan mematuhi string tersebut jika diteruskan untuk kompatibilitas mundur. Sebaiknya penayang meninjau GPP atau kontrol privasi lainnya dan bermigrasi dari us_national.
vad_type (Jenis iklan video)
Deskripsi
Parameter jenis iklan video (vad_type) menerima nilai konstan yang menunjukkan apakah yang ditampilkan adalah iklan linear atau non-linear.
Contoh penggunaan
Menampilkan iklan linear:
vad_type=linear
Menampilkan iklan non-linear:
vad_type=nonlinear
vid (ID Video)
Deskripsi
Parameter ID sumber konten (cmsid) dan parameter ID video (vid) menerima nilai variabel.
Agar dapat menargetkan iklan ke konten video, tag video utama Anda harus menyertakan kedua parameter ini.
cmsidmerupakan nomor unik untuk setiap sumber konten. Untuk menemukannya di Google Ad Manager, buka Video, lalu klik Sumber konten, lalu nama sumber.vidadalah string atau angka yang mengidentifikasi video tertentu. ID ini ditetapkan oleh CMS yang menghosting konten Anda. Untuk menemukannya di Google Ad Manager, klik Video, lalu Konten, lalu konten video tertentu.
Contoh penggunaan
cmsid=[value]&vid=[value]
Jika membuat tag untuk video on demand dengan Penyisipan Iklan Dinamis, sebaiknya Anda menggunakan makro yang akan menyisipkan secara dinamis ID video dan sumber konten yang benar.
Misalnya: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Persyaratan dan rekomendasi
Meskipun parameter ini tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau penerapan tertentu, parameter ini diperlukan untuk menggunakan penargetan konten video.
vpi (Playlist video inline)
Deskripsi
Parameter inline playlist video (vpi) menerima nilai konstan yang menunjukkan apakah VMAP inline akan ditayangkan (menampilkan VAST di dalam VMAP).
Parameter ini dapat digunakan untuk mengurangi latensi, serta menjamin batas frekuensi dan pengecualian kompetitif di seluruh streaming video.
Contoh penggunaan
Menampilkan VAST:
vpi=1
Menampilkan pengalihan:
vpi=0