DAI 広告ブレーク API について

ダイナミック広告挿入(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 に移行します。

フルサービス DAI フローでの広告ブレーク エンティティの作成から完了まで。

Pod サービング フローについて

このフローでは、コンテンツ ライブストリーム マニフェストを管理するか、第三者のマニフェスト操作サービスを使用してマニフェスト内の広告マーカーを検出します。

広告ブレークの開始予定時刻の前に DAI 広告ブレーク API を呼び出して、広告ポッド セグメントまたは広告マニフェストをリクエストする必要があるタイミングよりも前に AdBreak エンティティを作成します。

動画スティッチャーがマニフェスト広告マーカーを検出し、広告ブレーク ID を使用して広告セグメント リクエストを行うと、Google DAI は同じ ID の AdBreak データを使用して広告の決定を行います。

クライアントが広告メディアをリクエストすると、API を介して作成した AdBreak エンティティが BREAK_STATE_COMPLETE 状態に移行します。

広告ブレーク エンティティの完了状態。

最初のリクエストを送信する

API アクセスを設定して最初のリクエストを行うには、DAI ミッドロール挿入点 API を使用するをご覧ください。