Menyediakan parameter penargetan ke streaming

Menyediakan salah satu dari parameter penargetan berikut bersifat opsional.

Saat Anda membuat atau mengonfigurasi sumber konten untuk video on demand (VOD) atau menyiapkan live stream untuk DAI, Anda harus menentukan tag iklan video default. Semua streaming DAI menggunakan tag iklan tersebut dan parameternya secara default. Parameter tag iklan berlaku untuk mid-roll dan pre-roll. Jika Anda ingin agar pemutar meminta sesuatu yang unik untuk streaming tertentu, opsi ini tersedia untuk Anda.

Parameter tag iklan Ad Manager yang dapat diganti

Langsung ke parameter tertentu:

addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent givn|paln idtype is_lat iu

iu is_lat ltd mpt mpv npa omid_p ppid ptpl ptpln rdid rdid

rdp sdk_apis sid sz tfcd trt vconp vpa vpmute wta

 

Mengganti tag iklan default

Saat pemutar video Anda meminta streaming, tag iklan default digunakan sama persis seperti yang ditetapkan dalam antarmuka. Namun, Anda dapat mengganti parameter tertentu pada tag tersebut dalam permintaan streaming. Hanya parameter berikut yang dapat diganti.

Pelajari cara mengganti tag iklan default menggunakan IMA SDK atau menggunakan SSB.

