ডায়নামিক বিজ্ঞাপন যোগ করা (DAI) স্ট্রিম অ্যাক্টিভিটি মনিটর (SAM) API-এর সাহায্যে আপনি লাইভ স্ট্রিম ও চাহিদা অনুসার ভিডিও (VOD) সেশনের জন্য ডায়াগনস্টিক লগ ও ডেলিভারি ফলাফল পেতে পারবেন।
এই নির্দেশিকায় যাচাইকরণ কনফিগার করা, টপ-লেভেল রিসোর্স ফিরিয়ে আনা
DaiSession এবং সেশনের ফিল্ডে শনাক্ত করা রিসোর্সের জন্য অনুরোধ করার পদ্ধতি সম্পর্কে
বলা হয়েছে।
পূর্বশর্ত
SAM API ব্যবহার করতে, আপনার নিম্নলিখিতগুলি প্রয়োজন:
- Google Ad Manager API-তে অ্যাক্সেস। আরও তথ্যের জন্য, শুরু করা দেখুন।
- কনফিগার করা DAI লাইভ স্ট্রিম বা VOD স্ট্রিম। আরও তথ্যের জন্য, DAI-এর জন্য লাইভ স্ট্রিম সেট-আপ করুন এবং চাহিদা অনুসার ভিডিওর জন্য কন্টেন্ট সোর্স তৈরি করুন দেখুন।
- স্ট্রিম তৈরি করার অনুরোধ থেকে পাওয়া DAI সেশন আইডি বা ডিবাগ কী। বিস্তারিত জানতে, DAI সেশন আইডি বা ডিবাগ কী লোকেট করুন।
DaiSession রিসোর্সের জন্য অনুরোধ করুন
DAI সেশন পরীক্ষা করতে, DAI সেশন আইডি বা DAI স্ট্রিম ডিবাগ কী সহ
networks.daiSessions.get এন্ডপয়েন্টে HTTP GET অনুরোধ পাঠান।
আইডি দিয়ে DaiSession রিসোর্স ফিরিয়ে আনা
IMA DAI SDK, ফুল-সার্ভিস DAI API বা পড পরিবেশনকারী DAI API ব্যবহার করে আপনি কোনও স্ট্রিম সেশন রেজিস্টার করলে, Google DAI একটি DAI সেশন আইডি ফেরত পাঠায়।
নিম্নলিখিত উদাহরণ সেশন আইডি ব্যবহার করে 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: স্ট্রিম সেশন তৈরি করার সময় DAI সেশন আইডি রিটার্ন করা হয়েছেOAUTH_TOKEN: আপনার OAuth 2.0 অ্যাক্সেস টোকেন
DAI সেশনের জন্য ডিবাগ কী ব্যবহার করুন
আপনি স্ট্রিম সেশন রেজিস্টার করার সময়, Pod পরিবেশন VOD অনুরোধে 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 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অ্যারেতে একটি এন্ট্রি থেকে শুরু করুন।adPodsঅ্যারেতে সংশ্লিষ্ট এন্ট্রিগুলি খুঁজে পেতেpodKeysতালিকাটি পড়ুন।adSelectionsঅ্যারেতে ম্যাচিংAdRequest.adRequestKeyখুঁজতে পডেরadPod.adRequestKeyফিল্ড ব্যবহার করুন।- ম্যাচিং
adRequestঅবজেক্ট বা এর নেস্টেডchildRequestsঅ্যারেতে উৎপন্ন হওয়া HTTP অনুরোধ এবং VAST উত্তর পরীক্ষা করুন।
লাইভ স্ট্রিম ও কন্টেন্ট রিসোর্সের জন্য অনুরোধ করা
DaiSession রিসোর্সে রিসোর্সের নাম থাকে যা admanager.googleapis.com এন্ডপয়েন্টে Google Ad Manager API-তে
লাইভ স্ট্রিম এবং কন্টেন্ট
রিসোর্সের সাথে লিঙ্ক করে। স্ট্রিম কনফিগারেশন ও কন্টেন্ট মেটাডেটা যাচাই করতে, আপনি এইসব রিসোর্সে
HTTP GET অনুরোধ করতে পারেন:
LiveStreamরিসোর্স:networks.liveStreams.getপদ্ধতি কল করতেcreationContext.linearInfo.liveStreamফিল্ডের ভ্যালু ব্যবহার করুন।- VOD
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"
}