অ্যাড ব্রেক এপিআই আপনাকে অ্যাড ব্রেক প্যারামিটার ব্যবহার করে অ্যাড ট্যাগ প্যারামিটার সেট করতে দেয়, যা অ্যাড টার্গেটিং নির্ভুলতা এবং অ্যাড সার্ভারের সাথে ইন্টিগ্রেশন উন্নত করে।
বিজ্ঞাপন ট্যাগ প্যারামিটার ওভাররাইড করুন
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==",
"customParams": "param1=value1¶m2=value2",
"podTemplateName": "podtemplate",
"breakParams": {
"adTagParams": [{"key": "mridx", "value": "7"}]
}
}'
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
NETWORK_CODE: আপনার Google বিজ্ঞাপন ম্যানেজার নেটওয়ার্ক কোড। আরও তথ্যের জন্য, বিজ্ঞাপন ম্যানেজার নেটওয়ার্ক কোড দেখুন। -
ASSET_KEY: আপনার লাইভস্ট্রিম ইভেন্টের অ্যাসেট কী। আরও তথ্যের জন্য, লাইভ লিনিয়ার স্ট্রিম URL এবং অ্যাসেট কী সনাক্ত করুন দেখুন। -
OAUTH_TOKEN: আপনার অ্যাক্সেস টোকেন। আরও তথ্যের জন্য, OAuth2 দিয়ে প্রমাণীকরণ দেখুন।
DAI ম্যাক্রো ব্যবহার করে বিজ্ঞাপন ট্যাগ প্রসারিত করুন
Google DAI %%DAI_PATTERN:MACRO_NAME%% ফর্ম্যাটে বিজ্ঞাপন ট্যাগ ম্যাক্রো সমর্থন করে। ম্যাক্রোর নামটি UPPER_CASE ফর্ম্যাটে হতে হবে, যাতে কেবল বড় হাতের অক্ষর, সংখ্যা এবং আন্ডারস্কোর থাকবে।
আপনি এই ম্যাক্রোগুলি Google DAI স্ট্রিমের বিজ্ঞাপন ট্যাগে অথবা DAI স্ট্রিম অনুরোধে সন্নিবেশ করতে পারেন যাতে আপনার breakParams.macros ক্ষেত্রের মানগুলি সহ ম্যাক্রোগুলি সেট করা যায়।
নিম্নলিখিত উদাহরণে একটি 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==",
"customParams": "param1=value1¶m2=value2",
"podTemplateName": "podtemplate"
"breakState": "BREAK_STATE_SCHEDULED",
"breakParams": {
"macros": [{"key": "BREAK_TYPE", "value": "national"}]
}
}'
AD_BREAK_ID এর পরিবর্তে আপনার বিজ্ঞাপন বিরতি আইডি দিন।
গুগল ডিএআই ম্যাক্রো দিয়ে বিজ্ঞাপন ট্যাগটি নিম্নরূপ সমাধান করে:
https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…
SCTE-35 ম্যাক্রো ব্যবহার করে বিজ্ঞাপন ট্যাগ প্রসারিত করুন
আপনার Google DAI লাইভস্ট্রিম ইভেন্ট সেট আপ করার সময়, আপনি মাস্টার বিজ্ঞাপন ট্যাগে SCTE-35 ম্যাক্রো রাখতে পারেন।
লাইভস্ট্রিম ইভেন্ট শুরু হলে, আপনি কন্টেন্ট ম্যানিফেস্টে SCTE-35 ডেটা সন্নিবেশ করতে পারেন অথবা scte35CueOut প্যারামিটারে অন্তর্ভুক্ত SCTE-35 ডেটা ব্যবহার করে DAI অ্যাড ব্রেক API কল করতে পারেন। 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
…
}
}
]
}
}
গুগল ডিএআই SCTE-35 ম্যাক্রো দিয়ে বিজ্ঞাপন ট্যাগটি নিম্নরূপ সমাধান করে:
https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…