Stream Activity Monitor API ব্যবহার করুন

ডায়নামিক বিজ্ঞাপন যোগ করা (DAI) স্ট্রিম অ্যাক্টিভিটি মনিটর (SAM) API-এর সাহায্যে আপনি লাইভ স্ট্রিম ও চাহিদা অনুসার ভিডিও (VOD) সেশনের জন্য ডায়াগনস্টিক লগ ও ডেলিভারি ফলাফল পেতে পারবেন।

এই নির্দেশিকায় যাচাইকরণ কনফিগার করা, টপ-লেভেল রিসোর্স ফিরিয়ে আনা DaiSession এবং সেশনের ফিল্ডে শনাক্ত করা রিসোর্সের জন্য অনুরোধ করার পদ্ধতি সম্পর্কে বলা হয়েছে।

পূর্বশর্ত

SAM API ব্যবহার করতে, আপনার নিম্নলিখিতগুলি প্রয়োজন:

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টি মিল

বিভিন্ন কালেকশন জুড়ে সম্পর্ক ট্রেস করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. adBreaks অ্যারেতে একটি এন্ট্রি থেকে শুরু করুন।
  2. adPods অ্যারেতে সংশ্লিষ্ট এন্ট্রিগুলি খুঁজে পেতে podKeys তালিকাটি পড়ুন।
  3. adSelections অ্যারেতে ম্যাচিং AdRequest.adRequestKey খুঁজতে পডের adPod.adRequestKey ফিল্ড ব্যবহার করুন।
  4. ম্যাচিং 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"
}