IMA DAI SDK API Google

1. 1. google.ima.dai.api.Ad
   2. google.ima.dai.api.AdPodInfo
   3. google.ima.dai.api.AdProgressData
   4. google.ima.dai.api.CompanionAd
   5. google.ima.dai.api.CuePoint
   6. google.ima.dai.api.LiveStreamRequest
   7. google.ima.dai.api.StreamData
   8. google.ima.dai.api.StreamEvent
   9. google.ima.dai.api.StreamEvent.Type
   10. google.ima.dai.api.StreamManager
   11. google.ima.dai.api.StreamRequest
   12. google.ima.dai.api.VODStreamRequest
   13. google.ima.VERSION

Class google.ima.dai.api.Ad

Metode

getAdId, getAdPodInfo, getAdSystem, getAdvertiserName, getApiFramework, getCompanionAds, getCreativeAdId, getCreativeId, getDealId, getDescription, getDuration, getTitle, getVastMediaHeight, getVastMediaWidth, getWrapperAdIds, getWrapperAdSystems, getWrapperCreativeIds

Class yang mewakili objek iklan selama pemasangan iklan dinamis. Class ini mengekspos sebagian properti ima.Ad.

getAdId()

Menampilkan string:

getAdPodInfo()

Menampilkan google.ima.dai.api.AdPodInfo:

getAdSystem()

Menampilkan string:

getAdvertiserName()

Menampilkan string:

getApiFramework()

Menampilkan string:

getCompanionAds()

Menampilkan Array.<google.ima.dai.api.CompanionAd>:

getCreativeAdId()

Menampilkan string:

getCreativeId()

Menampilkan string:

getDealId()

Menampilkan string:

getDescription()

Menampilkan string:

getDuration()

Menampilkan number:

getTitle()

Menampilkan string:

getVastMediaHeight()

Menampilkan number:

getVastMediaWidth()

Menampilkan number:

getWrapperAdIds()

Menampilkan Array.<string>:

getWrapperAdSystems()

Menampilkan Array.<string>:

getWrapperCreativeIds()

Menampilkan Array.<string>:

Class google.ima.dai.api.AdPodInfo

Metode

getAdPosition, getMaxDuration, getPodIndex, getTimeOffset, getTotalAds

Class yang mewakili objek info pod iklan selama penyisipan iklan dinamis. Class ini mengekspos sebagian properti ima.AdPodInfo.

getAdPosition()

Menampilkan number:

getMaxDuration()

Menampilkan number:

getPodIndex()

Menampilkan number:

getTimeOffset()

Menampilkan number:

getTotalAds()

Menampilkan number:

Class google.ima.dai.api.AdProgressData

Kolom

adBreakDuration, adPosition, currentTime, duration, totalAds

Class untuk menentukan data progres iklan.

Properti

Nama	Jenis	Deskripsi
adBreakDuration
adPosition
currentTime
duration
totalAds

Class google.ima.dai.api.CompanionAd

Metode

getAdSlotId, getContent, getContentType, getHeight, getWidth

Class yang mewakili objek iklan pendamping selama pemasangan iklan yang dinamis. Class ini mengekspos subset properti ima.CompanionAd.

getAdSlotId()

Menampilkan string:

getContent()

Menampilkan string:

getContentType()

Menampilkan string:

getHeight()

Menampilkan number:

getWidth()

Menampilkan number:

Class google.ima.dai.api.CuePoint

Kolom

end, played, start

Class untuk menentukan properti titik tanda, yang mewakili jeda iklan di streaming VOD DAI.

Properti

Nama	Jenis	Deskripsi
end		Waktu berakhir untuk titik tanda ini.
played		Jika titik tanda ini telah diputar.
start		Waktu mulai untuk titik tanda ini.

Class google.ima.dai.api.LiveStreamRequest

Kolom

assetKey

Class untuk menentukan properti permintaan live stream.

Konstruktor:

Parameter	Jenis	Deskripsi
opt_liveStreamRequest	Object	objek yang sudah memiliki properti permintaan streaming yang ditetapkan.

Properti

