Google Interactive Media Ads (IMA) SDK untuk HTML5 mendukung Secure Interactive Media Interface Definition (SIMID) versi 1.1. Panduan ini membahas fitur dan pesan SIMID tertentu yang didukung IMA SDK.
Memahami pesan materi iklan kepada pemain
Tabel berikut mencantumkan pesan yang dapat dikirim materi iklan SIMID ke IMA SDK:
| Pesan | Deskripsi |
|---|---|
clickThru |
Menangani klik iklan berdasarkan materi iklan URI yang disediakan. |
fatalError |
Menghentikan sesi iklan dan melaporkan error fatal dari materi iklan. |
getMediaState |
Menampilkan status pemutar media saat ini, termasuk URI, currentTime, durasi, volume, dan status diredam. |
log |
Meneruskan pesan log materi iklan ke IMA SDK untuk proses debug. |
reportTracking |
Meminta IMA SDK untuk melakukan ping pada URL pelacakan atas nama materi iklan. |
requestChangeAdDuration |
Permintaan untuk mengubah total durasi sesi iklan. |
requestNavigation |
Meminta navigasi ke URI eksternal. |
requestPause |
Meminta IMA SDK untuk menjeda pemutar media. |
requestPlay |
Meminta IMA SDK untuk melanjutkan atau memutar pemutar media. |
requestResize |
Permintaan untuk mengubah ukuran pemutar video. Jika pemutar mengizinkan pengubahan ukuran, IMA SDK akan mengubah ukuran pemutar. |
requestSkip |
Meminta SDK untuk melewati iklan saat ini. |
requestStop |
Meminta SDK untuk menghentikan sesi iklan. |
handleSkipShown |
Memberi tahu IMA SDK bahwa materi iklan telah menampilkan UI lewati iklan. |
requestFocus |
Meminta fokus untuk iframe materi iklan. |
Meninjau pesan materi iklan yang tidak didukung ke pemutar
IMA SDK tidak menangani jenis CreativeMessage berikut:
requestChangeVolumerequestFullscreenrequestExitFullscreen
Memahami pesan pemain ke materi iklan
Tabel berikut mencantumkan pesan yang didukung IMA 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 IMA SDK melewati iklan. |
resize |
Memberi tahu materi iklan tentang perubahan dimensi pemutar atau video. |
appBackgrounded |
Memberi tahu materi iklan bahwa aplikasi telah masuk ke latar belakang. |
appForegrounded |
Memberi tahu materi iklan bahwa aplikasi telah kembali ke latar depan. |
fatalError |
Memberi tahu materi iklan tentang error di sisi pemutar. |
log |
Mengirim pesan log dari pemutar ke materi iklan. |
focusIn |
Memberi tahu bahwa materi iklan telah menerima fokus. |
Meninjau pembaruan status media
IMA SDK mengirim pesan mediaStateUpdate ke materi iklan untuk peristiwa berikut:
playpausestalled(buffering)seekingseekedendeddurationchangetimeupdate, secara berkala.volumechangetermasuk status nonaktif.