Notifikasi

Hanya tersedia di Google Ad Manager 360.

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

bookmarkLangsung 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 rdididtype, 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.

Peringatan

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

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.

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.

Video on demand

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
 
live linear

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.

Apakah ini membantu?

Bagaimana cara meningkatkannya?
Telusuri
Hapus penelusuran
Tutup penelusuran
Menu utama
14452267014122301787
true
Pusat Bantuan Penelusuran
true
true
true
true
true
148
false
false