SIMID サポートを確認する

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 タイプを処理しません。

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

プレーヤーからクリエイティブ メッセージへの理解

次の表に、IMA SDK が SIMID クリエイティブに送信できるメッセージを示します。

メッセージ 説明
init セッションの設定時に、環境データと広告パラメータとともに送信されます。
startCreative クリエイティブに、クリエイティブの iframe を初期化して表示するよう通知します。
adStopped 広告セッションが終了したことを通知します。理由コードも含まれます。
adSkipped ユーザーまたは IMA SDK が広告をスキップしたことをクリエイティブに通知します。
resize プレーヤーまたは動画のサイズ変更をクリエイティブに通知します。
appBackgrounded アプリケーションがバックグラウンドに移行したことをクリエイティブに通知します。
appForegrounded アプリがフォアグラウンドに戻ったことをクリエイティブに通知します。
fatalError プレーヤー側のエラーをクリエイティブに通知します。
log プレーヤーからクリエイティブにログ メッセージを送信します。
focusIn クリエイティブがフォーカスされたことを通知します。

メディアの状態の更新を確認する

IMA SDK は、次のイベントに対して mediaStateUpdate メッセージをクリエイティブに送信します。

  • play
  • pause
  • stalled(buffering - バッファリング中)
  • seeking
  • seeked
  • ended
  • durationchange
  • timeupdate、定期的に。
  • volumechange(ミュート ステータスを含む)。