ストリーム アクティビティ モニター API を使用する

Dynamic Ad Insertion(DAI)の Stream Activity Monitor(SAM)API を使用すると、ライブ配信セッションとビデオ オンデマンド(VOD)セッションの診断ログと配信結果を取得できます。

このガイドでは、認証を構成する方法、最上位の DaiSession リソースを取得する方法、セッションのフィールドで識別されるリソースをリクエストする方法について説明します。

前提条件

SAM API を使用するには、次のものが必要です。

DaiSession リソースをリクエストする

DAI セッションを検査するには、DAI セッション ID または DAI ストリーム デバッグキーを使用して、HTTP GET リクエストを networks.daiSessions.get エンドポイントに送信します。

ID で DaiSession リソースを取得する

IMA DAI SDK、フルサービス DAI API、または連続広告配信 DAI API を使用してストリーム セッションを登録すると、Google DAI は DAI セッション ID を返します。

次の例では、セッション ID を使用して DaiSession リソースを取得します。

curl -X GET \
    "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/SESSION_ID" \
    -H "Authorization: Bearer OAUTH_TOKEN"

次のように置き換えます。

  • NETWORK_CODE: Google アド マネージャー ネットワークのコード
  • SESSION_ID: ストリーム セッションの作成時に返される DAI セッション ID
  • OAUTH_TOKEN: 実際の OAuth 2.0 アクセス トークン

DAI セッションにデバッグキーを使用する

ストリーム セッションを登録するときに、VOD リクエストを処理する Pod で dai-sam-id パラメータまたは sam_id パラメータを使用して、カスタム デバッグキーを割り当てることができます。このデバッグキーは、DaiSession リソースパスで直接渡すことができます。

次の例では、デバッグキーを使用して DaiSession リソースを取得しています。

curl -X GET \
    "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/DEBUG_KEY" \
    -H "Authorization: Bearer OAUTH_TOKEN"

DEBUG_KEY は、ストリーム作成リクエストで指定したカスタム デバッグキーに置き換えます。

どちらのリクエストも、セッション コンテキスト、広告の選択、決定された連続配信広告、ミッドロール挿入点、診断結果を含む DaiSession JSON レスポンスを返します。出力は次のようになります。