Nama	Jenis	Deskripsi
assetKey		Ini digunakan untuk menentukan streaming yang akan diputar. Kunci aset permintaan live stream adalah ID yang dapat ditemukan di UI DFP.

Class google.ima.dai.api.StreamData

Kolom

adProgressData, cuepoints, errorMessage, streamId, subtitles, url

Class untuk menentukan data aliran.

Properti

Nama	Jenis	Deskripsi
adProgressData		Informasi terkait pengaturan waktu untuk iklan yang sedang diputar.
cuepoints		Titik tanda iklan untuk streaming on demand. Hal ini dapat berubah seiring kemajuan streaming. Ini hanya akan diisi di pemroses peristiwa untuk AdEvent CUEPOINTS_CHANGED.
errorMessage
streamId
subtitles
url

Class google.ima.dai.api.StreamEvent

Metode

getAd, getStreamData

Jenis peristiwa ini dimunculkan oleh pengelola streaming sebagai notifikasi saat status streaming berubah.

getAd()

Menampilkan google.ima.dai.api.Ad: objek yang ditampilkan dengan informasi iklan.

getStreamData()

Menampilkan google.ima.dai.api.StreamData: menampilkan objek dengan informasi streaming.

Enum google.ima.dai.api.StreamEvent.Type

Kolom

AD_BREAK_ENDED, AD_BREAK_STARTED, AD_PROGRESS, CLICK, COMPLETE, CUEPOINTS_CHANGED, ERROR, FIRST_QUARTILE, LOADED, MIDPOINT, STARTED, STREAM_INITIALIZED, THIRD_QUARTILE

Daftar jenis peristiwa yang didukung oleh IMA SDK.

Nilai

Nilai	Deskripsi
AD_BREAK_ENDED	Diaktifkan saat jeda iklan berakhir.
AD_BREAK_STARTED	Diaktifkan saat jeda iklan dimulai.
AD_PROGRESS	Diaktifkan saat ada pembaruan pada progres iklan.
CLICK	Dikirim saat elemen klik diklik atau diketuk saat iklan diputar.
COMPLETE	Diaktifkan saat iklan selesai.
CUEPOINTS_CHANGED	Dikirim untuk streaming on demand saat titik tanda berubah.
ERROR	Diaktifkan saat terjadi error.
FIRST_QUARTILE	Diaktifkan saat iklan mencapai kuartil pertamanya.
LOADED	Diaktifkan saat manifes streaming tersedia.
MIDPOINT	Diaktifkan saat iklan mencapai titik tengahnya.
STARTED	Diaktifkan saat iklan dimulai.
STREAM_INITIALIZED	Diaktifkan saat streaming diinisialisasi.
THIRD_QUARTILE	Diaktifkan saat iklan mencapai kuartil ketiganya.

Class google.ima.dai.api.StreamManager

Metode

contentTimeForStreamTime, onTimedMetadata, previousCuePointForStreamTime, processMetadata, requestStream, setClickElement, streamTimeForContentTime

Menangani streaming penyisipan iklan dinamis. API ini mengelola interaksi dengan backend DAI dan menangani ping pelacakan serta meneruskan peristiwa iklan dan streaming ke penayang. Pengelola ini tidak mewarisi dari BaseAdsManager karena bukan pengelola untuk iklan tertentu, tetapi pengelola untuk seluruh streaming

Konstruktor:

Parameter	Jenis	Deskripsi
videoElement	HTMLVideoElement	Elemen pemutar video yang sebenarnya.

contentTimeForStreamTime(streamTime)

Menampilkan waktu konten tanpa iklan untuk waktu streaming tertentu. Menampilkan waktu streaming yang diberikan untuk live stream.

Menampilkan number: waktu konten yang sesuai dengan waktu streaming tertentu setelah iklan dihapus.

Parameter	Jenis	Deskripsi
streamTime	number	waktu streaming dengan iklan yang disisipkan (dalam detik).

onTimedMetadata(metadata)

Meneruskan kamus metadata yang diproses. Kamus mengharapkan kunci 'TXXX' dengan string metadata yang ditentukan pengguna sebagai nilai. Jika pemutar Anda menyediakan metadata mentah, panggil ima.dai.api.StreamManager.processMetadata.

