HTML5 向け Google Interactive Media Ads(IMA)SDK は、Secure Interactive Media Interface Definition(SIMID)バージョン 1.1 をサポートしています。このガイドでは、IMA SDK でサポートされている SIMID の特定の機能とメッセージについて説明します。
クリエイティブからプレーヤーへのメッセージを理解する
次の表に、SIMID クリエイティブが IMA SDK に送信できるメッセージを示します。
| メッセージ | 説明 |
|---|---|
clickThru |
クリエイティブが提供する URI に基づいて広告クリックを処理します。 |
fatalError |
広告セッションを終了し、クリエイティブから致命的なエラーを報告します。 |
getMediaState |
メディア プレーヤーの現在の状態(URI、currentTime、duration、volume、muted ステータスなど)を返します。 |
log |
デバッグ用にクリエイティブのログ メッセージを IMA SDK に転送します。 |
reportTracking |
クリエイティブに代わってトラッキング URL に ping を送信するよう IMA SDK にリクエストします。 |
requestChangeAdDuration |
広告セッションの合計再生時間を変更するリクエスト。 |
requestNavigation |
外部 URI へのナビゲーションをリクエストします。 |
requestPause |
IMA SDK がメディア プレーヤーを一時停止するようリクエストします。 |
requestPlay |
IMA SDK がメディア プレーヤーを再開または再生するようリクエストします。 |
requestResize |
動画プレーヤーのサイズ変更をリクエストします。プレーヤーでサイズ変更が許可されている場合、IMA SDK はプレーヤーのサイズを変更します。 |
requestSkip |
SDK に現在の広告をスキップするようリクエストします。 |
requestStop |
SDK に広告セッションの停止をリクエストします。 |
handleSkipShown |
クリエイティブに広告スキップ UI が表示されたことを IMA SDK に通知します。 |
requestFocus |
クリエイティブの iframe のフォーカスをリクエストします。 |
サポートされていないクリエイティブからプレーヤーへのメッセージを確認する
IMA SDK は、次の CreativeMessage タイプを処理しません。
requestChangeVolumerequestFullscreenrequestExitFullscreen
プレーヤーからクリエイティブ メッセージへの理解
次の表に、IMA SDK が SIMID クリエイティブに送信できるメッセージを示します。
| メッセージ | 説明 |
|---|---|
init |
セッションの設定時に、環境データと広告パラメータとともに送信されます。 |
startCreative |
クリエイティブに、クリエイティブの iframe を初期化して表示するよう通知します。 |
adStopped |
広告セッションが終了したことを通知します。理由コードも含まれます。 |
adSkipped |
ユーザーまたは IMA SDK が広告をスキップしたことをクリエイティブに通知します。 |
resize |
プレーヤーまたは動画のサイズ変更をクリエイティブに通知します。 |
appBackgrounded |
アプリケーションがバックグラウンドに移行したことをクリエイティブに通知します。 |
appForegrounded |
アプリがフォアグラウンドに戻ったことをクリエイティブに通知します。 |
fatalError |
プレーヤー側のエラーをクリエイティブに通知します。 |
log |
プレーヤーからクリエイティブにログ メッセージを送信します。 |
focusIn |
クリエイティブがフォーカスされたことを通知します。 |
メディアの状態の更新を確認する
IMA SDK は、次のイベントに対して mediaStateUpdate メッセージをクリエイティブに送信します。
playpausestalled(buffering - バッファリング中)seekingseekedendeddurationchangetimeupdate、定期的に。volumechange(ミュート ステータスを含む)。