Google Dynamic Ad Insertion（DAI）SDK for HTML5 は、Secure Interactive Media Interface Definition（SIMID）バージョン 1.1 に対応しています。このガイドでは、DAI SDK がサポートする特定の SIMID 機能とメッセージについて説明します。
クリエイティブからプレーヤーへのメッセージについて
次の表に、SIMID クリエイティブから IMA DAI に送信できるメッセージを示します。
| メッセージ | 説明 |
|---|---|
clickThru |
DAI SDK は、DAI 広告タグで構成されたクリックスルー トラッキング URL に ping を送信します。クリエイティブが提供するカスタム URI やナビゲーション オプションは無視されます。 |
getMediaState |
currentTime、duration、volume、muted、paused、fullscreen プロパティなど、メディア プレーヤーの現在の状態を返します。DAI はサーバーサイドのステッチ ストリームを使用するため、currentSrc プロパティは常に null を返します。 |
log |
トラブルシューティングのために、クリエイティブのログ メッセージを DAI SDK デバッグ コンソール ログに転送します。 |
reportTracking |
クリエイティブのトラッキング URL に ping を送信するよう DAI SDK にリクエストします。 |
requestPause |
メディア プレーヤーを一時停止するよう DAI SDK にリクエストします。 |
requestPlay |
メディア プレーヤーで再生を再開するよう DAI SDK にリクエストします。 |
requestSkip |
現在の広告をスキップするよう DAI SDK にリクエストします。VOD ストリームでのみサポートされます。クリエイティブがライブ配信に対してこのメッセージを送信すると、リクエストは拒否されます。 |
サポートされていないクリエイティブからプレーヤーへのメッセージを確認する
DAI SDK は、次の CreativeMessage タイプを処理しません。
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: 常に拒否されます。プレーヤーは、クリエイティブがナビゲーションを処理することを想定しています。requestResize: 常に拒否されます。DAI SDK はクリエイティブのサイズ変更をサポートしていません。requestStop: 常に拒否されます。このタイプは、DAI がサポートしていない長時間再生のユースケースを対象としています。requestChangeVolume: DAI SDK はこのイベントを正常に解決しますが、クリエイティブの音量を変更しません。
プレーヤーからクリエイティブへのメッセージについて
次の表に、DAI SDK が SIMID クリエイティブに送信できるメッセージを示します。
| メッセージ | 説明 |
|---|---|
init |
セッションの設定時に、環境データと広告パラメータとともに送信されます。 |
startCreative |
クリエイティブに、クリエイティブ iframe を開始して表示するよう通知します。 |
adStopped |
広告セッションが終了したことを理由コードとともに通知します。 |
adSkipped |
ユーザーまたは DAI SDK が広告をスキップしたことをクリエイティブに通知します。VOD ストリームでのみサポートされます。 |
サポートされていないプレーヤーからクリエイティブへのメッセージを確認する
DAI SDK は、次のメッセージをクリエイティブに送信しません。
resizeappBackgroundedappForegroundedlog
メディアの状態の更新を確認する
DAI SDK は、次のイベントが発生すると、mediaStateUpdate メッセージをクリエイティブに送信します。
playpausestalled（バッファリング）seekingseekedtimeupdate（定期的）volumechange（ミュートのステータスを含む）
DAI SDK は次のイベントをサポートしていないため、イベントが発生してもメディアの状態の更新を送信しません。
endeddurationchangeerror