Dynamic Ad Insertion(DAI)の Stream Activity Monitor(SAM)API を使用すると、ライブ配信セッションとビデオ オンデマンド(VOD)セッションの診断ログと配信結果を取得できます。
このガイドでは、認証を構成する方法、最上位の DaiSession リソースを取得する方法、セッションのフィールドで識別されるリソースをリクエストする方法について説明します。
前提条件
SAM API を使用するには、次のものが必要です。
- Google Ad Manager API へのアクセス権。詳しくは、スタートガイドをご覧ください。
- 設定済みの DAI ライブ配信または VOD ストリーム。詳細については、DAI のライブ配信を設定するとビデオ オンデマンドのコンテンツ ソースを作成するをご覧ください。
- ストリーム作成リクエストの DAI セッション ID またはデバッグキー。詳しくは、DAI セッション ID またはデバッグキーを確認するをご覧ください。
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 セッション IDOAUTH_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 を照合する |
コレクション間の関係をトレースする手順は次のとおりです。
adBreaks配列のエントリから開始します。podKeysリストを読み取り、adPods配列内の対応するエントリを見つけます。- Pod の
adPod.adRequestKeyフィールドを使用して、adSelections配列内の一致するAdRequest.adRequestKeyを見つけます。 - 一致する
adRequestオブジェクトまたはネストされたchildRequests配列で、元の HTTP リクエストと VAST レスポンスを調べます。
ライブ配信とコンテンツ リソースをリクエストする
DaiSession リソースには、admanager.googleapis.com エンドポイントの Google Ad Manager API のライブ配信リソースとコンテンツ リソースにリンクするリソース名が含まれています。ストリーム構成とコンテンツ メタデータを確認するには、次のリソースに HTTP GET リクエストを送信します。
LiveStreamリソース:creationContext.linearInfo.liveStreamフィールドの値を使用して、networks.liveStreams.getメソッドを呼び出します。- VOD
Contentリソース:creationContext.vodInfo.contentフィールドの値を使用して、networks.content.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"
}