テーマ
Google IMA モード
プレイヤーは通常 normal（標準の VAST 再生）で動きます。Google IMA SDK を使って再生したい場合は mode: "ima" を指定します。リワード・アウトストリームのどちらでも同じように使えます。
いつ使うか
- Google IMA を前提とした広告タグ・配信を使うとき
- IMA SDK のトラッキング／計測に揃えたいとき
通常の VAST 配信であれば normal のままで構いません。
使い方
mode: "ima" を渡すだけです。IMA SDK は自動で読み込まれるため、追加のスクリプト設置は不要です。
ts
createRewardPlayer({
target: "reward-slot",
bid, // vastUrl（タグ URL）または vastXml
mode: "ima",
});ts
createOutstreamPlayer({
target: "feed-slot",
bid,
mode: "ima",
});normal との違い
| normal | ima | |
|---|---|---|
| 再生 | 標準の VAST 再生 | Google IMA SDK |
| UI・デザイン | michao のテーマに沿った広告 UI | Google IMA 標準の UI |
| スキップ | プレイヤーが制御（skip ポリシー） | IMA がタグの skipoffset に従って独自のスキップボタンを表示 |
| 計測 | OMID（任意） | IMA SDK 自身の計測 |
スキップの扱い
ima モードでは IMA がスキップボタンを出すため、リワードでは「最後まで必須」を完全には強制できません。プレイヤーはそのスキップを受け入れ、policy.skip に従って扱います。最後まで視聴を必須にしたい場合は normal を使ってください。
IMA は Google アドサーバーの広告タグが必要
IMA は GAM の video 広告タグ URL を要求します。生の入札（VAST）をそのまま渡すだけでは動きません。Prebid.js での具体的な配線（buildVideoUrl でタグを生成して vastUrl に渡す方法）は Prebid.js 連携 を参照してください。
各オプションの詳細は API リファレンス を参照してください。