ダイナミック広告挿入(DAI)用のプレーヤーとアプリ開発の計画と管理に、以下をご利用ください。
以下のリンクから各セクションをご確認いただけます。
DAI プラットフォームのサポート
動画プレーヤーのコントロールのサポート
デフォルト広告タグをオーバーライドする
ストリーム バリエーション パラメータをオーバーライドする
よくある質問
DAI プレーヤーの実装タイプの比較をご覧ください。
プラットフォームのサポート
ダイナミック広告挿入のサポートは、サポート対象外のプラットフォームも含め、次のとおりです。クリックするとサンプルアプリと各プラットフォームの詳しい情報を確認できます。
基本のサンプルアプリでは動画のトラッキング イベントのみ表示されます。プレロールのみ使用するサイト運営者に最適です。
高度なサンプルアプリではアプリのすべての基本機能に加え、ブックマーク、スナップバック、字幕、スクラブ、カウントダウン タイマー機能も表示されます。長編コンテンツを収益化するサイト運営者に最適です。
プラットフォーム | SSB サポート | DAI 対応 IMA SDK | サンプルアプリ | その他の情報 |
---|---|---|---|---|
iOS | あり | iOS IMA SDK | iOS サンプルアプリ | iOS クイックスタート ガイド iOS リファレンス |
Android または FireTV |
あり | Android IMA SDK | Android サンプルアプリ | Android クイックスタート ガイド Android リファレンス |
tvOS (Apple TV) |
あり | tvOS IMA SDK | tvOS サンプルアプリ | tvOS クイックスタート ガイド tvOS リファレンス |
Roku | あり | 実行中に SDK をダウンロード |
Roku サンプルアプリ | Roku クイックスタート ガイド |
Chromecast | あり | 実行中に SDK をダウンロード |
サンプル レシーバー アプリ |
Chromecast クイックスタート ガイド |
HTML5 | あり | 実行中に SDK をダウンロード |
HTML5 サンプルアプリ DAI デモ HTML5 プレーヤー |
HTML5 クイックスタート ガイド |
動画プレーヤーのコントロールのサポート
動画プレーヤーのコントロールは IMA SDK を有効にしている場合のみサポートされます。すべての高度なサンプルアプリで、さまざまなサポート対象プラットフォームの機能が表示されます。キューポイント情報機能は、基本のサンプルアプリでも利用できます。
-
合計広告数のカウントダウンと広告ごとのカウントダウン: 合計広告数の残り時間を示すカウントダウンを追加する機能です。
iOS と Android: IMA SDK でこのオプション機能を利用できます。
Roku と tvOS: IMA SDK の高度なサンプルアプリにこの機能のサンプルがあります。この機能が必要な場合は、カスタムコードを含めてください。
-
字幕: コンテンツ ストリーム内に字幕を追加する機能です。サポートされている字幕プログラムは次のとおりです。
Timed Text Markup Language(TTML)(サイドカー): TTML は、現在字幕機能で使用されている古い配信コンテンツ形式内のタイムコード付きテキスト情報をコード変換したり交換したりするために使用されています。
WebVTT(サイドカー): WebVTT ファイルは動画コンテンツ用の字幕、テキストによる動画の説明、コンテンツ ナビゲーション、音声コンテンツや動画コンテンツとタイミングを合わせたあらゆるメタデータを表示します。
- ブックマーク: ブックマークは、コンテンツ ストリームのあるポイントを保存し、後でそこから再生する機能です。たとえば、ユーザーが 5 分間のコンテンツを見ているとします。動画ストリーム中に視聴を中断して、後で中断したところから再生を再開できます。ブックマークはユーザーが見ていた場所を保存するので、中断したところに戻ってスムーズに視聴を続けられます。
- スナップバック: スナップバックは、ユーザーがシークして通り過ぎた広告ブレークの開始時点に戻って、その広告ブレークの再生が完了した後にシーク位置まで移動する機能です。
- スクラブ: 通常、長編のコンテンツで、ユーザーがコンテンツバーをスクロールしているときにコンテンツの最初のフレームを表示する機能です。
デフォルト広告タグをオーバーライドする
DAI の VOD 向けコンテンツ ソースやライブリニア ストリームをアド マネージャーで定義する際は、デフォルトの動画広告タグを指定する必要があります。
動画プレーヤーがストリームをリクエストすると、この広告タグが UI で指定したとおりに使用されます。ただし、ストリーム リクエストでこのタグのパラメータをオーバーライドすることもできます。
ストリームにターゲティング パラメータを指定する方法についてご確認ください。
ストリーム バリエーション パラメータをオーバーライドする
デフォルトの HLS 再生リストの順序はサイト運営者が指定します。
バリエーションの選択と順序のパラメータのオーバーライドは、ストリームの作成中に指定できます。オーバーライドによって、マスター再生リストのリクエストへのレスポンスに含めるバリエーションのサブセットと再生リストの順序を指定できます。バリエーションのサブセットと順序は、明示的なオーバーライドがない限り、ストリームのライフサイクル中はそのままになります。
詳しくは、ストリームのバリエーション パラメータをオーバーライドする方法をご確認ください。
よくある質問
VOD ストリームでは、プレロール広告を表示するかどうかを広告ルールで設定できます。
ライブリニア ストリームでは、プレロール広告を表示するようにアド マネージャーを設定できます。または、アド マネージャー DAI ライブ ストリームをリクエストする前に、動画プレーヤーでクライアントサイドのアド マネージャー広告リクエストを行って、プレロールをユーザーに表示できます。
広告なしの時間枠を設定する
ライブリニア ストリームでは、「広告なしの時間枠」機能を使用して、プレロール広告を表示した直後に別の DAI 広告を表示しないように設定できます。
広告なしの時間枠を設定するには、次の 2 つの作業を行います。
- DAI のライブ ストリームを設定するときに [広告なしの時間枠] を指定します。
- ストリーム作成リクエストの
adtagparameters
配列で、dai-ah
パラメータを1
に設定して渡します。これは、アド マネージャー広告タグのパラメータをオーバーライドするときと、ストリーム バリエーション パラメータを設定するときに使用する配列と同じです。
ビデオ オンデマンド コンテンツ用の CDN 設定を作成する際に、デフォルトの CDN 設定と追加の CDN 配信設定を定義することができます。複数の CDN を設定しておけば、セッションの開始時に Key-Value を使って、どの CDN から配信するかを動的に選択することが可能です。
CDN 設定を指定して保存すると、アド マネージャーでそれぞれに名前が割り当てられます。この名前を dai-dlid
パラメータの値として、ストリーム作成リクエストで渡します。*
SSB の場合、このパラメータは dai-dlid=AaBbC1aaBa0obA1BABaaBA
として渡されます(「AaBbC1aaBa0obA1BABaaBA
」はアド マネージャーで表示される名前です)。
IMA SDK を使用している場合は、広告タグのパラメータを使ってストリーム作成リクエストでこの名前を渡します。
* リクエストに名前が渡されなかった場合、アド マネージャーではデフォルトの CDN が使用されます。
ingestUrl
です。ライブ リニア ストリームの場合は、エンコーダーからのストリーム用 URL です。詳しくは、DAI 代替ストリームに関するおすすめの方法をご確認ください。