Google Dynamic Ad Insertion (DAI) SDK untuk HTML5 mendukung Secure Interactive Media Interface Definition (SIMID) versi 1.1. Panduan ini membahas fitur dan pesan SIMID tertentu yang didukung DAI SDK.
Memahami pesan materi iklan ke pemain
Tabel berikut mencantumkan pesan yang dapat dikirim materi iklan SIMID ke IMA DAI:
| Pesan | Deskripsi |
|---|---|
clickThru |
DAI SDK melakukan ping pada URL pelacakan klik-tayang yang dikonfigurasi dalam tag iklan DAI. DAI SDK mengabaikan opsi navigasi atau URI kustom apa pun yang disediakan materi iklan. |
getMediaState |
Menampilkan status pemutar media saat ini, termasuk properti currentTime, duration, volume, muted, paused, dan fullscreen. Properti currentSrc selalu menampilkan null karena DAI menggunakan streaming yang digabungkan di sisi server. |
log |
Meneruskan pesan log materi iklan ke logging konsol debug DAI SDK untuk pemecahan masalah. |
reportTracking |
Meminta DAI SDK melakukan ping pada URL pelacakan untuk materi iklan. |
requestPause |
Meminta DAI SDK menjeda pemutar media. |
requestPlay |
Meminta DAI SDK melanjutkan pemutaran di pemutar media. |
requestSkip |
Meminta DAI SDK melewati iklan saat ini. Hanya didukung untuk streaming VOD. Menolak jika materi iklan mengirim pesan ini untuk livestream. |
Meninjau pesan materi iklan ke pemain yang tidak didukung
DAI SDK tidak menangani jenis CreativeMessage berikut:
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: selalu ditolak. Pemain mengharapkan materi iklan menangani navigasi.requestResize: selalu ditolak. DAI SDK tidak mendukung pengubahan ukuran materi iklan.requestStop: selalu ditolak. Jenis ini untuk kasus penggunaan durasi yang diperpanjang, yang tidak didukung DAI.requestChangeVolume: DAI SDK berhasil menyelesaikan peristiwa ini, tetapi tidak melakukan perubahan volume untuk materi iklan.
Memahami pesan pemain ke materi iklan
Tabel berikut mencantumkan pesan yang didukung DAI SDK untuk dikirim ke materi iklan SIMID:
| Pesan | Deskripsi |
|---|---|
init |
Dikirim selama penyiapan sesi dengan data lingkungan dan parameter iklan. |
startCreative |
Memberi tahu materi iklan untuk memulai dan menampilkan iframe materi iklan. |
adStopped |
Memberi tahu bahwa sesi iklan telah berakhir, termasuk kode alasan. |
adSkipped |
Memberi tahu materi iklan bahwa pengguna atau DAI SDK melewati iklan. Hanya didukung untuk streaming VOD. |
Meninjau pesan pemain ke materi iklan yang tidak didukung
DAI SDK tidak mendukung atau mengirim pesan berikut ke materi iklan:
resizeappBackgroundedappForegroundedlog
Meninjau pembaruan status media
DAI SDK mengirim pesan mediaStateUpdate ke materi iklan untuk peristiwa berikut:
playpausestalled(buffering)seekingseekedtimeupdate(secara berkala)volumechange(termasuk status nonaktif)
DAI SDK tidak mendukung peristiwa berikut dan tidak mengirim pembaruan status media saat peristiwa terjadi:
endeddurationchangeerror