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、ミュート ステータスなど、メディア プレーヤーの現在の状態を返します。 |
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（バッファリング）seekingseekedendeddurationchangetimeupdate（定期的）volumechange（ミュート ステータスを含む）