Parameter	Jenis	Deskripsi
metadata	Object	Kamus metadata.

previousCuePointForStreamTime(streamTime)

Menampilkan titik tanda sebelumnya untuk waktu streaming yang ditentukan. Menampilkan null jika tidak ada titik tanda seperti itu. Ini digunakan untuk menerapkan fitur seperti snap back, dan dipanggil saat penayang mendeteksi bahwa pengguna mencari untuk mengembalikan pengguna ke jeda iklan.

Menampilkan google.ima.dai.api.CuePoint: titik tanda sebelumnya untuk waktu streaming tertentu.

Parameter	Jenis	Deskripsi
streamTime	number	waktu streaming yang dicari.

processMetadata(type, data, timestamp)

Memproses metadata berwaktu untuk live stream. Gunakan jika pemutar video Anda menyediakan metadata yang tidak diuraikan beserta stempel waktu. Jika tidak, panggil ima.dai.api.StreamManager.onTimedMetadata.

Parameter	Jenis	Deskripsi
type	string	Jenis untuk metadata. Harus berupa 'ID3'.
data	Uint8Array	Data tag mentah. Untuk ID3, harus berupa seluruh tag.
timestamp	number	Waktu saat data harus diproses.

requestStream(streamRequest)

Meminta streaming untuk dimuat menggunakan parameter streaming yang disediakan.

Parameter	Jenis	Deskripsi
streamRequest	google.ima.dai.api.StreamRequest	berisi parameter untuk memuat metadata streaming.

setClickElement(clickElement)

Menetapkan elemen klik-tayang iklan. Elemen ini digunakan sebagai penerima klik atau ketuk saat iklan diputar, dan dapat menyebabkan navigasi keluar dari halaman saat ini.

Parameter	Jenis	Deskripsi
clickElement	Element	elemen yang digunakan sebagai klik-tayang iklan.

streamTimeForContentTime(contentTime)

Menampilkan waktu streaming dengan iklan untuk waktu konten tertentu. Menampilkan waktu konten tertentu untuk live stream.

Menampilkan number: waktu streaming yang sesuai dengan waktu konten tertentu setelah iklan disisipkan.

Parameter	Jenis	Deskripsi
contentTime	number	waktu konten tanpa iklan (dalam detik).

Class google.ima.dai.api.StreamRequest

Kolom

adTagParameters, apiKey, streamActivityMonitorId

Class untuk menentukan properti permintaan streaming.

Properti

Nama	Jenis	Deskripsi
adTagParameters		Anda dapat mengganti sekumpulan parameter tag iklan terbatas pada permintaan streaming. Menyediakan parameter penargetan ke streaming Anda memberikan informasi selengkapnya. Anda dapat menggunakan parameter dai-ot dan dai-ov untuk preferensi varian streaming. Lihat Mengganti Parameter Varian Streaming untuk mengetahui informasi selengkapnya.
apiKey		Kunci API permintaan streaming. Kode ini dikonfigurasi melalui UI Admin DFP dan diberikan kepada penayang untuk membuka kunci konten mereka. Fungsi ini memverifikasi aplikasi yang mencoba mengakses konten.
streamActivityMonitorId		ID yang akan digunakan untuk men-debug streaming dengan pemantauan aktivitas streaming. Ini digunakan untuk memberikan cara yang mudah bagi penayang untuk menemukan log streaming di alat pemantauan aktivitas streaming.

Class google.ima.dai.api.VODStreamRequest

Kolom

contentSourceId, videoId

Class untuk menentukan properti permintaan streaming VOD.

Konstruktor:

Parameter	Jenis	Deskripsi
opt_VODStreamRequest	Object	objek yang sudah memiliki properti permintaan streaming yang ditetapkan.

Properti

Nama	Jenis	Deskripsi
contentSourceId		ID unik untuk konten penayang, dari CMS. Diperlukan untuk streaming on demand.
videoId		ID untuk sumber konten video. Diperlukan untuk streaming on demand.

Konstanta google.ima.VERSION

String yang berisi versi lengkap SDK.