ダイナミック広告挿入(DAI)ストリーム アクティビティ モニター(SAM)API を使用すると、個々のライブ配信とビデオ オンデマンド(VOD)の視聴セッションを検査してトラブルシューティングできます。
個々のライブ配信または VOD 視聴セッションを視覚的に検査してトラブルシューティングするには、Google アド マネージャー UI のストリーム アクティビティ モニターを使用します。セッションの診断データをプログラムで取得するには、Ad Manager API の networks.daiSessions リソースを使用します。
ユースケースを把握する
SAM API を使用すると、ストリーム診断を自動化し、DAI 統合全体で広告配信の問題を解決できます。たとえば、次のような問題です。
- ストリーム セッションの作成を確認する: ライブ配信または VOD セッションの作成時に Google DAI が受信するパラメータ、
STITCHEDまたはPOD_SERVINGのスティッチ モード、レポートモード、コンテンツ メタデータを確認します。 - 広告リクエストとレスポンスを監査する: 送信される Video Ad Serving Template(VAST)と Video Multiple Ad Playlist(VMAP)の広告タグ、HTTP ステータス コード、レスポンス レイテンシ、未加工の XML レスポンス本文、ラッパー リダイレクト チェーンを検査します。
- 連続配信広告の決定とクリエイティブのトラブルシューティング: Google DAI が各連続配信広告で選択またはドロップした広告、連続配信広告内の各広告の再生時間、広告クリエイティブのソース広告システムを確認します。
- 広告プリフェッチの実行を追跡する: Google DAI が連続配信広告をプリフェッチするかどうかを判断し、各連続配信広告のプリフェッチ ステージを確認します。
- DAI ミッドロール挿入点 API と Pod Serving DAI API の呼び出しを検証する: 実際のブレークの実行、配信された広告の長さ、挿入されたスレートの長さを、DAI ミッドロール挿入点 API や Pod Serving DAI API などの API 呼び出しと照合します。
- 広告イベント トラッキングを確認する: クライアントサイドまたはサーバーサイドのトラッキング ping が成功したかどうかを確認し、広告サーバーからの HTTP レスポンスを調べます。
- セッションのモニタリングとアラートを自動化する:
INFO、WARNING、ERRORの重大度を持つ構造化された検出結果エントリを解析して、自動統合テストと本番環境モニタリング パイプラインで再生または収益化の問題を検出します。
最上位リソースについて
SAM API は、admanager.googleapis.com エンドポイントの Google アド マネージャー REST API(ベータ版)の一部であり、networks.daiSessions.get 読み取り専用メソッドを公開します。DAI セッション ID またはカスタム デバッグキーを使用して、DaiSession リソースをクエリできます。DAI は、再生後最大 3 日間セッション レコードを保持します。
SAM API は、Google アド マネージャー ネットワーク内のすべての DaiSession リソースの一覧表示をサポートしていません。
SAM で DAI ストリームのレスポンスを検査する
Google DAI がストリーム リクエストを処理する方法を確認するには、DaiSession レスポンスを調べます。
- フルサービス DAI API:
creationContext.streamCreateRequestフィールドを調べてストリーム登録呼び出しを確認し、adSelectionsマップとadPodsマップを調べて広告決定を確認し、adBreaksマップを調べて、挿入された広告、スレート クリエイティブ、基盤となるコンテンツの再生時間を確認します。 - Pod サービング DAI API:
creationContext.stitchingTypeフィールドがPOD_SERVING値に設定されていることを確認し、adPodsマップとadBreaksマップのadBreakIdフィールドを Pod マニフェストまたは Pod セグメントのリクエスト呼び出しと照合し、trackingPingsマップのサーバーサイド ビーコンまたはメディア検証ビーコンを調べます。 - DAI ミッドロール挿入点 API:
AdBreakオブジェクトのbreakSequence値をAdBreak.breakSequenceプロパティと照合します。
最初のリクエストを送信する
認証を設定して DAI セッション リソースを取得するには、ストリーム アクティビティ モニター API を使用するをご覧ください。