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:
|
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: |
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:
Streaming SSB: Enkode dan gabungkan seluruh nilai
Chromecast:
Roku: Enkode dan gabungkan seluruh nilai
iOS dan tvOS: Jangan lakukan enkode.
Android: Jangan lakukan enkode.
|
|
sz |
Mengganti parameter Jangan mencantumkan " |
sz=400x300 |
|
tfcd |
Beri tag pada permintaan perlakuan untuk anak-anak. Jika permintaan DAI menyertakan |
|
|
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. Parameter tidak ditetapkan secara otomatis oleh IMA SDK. Parameter harus ditetapkan secara manual. |
Contoh yang URL-nya dienkode: Contoh yang tidak dienkode: |
||
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= |
|
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 |
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 |
ptpl=1234 |
|
ptpln |
Nama template jeda iklan. Sesuai dengan kolom "Nama" di Ad Manager, bukan nama yang ditampilkan.
|
ptpln=break_template_saya |
|
an |
Parameter 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 |
|
|
ltd |
Menunjukkan apakah iklan ditayangkan secara terbatas jika tidak ada izin penggunaan cookie atau ID lokal lainnya. Pelajari lebih lanjut | ltd=1 |
|
rdid |
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.
|
Lihat contoh mendetail terkait ID perangkat yang dapat direset. | |
trt |
Menetapkan traffic sebagai telah dibeli atau sebaliknya. |
Jenis traffic yang tidak ditentukan: Traffic yang dibeli: Traffic organik: |
|
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 Parameter ini harus dibiarkan tidak disetel jika tidak diketahui. |
Pemutaran berkelanjutan AKTIF:vconp=2 Pemutaran berkelanjutan NONAKTIF: |
|
vpa |
Direkomendasikan berdasarkan Panduan Pengukuran Video MRC Panduan Pengukuran Video
Menunjukkan apakah iklan dimulai melalui putar otomatis atau klik. Nilai yang memungkinkan adalah Parameter ini harus dibiarkan tidak disetel jika tidak diketahui. |
Putar otomatis:vpa=auto Klik: |
|
vpmute |
Direkomendasikan berdasarkan Panduan Pengukuran Video MRC Panduan Pengukuran Video
Menunjukkan apakah pemutaran iklan dimulai saat pemutar video dibisukan. Nilai yang mungkin adalah Parameter ini harus dibiarkan tidak disetel jika tidak diketahui. |
Dibisukan:vpmute=1 Dibunyikan: |
|
npa |
Setelan personalisasi untuk permintaan iklan. Anda harus menentukan parameter di permulaan tag untuk menghindari risiko pemotongan.
Tentukan |
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 |
Saat menggunakan PAL:
|
|
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 |
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 |
|
|
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 |
|
|
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 WTA tidak didukung untuk SSB. Kolom ini wajib diisi jika Anda menggunakan Ad Exchange. Pelajari lebih lanjut * Dukungan untuk |
Didukung: Tidak didukung: |
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/ |
(dengan unit iklan yang ditentukan) | http://dai.google.com/ondemand/hls/content/ |
(dengan nilai kunci yang diganti) |
http://dai.google.com/ondemand/hls/content/ |
(dengan deklarasi konten yang ditujukan untuk anak-anak) |
http://dai.google.com/ondemand/hls/content/ |
(dengan unit iklan DAN nilai kunci yang diganti DAN description_url kustomDAN deklarasi konten yang ditujukan untuk anak-anak) |
http://dai.google.com/ondemand/hls/content/ |
Contoh streaming live linear |
Contoh | |
---|---|
URL streaming live linear dasar | https://dai.google.com/linear/hls/event/<asset_key> |
(dengan unit iklan yang ditentukan) | https://dai.google.com/linear/hls/event/<asset_key> |
(dengan nilai kunci yang diganti) | https://dai.google.com/linear/hls/event/<asset_key> |
(dengan deklarasi konten yang ditujukan untuk anak-anak) |
https://dai.google.com/linear/hls/event/<asset_key> |
(dengan unit iklan DAN nilai kunci yang diganti DAN description_url kustomDAN deklarasi konten yang ditujukan untuk anak-anak) |
https://dai.google.com/linear/hls/event/<asset_key> |
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.