{
  "name": "networks/21775744923/daiSessions/9587e2c1-d745-4bf1-9f6a-e9092127cb48:ATL",
  "creationContext": {
    "streamCreateRequest": {
      "requestTime": "2026-10-16T19:59:57.365124Z",
      "latency": "0.045s",
      "url": "/ssai/event/c-rArva4ShKVIAkNfy6HUQ/streams",
      "userAgent": "Mozilla/5.0",
      "responseCode": 201
    },
    "linearInfo": {
      "liveStream": "networks/21775744923/liveStreams/20000016294786",
      "assetKey": "c-rArva4ShKVIAkNfy6HUQ",
      "prefetchEnabled": false,
      "podTrimmingEnabled": true,
      "podTrimTolerance": "2s",
      "eventStartTime": "2020-06-09T20:00:00Z",
      "eventEndTime": "2037-01-01T08:00:00Z"
    },
    "debugKey": "my-custom-debug-key-001",
    "contentTitle": "IMA sample HLS live stream",
    "stitchingType": "STITCHED",
    "reportingType": "CLIENT",
    "interstitialEnabled": false
  },
  "slate": {
    "idType": "CREATIVE_ID",
    "idValue": "138544327419",
    "adSystem": "GDFP",
    "duration": "10s"
  },
  "adSelections": {
    "2021043961286562353": {
      "type": "VAST",
      "adRequest": {
        "adRequestKey": "2021043961286562353",
        "adTag": "https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/vmap_ads_for_dai&cust_params=sample_ar%3Dstreammidonly&output=xml_vast4&pmxd=30000",
        "httpRequest": {
          "requestTime": "2026-10-16T19:59:57.177283526Z",
          "latency": "0.138s",
          "url": "https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/vmap_ads_for_dai&cust_params=sample_ar%3Dstreammidonly&output=xml_vast4&pmxd=30000",
          "responseCode": 200,
          "responseBody": "<VAST version=\"4.0\"><Ad id=\"5937252921\" sequence=\"1\"><InLine><AdSystem>GDFP</AdSystem><AdTitle>External - Pod Midroll 1</AdTitle><Creatives><Creative id=\"138383221557\" sequence=\"1\"><Linear><Duration>00:00:10</Duration></Linear></Creative></Creatives></InLine></Ad></VAST>"
        },
        "childRequests": []
      }
    }
  },
  "adPods": {
    "9204525715521575580": {
      "requestedBreakType": "MIDROLL",
      "adRequestKey": "2021043961286562353",
      "prefetchStage": "DISABLED",
      "adBreakId": "-3821178632466845617",
      "label": "3196133",
      "creatives": {
        "6086226973783046639": {
          "idType": "GOOGLE_VIDEO_REGISTRY_ID",
          "idValue": "tVFdo4-fFVE",
          "adSystem": "GDFP",
          "duration": "10.010s",
          "podSequence": 1,
          "adBuffet": false,
          "vastInfos": [
            {
              "adSystem": "GDFP",
              "adTitle": "External - Pod Midroll 1",
              "creativeId": "138383221557"
            }
          ]
        }
      }
    }
  },
  "adBreaks": {
    "-3821178632466845617": {
      "podKeys": [
        "9204525715521575580"
      ],
      "adBreakId": "-3821178632466845617",
      "breakType": "MIDROLL",
      "breakSequence": "3196133",
      "servedAdsDuration": "30.999999999s",
      "executedBreakDuration": "30.999999999s",
      "linear": {
        "breakStartTime": "2026-10-16T20:22:28.130329Z",
        "expectedBreakDuration": "31s",
        "slateDuration": "0s",
        "underlyingDuration": "0s"
      },
      "trackingPings": {
        "3641994172850159057": {
          "originalTrackingEventId": "google_4445276280058090123",
          "request": {
            "requestTime": "2026-10-16T20:22:29.393993Z",
            "latency": "0.030s",
            "url": "https://dai.google.com/view/p/service/linear/impression/stream/1dccd632-5028-45be-a68a-6c90645cd237:ATL/network/21775744923/event/xDte1UxoSxmtRrB6lqHdmg/media/7083951761/stream_ad_id/EfzeSEQzFPU",
            "responseCode": 200
          }
        }
      }
    }
  },
  "findings": [
    {
      "severity": "INFO",
      "description": "Minimum slate inserted into underfilled ad break.",
      "slateFinding": {
        "type": "SLATE_STATUS_MINIMUM_INSERTED"
      }
    },
    {
      "severity": "INFO",
      "description": "Ad break was decisioned, but not served during playback.",
      "adBreakFinding": {
        "type": "UNSERVED_BREAK",
        "breakKey": "-3821178632466845617"
      }
    }
  ],
  "sessionDuration": "31.453022s"
}

セッションを特定したら、DaiSession リソースの特定のセッション フィールドをクエリしたり、セッションの検出結果からエンティティ キーに移動したり、Ad Manager API で関連リソースにフォローアップ リクエストを送信したりできます。

フィールド マスクを使用してセッション フィールドをフィルタする

完全な DaiSession レスポンスには、未加工の VAST XML 本文と VMAP XML 本文、およびすべての過去のブレーク イベントが含まれます。ペイロード サイズを減らし、必要なセッション フィールドのみを取得するには、fields クエリ パラメータまたは X-Goog-FieldMask HTTP ヘッダーで読み取りマスクを渡します。詳細については、フィールド マスクをご覧ください。

セッションでエラーが発生したかどうかを確認するには、セッション作成コンテキストと診断結果のみをリクエストします。

curl -X GET \
    "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/SESSION_ID?fields=name,creationContext,findings" \
    -H "Authorization: Bearer OAUTH_TOKEN"

adSelections フィールドの未加工の XML 広告レスポンスをダウンロードせずに adBreaks フィールドと adPods フィールドのみを取得するには、X-Goog-FieldMask ヘッダーを使用します。

curl -X GET \
    "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/SESSION_ID" \
    -H "Authorization: Bearer OAUTH_TOKEN" \
    -H "X-Goog-FieldMask: name,adBreaks,adPods"

