Stream Activity Monitor API の詳細

ダイナミック広告挿入(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 を使用するをご覧ください。