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

Dynamic Ad Insertion(DAI)Ad Break API を使用すると、ライブ配信で予定されているミッドロール挿入点のタイミングと広告ターゲティング データを作成、管理できます。

DAI Ad Break API を使用すると、次のことができます。

  • トラフィックのピーク時の広告掲載率を向上させる: DAI サービスがライブイベントに最も収益性の高い広告を選択する時間を増やします。ライブ配信イベントの同時実行数が多い場合、ダイナミック広告タグを使用する場合、またはレイテンシの高い広告を使用する場合は、DAI ミッドロール挿入点 API を使用することをおすすめします。
  • ミッドロール挿入点を完全に制御する: ミッドロール挿入点を事前に作成、更新、削除することで、マニフェスト内の広告シグナリングよりも柔軟性が高まり、ジャストインタイムの決定と比較して連続配信広告の広告掲載率が向上します。
  • 途切れることのない視聴体験を提供する: 正確なブレーク情報を提供することで、連続配信広告の過不足など、広告関連の再生エラーを最小限に抑えます。

このガイドでは、DAI Ad Break 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: ミッドロール挿入点がユーザーに配信されました。
  • BREAK_STATE_EXPIRED: ミッドロール挿入点が配信前に期限切れになりました。ライブ配信イベントでマルチブレーク スケジュール設定を有効にした場合にのみ適用されます。詳しくは、ミッドロール広告ブレークの設定をご覧ください。デフォルトでは、ミッドロール挿入点は expectedStartTime フィールドの値から 30 分後に期限切れになります。expectedStartTime フィールドを設定しない場合は、決定の開始から 30 分後に期限切れになります。この期間は、expireDuration フィールドを使用してカスタマイズできます。

次の図は、AdBreak エンティティの作成から完了までのタイムラインを示しています。

作成から完了までのミッドロール挿入点エンティティ。

AdBreak エンティティは、ミッドロール挿入点の開始予定時刻の 1 ~ 300 分前に作成できます。

  • ミッドロール挿入点の開始予定時刻の 1 分前以降にミッドロール挿入点を作成しないでください。Google DAI で広告の決定に十分な時間を確保できず、広告の掲載率が低下する可能性があります。
  • 広告サーバーがリクエストされた広告を無効にする可能性があるため、ミッドロール挿入点の開始時刻の 6 時間以上前にミッドロール挿入点を作成しないでください。

以降のセクションでは、DAI フルサービスと連続配信広告のフローにおけるミッドロール挿入点の状態遷移について説明します。

フルサービス DAI のフローを理解する

Google フルサービス DAI は、コンテンツ マニフェストと連続配信広告の両方を管理します。

カスタム広告ターゲティングの場合は、DAI Ad Break API を使用して、コンテンツ ライブ配信マニフェストの対応する広告マーカーの前に AdBreak エンティティを作成します。

  • このリードタイムにより、Google DAI サービスは AdBreak データを使用して広告を決定できます。
  • Google DAI がマニフェスト広告マーカーを検出すると、システムは AdBreak エンティティ データを使用して広告決定を行い、エンティティの状態を BREAK_STATE_COMPLETE に移行します。

ライブ配信イベントでマルチブレーク スケジューリングを有効にすると、AdBreak エンティティに matchParams フィールドを設定できます。このプロセスにより、Google DAI は、検出されたマニフェスト広告マーカーを BREAK_STATE_SCHEDULED 状態または BREAK_STATE_DECISIONED 状態のミッドロール挿入点と照合できます。

フルサービス DAI フローにおける、作成から完了までのミッドロール挿入点エンティティ。

Pod のサービス提供フローを理解する

このフローでは、コンテンツのライブ配信マニフェストを管理するか、サードパーティのマニフェスト マニピュレータを使用して、マニフェスト内の広告マーカーを検出します。

ミッドロール挿入点の想定開始時刻より前に DAI Ad Break API を呼び出して、連続配信広告セグメントまたは広告マニフェストをリクエストする必要があるタイミングより前に AdBreak エンティティを作成します。

動画スティッチャーがマニフェスト広告マーカーを検出し、ミッドロール挿入点 ID を含む広告セグメント リクエストを送信すると、Google DAI は同じ ID の AdBreak データを使用して広告を決定します。

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

ミッドロール挿入点エンティティの完了状態。

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

API アクセスを設定して最初のリクエストを送信するには、DAI Ad Break API を使用するをご覧ください。