ダイナミック広告挿入（DAI）広告ブレーク API を使用すると、ライブ配信で予定されている広告ブレークのタイミングと広告ターゲティング データを作成、管理できます。
DAI 広告ブレーク API を使用すると、次のことができます。
- トラフィックのピーク時に広告の充足率を高める: ダイナミック広告挿入（DAI）サービスに、ライブイベントで最も収益性の高い広告を選択する時間を増やします。ライブ配信イベントで同時接続数が多い場合、動的広告タグを使用している場合、または遅延の大きい広告を使用している場合は、DAI 広告挿入点 API をおすすめします。
- 広告ブレークを完全に制御する: 広告ブレークを事前に作成、更新、削除することで、マニフェスト内の広告シグナリングよりも柔軟性が高まり、ジャストインタイムの意思決定よりもポッド サービングのフィルレートが高まります。
- 視聴者の視聴体験を中断させない: 正確なブレーク情報を指定することで、広告ポッドの不足や過剰などの広告関連の再生エラーを最小限に抑えることができます。
このガイドでは、DAI 広告ブレーク API メソッドについて説明し、DAI フルサービスとポッド サービング フローの広告ブレークのライフサイクルについて説明します。
DAI 広告ブレーク API メソッドについて
この API は、AdBreak リソースを管理するための次の標準メソッドを公開します。
Create:LiveStreamEventエンティティの新しいAdBreakエンティティを定義します。必要に応じて、expectedStartTimeプロパティを設定して、広告ブレークの開始 60 秒前に広告判定を開始するようにスケジュール設定します。Get: 広告挿入点の状態やタイミングのメタデータなど、特定のAdBreakエンティティの詳細を取得します。List: 指定されたLiveStreamEventエンティティに対して API で以前に作成されたAdBreakエンティティのリストを、逆時系列順に並べ替えて返します。API は、コンテンツ ストリーム マニフェストでのみ定義されているミッドロール挿入点を返しません。Update: 広告の判定が開始される前に、既存のAdBreakエンティティを変更します。Delete: 以前に作成されたAdBreakエンティティの広告判定をキャンセルします。
広告ブレークのライフサイクルについて
AdBreak エンティティには次の状態があります。
BREAK_STATE_UNSPECIFIED: デフォルトの状態。BREAK_STATE_SCHEDULED: 広告ブレークが正常に作成され、広告判定のスケジュールが設定されました。BREAK_STATE_DECISIONED: DAI サービスが広告ブレークの広告選択プロセスを開始しました。広告ブレークを変更することはできませんが、広告サーバーに悪影響を及ぼす可能性がある広告ブレークをキャンセルすることはできます。
BREAK_STATE_COMPLETE: 広告ブレークがユーザーに配信されました。
次の図は、AdBreak エンティティの作成から完了までのタイムラインを示しています。
広告ブレークの開始予定時刻の 1 ～ 300 分前に AdBreak エンティティを作成できます。
- Google DAI では広告の判定に十分な時間を確保できないため、広告ブレークの開始予定時刻の 1 分未満前に広告ブレークを作成することは避けてください。広告のフィルレートが低下する可能性があります。
- 広告サーバーでリクエストされた広告が無効になる可能性があるため、広告ブレークの開始予定時刻の 6 時間以上前に広告ブレークを作成しないでください。
以降のセクションでは、DAI フルサービスとポッド サービング フローでの広告ブレークの状態遷移について説明します。
フルサービス DAI のフローについて
Google フルサービス DAI は、コンテンツ マニフェストと広告ポッドの両方を管理します。
カスタム広告ターゲティングでは、DAI 広告ブレーク API を使用して、コンテンツ ライブ ストリーム マニフェスト内の対応する広告マーカーの前に AdBreak エンティティを作成します。
- このリードタイムにより、Google DAI サービスは広告の決定に
AdBreakデータを使用できます。 - Google DAI がマニフェスト広告マーカーを検出すると、システムは
AdBreakエンティティ データで広告の決定を使用し、エンティティの状態をBREAK_STATE_COMPLETEに移行します。
Pod サービング フローを理解する
このフローでは、コンテンツ ライブストリーム マニフェストを管理するか、サードパーティのマニフェスト操作サービスを使用してマニフェスト内の広告マーカーを検出します。
広告ブレークの開始予定時刻の前に DAI 広告ブレーク API を呼び出して、広告ポッド セグメントまたは広告マニフェストをリクエストする必要があるタイミングよりも前に AdBreak エンティティを作成します。
動画スティッチャーがマニフェスト広告マーカーを検出し、広告ブレーク ID を使用して広告セグメントのリクエストを行うと、Google DAI は同じ ID の AdBreak データを使用して広告を決定します。
クライアントが広告メディアをリクエストすると、API を介して作成した AdBreak エンティティが BREAK_STATE_COMPLETE 状態に移行します。
最初のリクエストを送信する
API アクセスを設定して最初のリクエストを行うには、DAI 広告ブレーク API を使用するをご覧ください。