डाइनैमिक ऐड इंसर्शन (डीएआई) स्ट्रीम ऐक्टिविटी मॉनिटर (एसएएम) एपीआई की मदद से, लाइव स्ट्रीम और मांग पर वीडियो (वीओडी) सेशन के लिए, डाइग्नोस्टिक लॉग और डिलीवरी के नतीजे हासिल किए जा सकते हैं.
इस गाइड में, पुष्टि करने की सुविधा को कॉन्फ़िगर करने, टॉप-लेवल DaiSession संसाधन को वापस पाने, और सेशन के फ़ील्ड में पहचाने गए संसाधनों का अनुरोध करने का तरीका बताया गया है.
ज़रूरी शर्तें
SAM API का इस्तेमाल करने के लिए, आपके पास ये चीज़ें होनी चाहिए:
- Google Ad Manager API का ऐक्सेस. ज़्यादा जानकारी के लिए, शुरू करना लेख पढ़ें.
- कॉन्फ़िगर की गई डीएआई लाइव स्ट्रीम या वीओडी स्ट्रीम. ज़्यादा जानकारी के लिए, डीएआई के लिए लाइव स्ट्रीम सेट अप करना और मांग पर वीडियो के लिए कॉन्टेंट सोर्स बनाना लेख पढ़ें.
- स्ट्रीम बनाने के अनुरोध से मिला डीएआई सेशन आईडी या डीबग कुंजी. ज़्यादा जानकारी के लिए, डीएआई सेशन आईडी या डीबग कुंजी का पता लगाना देखें.
DaiSession के संसाधन का अनुरोध करना
किसी डीएआई सेशन की जांच करने के लिए, डीएआई सेशन आईडी या डीएआई स्ट्रीम डीबग कुंजी के साथ networks.daiSessions.get एंडपॉइंट पर एचटीटीपी GET अनुरोध भेजें.
आईडी की मदद से, DaiSession संसाधन को वापस पाना
आईएमए डीएआई एसडीके, फ़ुल-सर्विस डीएआई एपीआई या पॉड सर्विंग डीएआई एपीआई का इस्तेमाल करके स्ट्रीम सेशन रजिस्टर करने पर, Google डीएआई एक डीएआई सेशन आईडी दिखाता है.
यहां दिए गए उदाहरण में, सेशन आईडी का इस्तेमाल करके DaiSession संसाधन को वापस लाया गया है:
curl -X GET \
"https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/SESSION_ID" \
-H "Authorization: Bearer OAUTH_TOKEN"
इनकी जगह ये डालें:
NETWORK_CODE: आपका Google Ad Manager नेटवर्क कोडSESSION_ID: स्ट्रीम सेशन बनाते समय, डीएआई सेशन आईडी दिखाया जाता हैOAUTH_TOKEN: आपका OAuth 2.0 ऐक्सेस टोकन
डी॰ए॰आई॰ सेशन के लिए डीबग कुंजी का इस्तेमाल करना
स्ट्रीम सेशन को रजिस्टर करते समय, कस्टम डीबग कुंजी असाइन की जा सकती है. इसके लिए, वीओडी अनुरोधों को पॉड के ज़रिए दिखाने के लिए, 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 और VMAP एक्सएमएल बॉडी और ब्रेक से जुड़े सभी पुराने इवेंट शामिल होते हैं. पेलोड का साइज़ कम करने और सिर्फ़ ज़रूरी सेशन फ़ील्ड फ़ेच करने के लिए, fields क्वेरी पैरामीटर या X-Goog-FieldMask एचटीटीपी हेडर में रीड मास्क पास करें. ज़्यादा जानकारी के लिए, फ़ील्ड मास्क देखें.
यह देखने के लिए कि किसी सेशन में गड़बड़ियां हुई हैं या नहीं, सिर्फ़ सेशन बनाने के कॉन्टेक्स्ट और डाइग्नोस्टिक्स के नतीजों का अनुरोध करें:
curl -X GET \
"https://admanager.googleapis.com/v1/networks/NETWORK_CODE/daiSessions/SESSION_ID?fields=name,creationContext,findings" \
-H "Authorization: Bearer OAUTH_TOKEN"
adSelections फ़ील्ड में रॉ एक्सएमएल विज्ञापन रिस्पॉन्स डाउनलोड किए बिना, सिर्फ़ 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कलेक्शन में मौजूद किसी एंट्री से शुरू करें.adPodsकलेक्शन में मौजूद एंट्री ढूंढने के लिए,podKeysसूची पढ़ें.adSelectionsकलेक्शन में मैच होने वालेAdRequest.adRequestKeyको ढूंढने के लिए, पॉड पर मौजूदadPod.adRequestKeyफ़ील्ड का इस्तेमाल करें.- मैच होने वाले
adRequestऑब्जेक्ट या उसके नेस्ट किए गएchildRequestsकलेक्शन में, एचटीटीपी अनुरोध और VAST रिस्पॉन्स की जांच करें.
लाइव स्ट्रीम और कॉन्टेंट के संसाधनों का अनुरोध करना
DaiSession रिसॉर्स में ऐसे रिसॉर्स के नाम होते हैं जो admanager.googleapis.com एंडपॉइंट पर, Google Ad Manager API में लाइव स्ट्रीम और कॉन्टेंट रिसॉर्स से लिंक होते हैं. स्ट्रीम के कॉन्फ़िगरेशन और कॉन्टेंट के मेटाडेटा की पुष्टि करने के लिए, इन रिसॉर्स पर एचटीटीपी GET अनुरोध किए जा सकते हैं:
LiveStreamरिसॉर्स:networks.liveStreams.getतरीके को कॉल करने के लिए,creationContext.linearInfo.liveStreamफ़ील्ड की वैल्यू का इस्तेमाल करें.- वीओडी
Contentसंसाधन:networks.content.getतरीके को कॉल करने के लिए,creationContext.vodInfo.contentफ़ील्ड की वैल्यू का इस्तेमाल करें.
यहां दिए गए उदाहरण में, 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 संसाधन में मौजूद लाइव स्ट्रीम आईडी से बदलें.
आउटपुट कुछ ऐसा दिखता है:
{
"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"
}