Parameter	Deskripsi	Nilai contoh
iu	Unit iklan saat ini. Ini harus mengikuti format: /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	Pasangan nilai kunci yang sebaiknya digunakan untuk penargetan kampanye Ad Manager. Beberapa platform memerlukan encoding URL. Persyaratan encoding URL tidak berlaku saat menggunakan IMA DAI SDK untuk HTML5, karena nilainya dienkode secara otomatis. Parameter ini tidak akan berfungsi jika sudah dienkode pada HTML5.	Contoh dengan beberapa pasangan nilai kunci, seperti: section=sports  page=golf,tennis   Streaming SSB: Enkode dan gabungkan seluruh nilai cust_params, tetapi jangan lakukan enkode ganda. cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast: Enkode nilai saja. streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku: Enkode dan gabungkan seluruh nilai cust_params, tetapi jangan lakukan enkode ganda. request.adTagParameters =   "cust_params=   section%3Dsports   %26page%3Dgolf%2Ctennis"   iOS dan tvOS: Jangan lakukan enkode. request.adTagParameters = @{   @"cust_params" :   @"section=sports&   multi=golf,tennis"};   Android: Jangan lakukan enkode. Map<String, String> adTagParams =   new HashMap<>();   adTagParams.put(   "cust_params",   "ge=0&gr=2");
sz	Mengganti parameter sz dari tag iklan default yang memungkinkan perubahan secara dinamis untuk perangkat yang berbeda. Jangan mencantumkan "v" setelah ukuran.	sz=400x300
tfcd	Beri tag pada permintaan perlakuan untuk anak-anak. Jika permintaan DAI menyertakan tfcd=1, nilai apa pun yang ditetapkan ke parameter rdid, idtype, atau is_lat dihapus untuk mematuhi COPPA.	tfcd=1
description_url	Nilai ini harus mendeskripsikan video yang diputar di halaman. Biasanya, ini adalah halaman yang berisi pemutar video, tetapi juga dapat berupa halaman dengan teks yang mendeskripsikan video. Anda harus selalu mengenkode URL description_url pada streaming SSB dan saat menggunakan IMA DAI SDK untuk Roku Persyaratan ini tidak berlaku saat menggunakan IMA DAI SDK untuk HTML5, karena nilainya dienkode secara otomatis. Parameter ini tidak akan berfungsi jika sudah dienkode pada HTML5. Parameter tidak ditetapkan secara otomatis oleh IMA SDK. Parameter harus ditetapkan secara manual. Kolom ini wajib diisi jika Anda menggunakan Ad Exchange. Pelajari lebih lanjut	Contoh yang URL-nya dienkode: description_url= http%3A%2F%2Fwww.sample.com %2Fgolf.html Contoh yang tidak dienkode: description_url= http://www.sample.com/ golf.html
ppid	ID yang Diberikan Penayang (PPID) memungkinkan penayang mengirimkan ID untuk digunakan dalam pembatasan frekuensi, penargetan dan segmentasi audiens, rotasi iklan berurutan, serta kontrol penayangan iklan berbasis audiens lainnya di seluruh perangkat. Pelajari lebih lanjut	ppid= 12JD92J...
ciu_szs	Comma-separated list ukuran iklan pengiring. Iklan pengiring hanya didukung dengan DAI saat menggunakan HTML5 SDK.	ciu_szs=728x90,300x250
mpt	Menunjukkan nama pemutar partner. Parameter ini umumnya digunakan oleh partner seperti JWPlayer, Brightcove, Ooyala yang berintegrasi dengan SDK.	mpt=JWPlayer
mpv	Menunjukkan versi pemutar partner. Hanya boleh disetel jika mpt juga disetel, dan mewakili versi pemutar partner yang berintegrasi dengan SDK.	mpv=2.1
ptpl	ID template jeda iklan. Anda dapat menemukan ID ini di URL Ad Manager saat melihat setelan untuk template jeda iklan di antarmuka Ad Manager. ID tersebut akan terlihat sebagai nilai untuk parameter break_template_id.	ptpl=1234
ptpln	Nama template jeda iklan. Sesuai dengan kolom "Nama" di Ad Manager, bukan nama yang ditampilkan.	ptpln=break_template_saya
an	Parameter an adalah nama aplikasi. Parameter ini harus diterapkan ke permintaan yang dikirim dari aplikasi seluler dan perangkat TV yang terhubung karena sebagian besar iklan video terprogram mewajibkannya.* IMA SDK akan otomatis mengisinya, tetapi parameter ini harus ditentukan secara manual dengan DAI API dan SSB (lingkungan selain SDK). * Meskipun nama aplikasi harus berupa nama yang dapat dibaca manusia, SDK tetap tidak dapat mengakses ID App Store 9 digit di iOS dan tvOS. Dalam kasus ini, SDK akan mengirimkan app bundle melalui parameter an (dalam format com.package.publisher).	an=sample%20app
ltd	Menunjukkan apakah iklan ditayangkan secara terbatas jika tidak ada izin penggunaan cookie atau ID lokal lainnya. Pelajari lebih lanjut	ltd=1
rdid idtype is_lat	Dengan aplikasi native (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 Solusi Video sisi klien. 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.	Lihat contoh mendetail terkait ID perangkat yang dapat direset.
trt	Menetapkan traffic sebagai telah dibeli atau sebaliknya.	Jenis traffic yang tidak ditentukan: trt=0 Traffic yang dibeli: trt=1 Traffic organik: trt=2
vconp	Direkomendasikan berdasarkan Panduan Pengukuran Video MRC Panduan Pengukuran Video Menunjukkan apakah pemutar bermaksud untuk memutar video konten satu per satu secara berkelanjutan atau tidak, serupa dengan siaran TV. Nilai yang mungkin adalah 2 jika pemutaran berkelanjutan AKTIF, dan 1 jika NONAKTIF. Parameter ini harus dibiarkan tidak disetel jika tidak diketahui.	Pemutaran berkelanjutan AKTIF: vconp=2   Pemutaran berkelanjutan NONAKTIF: vconp=1
vpa	Direkomendasikan berdasarkan Panduan Pengukuran Video MRC Panduan Pengukuran Video Menunjukkan apakah 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.	Putar otomatis: vpa=auto   Klik: vpa=click
vpmute	Direkomendasikan berdasarkan Panduan Pengukuran Video MRC Panduan Pengukuran Video Menunjukkan apakah pemutaran iklan dimulai saat pemutar video dibisukan. Nilai yang mungkin adalah 1 untuk dibisukan, dan 0 untuk dibunyikan. Parameter ini harus dibiarkan tidak disetel jika tidak diketahui.	Dibisukan: vpmute=1   Dibunyikan: vpmute=0
npa	Setelan personalisasi untuk permintaan iklan. Anda harus menentukan parameter di permulaan tag untuk menghindari risiko pemotongan. Tentukan npa=1 untuk menandai permintaan iklan sebagai tidak dipersonalisasi. Jika parameter dihilangkan, iklan yang dipersonalisasi menjadi setelan default.	npa=1
omid_p	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_pdansdk_apis (API yang didukung, yang juga dapat menyertakan API lain yang dipisahkan koma).	Saat menggunakan PAL: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Saat tidak menggunakan PAL: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
gdpr gdpr_consent	Kolom ini digunakan untuk meneruskan informasi izin TCF v2.0 bagi permintaan sinkronisasi cookie masuk dan keluar.	Lihat spesifikasi GDPR.
givn|paln	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.	Anda dapat membaca selengkapnya tentang nilai yang diteruskan ke parameter ini di panduan memulai untuk PAL.
addtl_consent	Daftar Penyedia Teknologi Iklan Google yang diizinkan, tetapi tidak terdaftar di IAB.	Lihat spesifikasi Izin Tambahan.
rdp	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 ditetapkan ke rdp=0, tidak akan membatasi, kecuali jika setelan jaringan Batasi Pemrosesan Data-nya diaktifkan.	rdp=1
sdk_apis	Parameter framework SDK API menerima daftar nilai bilangan bulat konstan comma-separated list yang menunjukkan semua framework API yang didukung oleh pemutar. Lihat daftar kemungkinan nilai Framework API. Parameter ini digunakan oleh penayang yang menggunakan Library Akses Terprogram (PAL). Jika Anda mencoba menetapkan nilai ke parameter ini saat menggunakan IMA SDK, nilai tersebut akan diganti dengan nilai yang didukung oleh IMA SDK.	sdk_apis=2,7,9
sid	Jenis ID iklan dengan perlindungan privasi yang hanya dapat digunakan untuk tujuan pembatasan frekuensi. Berdasarkan pedoman IFA IAB, parameter ini harus diisi dalam format UUID. Pelajari lebih lanjut Anda dapat memilih untuk tidak meneruskan ID sesi dengan menyetel sid=0.	sid=123e4567-e89b-12d3 -a456-426614174000
wta	Menunjukkan dukungan pemutar video untuk merender "Mengapa Iklan ini?". Parameter ini secara otomatis didukung jika Anda menggunakan IMA SDK. Jika Anda tidak menggunakan IMA SDK, pemutar video harus menerapkan dukungan Icon dan IconClickFallbackImage VAST, sebagaimana didokumentasikan dalam pedoman DAI API ini.*  WTA tidak didukung untuk SSB. Kolom ini wajib diisi jika Anda menggunakan Ad Exchange. Pelajari lebih lanjut * Dukungan untuk IconClickFallbackImage tidak diwajibkan, kecuali untuk di perangkat CTV.	Didukung: wta=1 Tidak didukung: wta=0

Mengganti tag iklan default menggunakan IMA SDK

Saat pemutar video meminta streaming DAI menggunakan IMA SDK, pemutar video dapat mengirimkan kolom yang disebut "adTagParameters". Struktur yang mirip kamus ini dapat disetel dengan pasangan nilai kunci, yang kuncinya mungkin merupakan parameter tag iklan Ad Manager yang tercantum pada tabel di atas.

Anda dapat menyesuaikan streaming dan mengirimkan parameter yang tidak berkaitan dengan permintaan iklan Ad Manager menggunakan struktur yang sama ini. Pelajari cara meminta varian streaming tertentu dan cara menyiapkan periode reses iklan.

Penerapan kolom adTagParameters sedikit berbeda, bergantung pada platform atau bahasa pemrograman tertentu. Lihat dokumentasi pengembangan iOS, Android, tvOS, Chromecast, HTML5 atau dokumentasi tambahan di Panduan pengembangan aplikasi dan pemutar DAI.

 

Menyetel adTagParameters melalui SDK

Saat Anda menyetel cust_params atau description_url melalui SDK, di aplikasi iOS, tvOS, dan Android, jangan mengenkode URL string. Anda dapat mengirimkan cust_params sebagai string tunggal yang menggabungkan pasangan nilai kunci dengan "&".

Misalnya, jika Anda ingin menyetel cust_params ke nilai sport=football&city=newyork:

Struktur adTagParams yang menggunakan nilai yang tidak dienkode akan menjadi:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport=football&city=newyork",
  "description_url": "http://www.sample.com/golf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Struktur adTagParameters yang menggunakan nilai yang dienkode untuk permintaan streaming HTML5 akan menjadi:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport%3Dfootball%26city%3Dnewyork",
  "description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Struktur adTagParams yang menggunakan nilai yang dienkode untuk permintaan streaming Roku akan menjadi:

request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"

Mengganti tag iklan default menggunakan DAI API ^(Beta) 

DAI API yang digunakan saat pemutar video meminta streaming DAI dapat mengirimkan pasangan nilai kunci secara opsional, yang kuncinya mungkin merupakan parameter tag iklan Ad Manager yang tercantum pada tabel di atas.

Parameter ini harus dikirim sebagai bagian dari isi permintaan HTTP POST, dengan jenis formulir application/x‑www‑form‑urlencoded baik untuk linear/live maupun VOD.

Anda dapat menyesuaikan streaming dan mengirimkan parameter yang tidak berkaitan dengan permintaan iklan Ad Manager menggunakan struktur yang sama ini. Pelajari cara meminta parameter varian streaming tertentu, dan autentikasi HMAC.

Lihat penerapan sampel DAI API.

Mengganti tag iklan default menggunakan SSB

Berikut adalah contoh pengubahan tag iklan VOD default menggunakan SSB. Parameter yang diganti yang dikirimkan oleh pemutar atau aplikasi telah ditandai.

Contoh video on demand

	Contoh
URL streaming VOD dasar	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8
(dengan unit iklan yang ditentukan)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?iu=/9876/ path/to/adunit
(dengan nilai kunci yang diganti)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& cust_params=sport%3Dgolf%26section%3Dblog %26anotherKey%3Dvalue1%2Cvalue2
(dengan deklarasi konten yang ditujukan untuk anak-anak)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfcd=1
(dengan unit iklan DAN nilai kunci yang diganti DAN description_url kustom DAN deklarasi konten yang ditujukan untuk anak-anak)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

 

Contoh streaming live linear

	Contoh
URL streaming live linear dasar	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8
(dengan unit iklan yang ditentukan)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?iu=/9876/path/to/adunit
(dengan nilai kunci yang diganti)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?cust_params=sport%3Dgolf%26section %3Dblog%26otherKey%3Dvalue1%2Cvalue2
(dengan deklarasi konten yang ditujukan untuk anak-anak)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfcd=1
(dengan unit iklan DAN nilai kunci yang diganti DAN description_url kustom DAN deklarasi konten yang ditujukan untuk anak-anak)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

Memperbarui parameter penargetan secara dinamis selama live stream tertentu

Anda dapat memperbarui data penargetan secara dinamis untuk pengguna tertentu saat mereka sedang menonton streaming menggunakan metode replaceAdTagParameters di IMA DAI SDK.

Untuk mengatasi persoalan terkait pemecahan masalah atau pemadaman DAI, hubungi dukungan penayang.