বিজ্ঞাপন বিরতির প্যারামিটার ব্যবহার করা

Ad Break API আপনাকে বিজ্ঞাপন বিরতির প্যারামিটার ব্যবহার করে বিজ্ঞাপন ট্যাগ প্যারামিটার সেট করতে দেয়, যা বিজ্ঞাপন টার্গেটিংয়ের নির্ভুলতা এবং বিজ্ঞাপন সার্ভারের সাথে ইন্টিগ্রেশন বাড়ায়।

বিজ্ঞাপন ট্যাগ প্যারামিটার ওভাররাইড করা

Google DAI স্ট্রিমের বিজ্ঞাপন ট্যাগ প্যারামিটার ওভাররাইড করতে, বিজ্ঞাপন বিরতির breakParams.adTagParams ফিল্ড সেট করুন। আরও তথ্যের জন্য, আপনার স্ট্রিমে টার্গেটিং প্যারামিটার সাপ্লাই করুন এবং সমস্ত VAST বিজ্ঞাপন ট্যাগ প্যারামিটার দেখুন।

নিম্নলিখিত উদাহরণে DAI স্ট্রিমের বিজ্ঞাপন ট্যাগে mridx (মিড-রোল নম্বর) কোয়েরি প্যারামিটার দেখানো হয়েছে:

https://pubads.g.doubleclick.net/gampad/live/ads?mridx=3&...

নিচের উদাহরণে দেখানো অনুরোধ এমন একটি বিজ্ঞাপন বিরতি তৈরি করে যা mridx টার্গেটিং ভ্যালুকে ওভাররাইড করে:

curl -X POST "https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -d '{
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:00:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "breakParams": {
      "adTagParams": [
        {"key": "mridx", "value": "7"},
        {"key": "ptpln", "value": "podtemplate"},
        {"key": "cust_params", "value": "param1=value1&param2=value2"}
      ]
    }
  }'

নিম্নলিখিত বিষয়গুলি পরিবর্তন করুন:

DAI ম্যাক্রোর সাহায্যে বিজ্ঞাপন ট্যাগ বাড়ানো

Google DAI, %%DAI_PATTERN:MACRO_NAME%% ফর্ম্যাটে বিজ্ঞাপন ট্যাগ ম্যাক্রো কাজ করে। ম্যাক্রোর নাম অবশ্যই UPPER_CASE ফর্ম্যাটে হতে হবে, যাতে শুধুমাত্র বড় হাতের অক্ষর, সংখ্যা এবং আন্ডারস্কোর থাকে।

আপনার breakParams.macros ফিল্ডে ভ্যালু সহ ম্যাক্রো সেট করতে, আপনি Google DAI স্ট্রিমের বিজ্ঞাপন ট্যাগ বা DAI স্ট্রিম অনুরোধে এইসব ম্যাক্রো যোগ করতে পারবেন।

নিম্নলিখিত উদাহরণে Google DAI স্ট্রিমের বিজ্ঞাপন ট্যাগ দেখানো হয়েছে, যেখানে একটি BREAK_TYPE ম্যাক্রো আছে:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%DAI_PATTERN:BREAK_TYPE%%&...

নিম্নলিখিত অনুরোধটি একটি বিজ্ঞাপন বিরতি আপডেট করে এবং BREAK_TYPE ম্যাক্রো ভ্যালু সেট করে:

curl -X PATCH 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN' \
  -d '{
    "name": "networks/.../assets/.../adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:10:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "breakState": "BREAK_STATE_SCHEDULED",
    "breakParams": {
      "adTagParams": [
        {"key": "ptpln", "value": "podtemplate"},
        {"key": "cust_params", "value": "param1=value1&param2=value2"}
      ],
      "macros": [{"key": "BREAK_TYPE", "value": "national"}]
    }
  }'

আপনার বিজ্ঞাপন বিরতির আইডি দিয়ে AD_BREAK_ID পাল্টে দিন।

Google DAI নিম্নলিখিত উপায়ে ম্যাক্রো সহ বিজ্ঞাপন ট্যাগ সমাধান করে:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&...

SCTE-35 ম্যাক্রো সহ বিজ্ঞাপন ট্যাগ এক্সপ্যান্ড করা

আপনার Google DAI লাইভ স্ট্রিম ইভেন্ট সেট-আপ করার সময়, আপনি মাস্টার বিজ্ঞাপন ট্যাগে SCTE-35 ম্যাক্রো প্লেস করতে পারবেন।

লাইভ স্ট্রিম ইভেন্ট শুরু হলে, আপনি কন্টেন্ট ম্যানিফেস্টে SCTE-35 ডেটা যোগ করতে পারেন অথবা DAI বিজ্ঞাপন বিরতি API-কে SCTE-35 ডেটা সহ কল করতে পারেন, যা scte35CueOut প্যারামিটারে অন্তর্ভুক্ত থাকে। Google DAI, বিজ্ঞাপন ট্যাগে SCTE-35 ম্যাক্রো পূরণ করতে ডিকোড করা ডেটা ব্যবহার করে।

নিচে দেওয়া উদাহরণে %%TIME_SIGNAL_UPID_RAW%% ম্যাক্রো ব্যবহার করা হয়েছে:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%TIME_SIGNAL_UPID_RAW%%&...

SCTE-35 টাইমড সিগন্যাল ডেটা ব্যাখ্যা করার জন্য নিম্নলিখিত উদাহরণে JSON ব্যবহার করা হয়েছে:

{
  "splice_info_section": {
    ...
    "splice_command": {
      "command_name": "time_signal",
      "splice_time": {
        "time_specified_flag": 1,
        "pts_time": "123456789"
      }
    },
    "splice_descriptors": [
      {
        ...
        "segmentation_upid": {
          "raw_hex": "0x6E6174696F6E616C", // UTF8 value: national
          ...
        }
      }
    ]
  }
}

Google DAI, SCTE-35 ম্যাক্রো সহ বিজ্ঞাপন ট্যাগকে নিম্নলিখিতভাবে সমাধান করে:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&...