Pod Serving API は、ユーザー向けの HLS または MPEG DASH メディア再生リストに直接合成できるように準備されたアダプティブ ビットレートの動画広告連続配信広告にアクセスできます。
この API は、上級レベルのパブリッシャーと動画技術パートナーを対象としています。 この API を大規模に使用するには、高度なメディア配信ワークフローの設計と実装が必要ですが、このドキュメントでは扱いません。
前提条件
DAI Podserving API でライブ配信を処理する前に、Google アド マネージャーの管理画面または live-event API でライブ ストリーム イベントを作成する必要があります。
コンポーネント
Pod Serving API の実装には、Google アド マネージャー、クライアントの動画プレーヤー、マニフェスト操作サーバーの 3 つのコンポーネントがあります。
アド マネージャー
アド マネージャーでは、ユーザーへの広告配信を行います。アド マネージャー SDK またはアド マネージャーの管理画面を通じて管理できます。このサービスには次の役割があります。
- クライアントの動画プレーヤーからストリーム リクエストを受け取り、広告を決定し、コンテンツ エンコード プロファイルに一致するレンディションを提供する
- クライアントの動画プレーヤーからの広告セグメント リクエストに応答し、指定されたユーザーに連続配信広告の適切な部分を提供する
- クライアントの動画プレーヤーからのトラッキング ping を受信して処理します。
クライアント動画プレーヤー
クライアント動画プレーヤーは、生成された動画ストリームの再生にクライアントが使用するアプリまたはウェブサイトです。プレーヤーには次のような責任があります。
- アド マネージャーからストリーム リソースを初期化し、特定のライブ配信イベントの単一の再生セッションを表すストリーム オブジェクトを受け取る。
- マニフェスト操作サーバーからストリーム マニフェストをリクエストして再生を開始する
- ストリームの広告セグメントに埋め込まれた広告イベントを記述する連続配信広告のメタデータをアド マネージャーから定期的にポーリングする
- 広告メディア ID を含む、プレーヤーによって生成された時間指定メタデータ イベントをリッスンする。プレーヤーはイベントが検出されるとアド マネージャーに転送し、広告イベントが正常に発生したかどうかを確認します。
クライアントの動画プレーヤーの適切な実装について詳しくは、お使いのプラットフォームの連続配信広告ガイドをご覧ください。
カスタム実装については、DAI API 用の Pod 配信クライアント ガイドをご覧ください。
マニフェスト操作サーバー
マニフェスト操作サーバーは、クライアントの動画プレーヤーに提供されるストリーム マニフェストをホストするサーバーです。サーバーには次の役割があります。
- クライアントの動画プレーヤーへのマニフェスト配信の処理
- アド マネージャーに期間テンプレートをリクエスト（MPEG DASH ストリームのみ）し、広告セグメントに入力する
- アド マネージャーでホストされる広告セグメントの URL を、広告ブレーク中に動画ストリーム マニフェスト（HLS の場合）または広告期間（MPEG DASH の場合）に挿入する。
- 変更されたマニフェストをクライアントの動画プレーヤーに配信する。
カスタム マニフェスト マニピュレータ サーバーの実装について詳しくは、マニフェスト操作ガイドをご覧ください。
用語集
- ライブストリーム イベント: エンコード プロファイルなど、ライブ ストリームの重要な構成データを保存するイベント。ライブ ストリーム イベントは、アド マネージャーを使用して作成します。
- ストリーム オブジェクト: 特定の動画アセットの単一の再生セッションを表すオブジェクト。注目すべきプロパティは、ストリーム ID やメディア検証 URL です。
- 連続配信広告: ミッドロール挿入点に表示される広告動画をグループ化します。
- 広告セグメント: 広告ブレーク用のメディア セグメント ファイル
- 連続配信広告のメタデータ: クライアントで広告 UI をレンダリングするために使用されるミッドロール挿入点のメタデータ（例: 広告中にシークボタンを非表示にする）
- 広告メディア ID: 広告セグメント ファイル内で ID3 タグとしてエンコードされたメタデータ。このメタデータは、再生中に特定の広告関連イベント（広告の開始やミッドポイントなど）が発生したタイミングを識別するために使用されます。