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（ミュート ステータスを含む）。