google.
Class untuk menentukan properti permintaan iklan.
Konstruktor
PermintaanIklan
new AdsRequest()
- Implementasi
- google.ima.AdsRequestInterface
Properti
AdTagUrl
string
Menentukan URL tag iklan yang diminta dari server iklan. Untuk mengetahui detail tentang cara membuat URL tag iklan, lihat Membuat tag video iklan utama secara manual.
Parameter ini wajib diisi.
Respons iklan
(Dokumen null, string, atau non-null)
Menentukan dokumen VAST 2.0 yang akan digunakan sebagai respons iklan, bukan membuat permintaan melalui URL tag iklan. Hal ini dapat berguna untuk proses debug dan situasi lain saat respons VAST sudah tersedia.
Parameter ini bersifat opsional.
durasiKonten
(null atau angka)
Menentukan durasi konten yang ditampilkan dalam detik. Hal ini digunakan dalam 2 kasus: 1) penargetan iklan AdX dan 2) memutuskan kapan harus melakukan pramuat postroll VMAP.
Parameter ini bersifat opsional.
contentKeywords
(Array string null atau non-null)
Menentukan kata kunci yang digunakan untuk mendeskripsikan konten yang akan ditampilkan. Digunakan dalam permintaan AdX.
Parameter ini bersifat opsional.
Judul konten
(null atau string)
Menentukan judul konten yang akan ditampilkan. Digunakan dalam permintaan AdX.
Parameter ini bersifat opsional.
kekuatanNonLinearFullSlot
boolean
Memaksa iklan AdSense non-linear untuk dirender sebagai slot penuh linear. Jika disetel, video konten akan dijeda dan iklan teks atau gambar non-linear akan dirender sebagai slot penuh. Video konten akan dilanjutkan setelah iklan dilewati atau ditutup.
linearSlotSlot
angka
Menentukan tinggi area persegi panjang tempat iklan linear ditampilkan. Nilai ini digunakan sebagai salah satu kriteria pemilihan iklan. Nilai ini tidak perlu dicocokkan dengan tinggi iklan yang sebenarnya.
Parameter ini diperlukan.
LinearAdSlotWidth
angka
Menentukan lebar area persegi panjang tempat iklan linear ditampilkan. Nilai ini digunakan sebagai salah satu kriteria pemilihan iklan. Nilai ini tidak perlu dicocokkan dengan lebar iklan yang sebenarnya.
Parameter ini wajib diisi.
liveStreamPrefetch Detik
angka
Menentukan jumlah waktu tunggu maksimum dalam detik, setelah memanggil requestAds, sebelum meminta URL tag iklan. Hal ini dapat digunakan untuk membagi permintaan selama live stream, guna mengurangi lonjakan jumlah permintaan.
NonLinearAdSlotHeight
angka
Menentukan tinggi area persegi panjang tempat iklan non-linear ditampilkan. Nilai ini digunakan sebagai salah satu kriteria pemilihan iklan. Nilai ini tidak perlu dicocokkan dengan tinggi iklan yang sebenarnya.
Parameter ini diperlukan.
nonLinearAdSlotWidth
angka
Menentukan lebar area persegi panjang tempat iklan non-linear ditampilkan. Nilai ini digunakan sebagai salah satu kriteria pemilihan iklan. Nilai ini tidak perlu dicocokkan dengan lebar iklan yang sebenarnya.
Parameter ini diperlukan.
omidAccessModeRules
Objek non-null dengan properti string
Objek setelan untuk memetakan vendor verifikasi ke Mode Akses OMID. Kunci harus berupa nilai di google.ima.OmidVerificationVendor, dan nilai harus berupa nilai di google.ima.OmidAccessMode.
URL skrip verifikasi dicocokkan secara internal dengan ekspresi reguler yang disediakan vendor untuk ditetapkan ke kunci OmidVerificationVendor. Selanjutnya, IMA akan mencari mode akses untuk vendor tertentu menggunakan objek ini.
Untuk URL skrip yang tidak diselesaikan ke vendor yang dikenal, atau jika OmidVerificationVendor yang diselesaikan tidak disediakan dalam objek ini, IMA akan menggunakan mode akses yang disediakan untuk OmidVerificationVendor.OTHER. Jika OmidVerificationVendor.OTHER tidak disediakan, mode akses TERBATAS akan digunakan.
UrlHalaman
(null atau string)
Menentukan URL lengkap halaman yang akan disertakan dalam permintaan iklan Google untuk tujuan penargetan. URL harus berupa URL yang valid. Jika ditentukan, nilai ini akan digunakan untuk makro VAST [PAGEURL].
Parameter ini bersifat opsional.
vastLoadTimeout
angka
Penggantian untuk waktu tunggu pemuatan VAST default dalam milidetik untuk satu wrapper. Waktu tunggu default adalah 5.000 md.
Parameter ini bersifat opsional.
Metode
setAd dibutuhkanAutoPlay
setAd WillAutoPlay(autoPlay) mengembalikan batal
Memberi tahu SDK apakah pemutar bermaksud memulai konten dan iklan sebagai respons terhadap tindakan pengguna atau apakah konten akan diputar secara otomatis. Mengubah setelan ini tidak akan memengaruhi pemutaran iklan.
Parameter |
|
|---|---|
|
Putar otomatis |
boolean Apakah konten dan iklan akan diputar otomatis atau akan dimulai oleh tindakan pengguna. |
- Hasil
-
void
setAd dibutuhkanPlayDibisukan
setAd WillPlayBisukand(dibisukan) mengembalikan batal
Memberi tahu SDK apakah pemutar bermaksud memulai iklan saat dibisukan. Mengubah setelan ini tidak akan memengaruhi pemutaran iklan, tetapi akan mengirim sinyal yang sesuai dalam permintaan iklan untuk memungkinkan pembeli mengajukan bid pada inventaris yang dibisukan.
Parameter |
|
|---|---|
|
dibisukan |
boolean Apakah iklan akan diputar saat dibisukan. |
- Hasil
-
void
setContinuousPlayback
setContinuousPlayback(continuousPlayback) mengembalikan void
Memberi tahu SDK apakah pemutar bermaksud untuk memutar video konten secara berkelanjutan satu per satu, serupa dengan siaran TV. Mengubah setelan ini tidak akan memengaruhi pemutaran iklan, tetapi akan mengirim sinyal yang sesuai dalam permintaan iklan ini agar pembeli dapat mengajukan bid untuk jenis inventaris iklan.
Parameter |
|
|---|---|
|
pemutaran berkelanjutan |
boolean Apakah video konten diputar satu per satu secara berkelanjutan. |
- Hasil
-
void