セッションの検出結果を検査する

findings リストの各エントリには、DaiSession リソース内の特定のエンティティを指すキーを持つ、型付きの検出結果オブジェクトが含まれています。次の表に、検出結果のキーをセッション フィールドに解決する方法を示します。

鍵パスの確認 DaiSession の対象地域
adBreakFinding.breakKey adBreaks[breakKey]
adRequestFinding.adSelectionKey、adRequestFinding.adRequestKey adSelections[adSelectionKey].adRequest とネストされた childRequests[]
creativeFinding.creativeKey adPods[podKey].creatives[creativeKey] のエントリ全体で creativeKey を照合する
podFinding.podKey adPods[podKey]
slateFinding slate
trackingFinding.trackingPingKey adBreaks[breakKey].trackingPings[trackingPingKey] のエントリ全体で trackingPingKey を照合する

コレクション間の関係をトレースする手順は次のとおりです。

  1. adBreaks 配列のエントリから開始します。
  2. podKeys リストを読み取り、adPods 配列内の対応するエントリを見つけます。
  3. Pod の adPod.adRequestKey フィールドを使用して、adSelections 配列内の一致する AdRequest.adRequestKey を見つけます。
  4. 一致する adRequest オブジェクトまたはネストされた childRequests 配列で、元の HTTP リクエストと VAST レスポンスを調べます。

ライブ配信とコンテンツ リソースをリクエストする

DaiSession リソースには、admanager.googleapis.com エンドポイントの Google Ad Manager API のライブ配信リソースとコンテンツ リソースにリンクするリソース名が含まれています。ストリーム構成とコンテンツ メタデータを確認するには、次のリソースに HTTP GET リクエストを送信します。

次の例では、creationContext.linearInfo.liveStream フィールドで参照されているリンクされた LiveStream リソースを取得します。

curl -X GET \
    "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreams/LIVE_STREAM_ID" \
    -H "Authorization: Bearer OAUTH_TOKEN"

LIVE_STREAM_ID は、DaiSession リソースのライブ配信 ID に置き換えます。

出力は次のようになります。

{
  "name": "networks/21775744923/liveStreams/20000016294786",
  "displayName": "IMA sample HLS live stream",
  "status": "ACTIVE",
  "createTime": "2020-06-09T20:00:07Z",
  "updateTime": "2026-08-18T15:37:05Z",
  "startTime": "2020-06-09T20:00:00Z",
  "endTime": "2037-01-01T08:00:00Z",
  "endTimeUnlimited": true,
  "contentUrls": [
    "https://contentsim.sandbox.google.com/content/590f95c5-c3ee-4a56-a10c-0cc660e91faa/linear/multivariant.m3u8"
  ],
  "adTags": [
    "https://pubads.g.doubleclick.net/gampad/live/ads?sz=640x480&output=xml_vast3&iu=/21775744923/external/vmap_ads_for_dai&env=vp&impl=s&gdfp_req=1&unviewed_position_start=1&ad_rule=0&cust_params=sample_ar%3Dstreammidonly&lseco=%%ASSET_KEY%%"
  ],
  "assetKey": "c-rArva4ShKVIAkNfy6HUQ",
  "slate": "networks/21775744923/slates/138544327419",
  "enableDaiAuthenticationKeys": false,
  "adBreakFillType": "SLATE",
  "underfillAdBreakFillType": "SLATE",
  "adHolidayDuration": "0s",
  "enableMaxFillerDuration": false,
  "enableDurationlessAdBreaks": false,
  "hlsSettings": {
    "playlistType": "LIVE",
    "masterPlaylistSettings": {
      "refreshType": "AUTOMATIC"
    }
  },
  "allowlistedIpsEnabled": false,
  "dynamicAdInsertionType": "LINEAR",
  "relativePlaylistDeliveryEnabled": false,
  "streamingFormat": "HLS",
  "prefetchEnabled": false,
  "forcedCueInEnabled": false,
  "shortSegmentDroppingEnabled": false,
  "adBreakMarkupTypesEnabled": false,
  "earlyBreakNotificationMultiBreakSchedulingEnabled": false,
  "dvrWindowDuration": "60s"
}