প্রারম্ভিক বিজ্ঞাপন বিরতি বিজ্ঞপ্তি API ব্যবহার করে
দ্রষ্টব্য: এই API এখনও বিটা মধ্যে আছে. আপনি যদি EABN প্রোগ্রামে অ্যাক্সেসের অনুরোধ করতে চান তাহলে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে কথা বলুন।
Early Ad Break Notification (EABN) API আপনাকে বিজ্ঞাপন বিরতি শুরুর আগে তার মেটাডেটা সহ আসন্ন বিজ্ঞাপন বিরতির বিষয়ে Google বিজ্ঞাপন পরিচালককে অবহিত করতে দেয়। আপনি বিজ্ঞাপন বিরতির এক ঘন্টা আগে একটি বিজ্ঞপ্তি অনুরোধ পাঠাতে পারেন। এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে EABN API সক্ষম ও ব্যবহার করতে হয় এবং অনুরোধ এবং প্রতিক্রিয়ার নমুনা।
সতর্কতা: EABN অনুরোধগুলি অপরিবর্তনীয়, তাই একবার বিরতি তৈরি হলে, এটি সংশোধন করা যাবে না। একই ইভেন্টের জন্য বিজ্ঞাপন বিরতি তৈরি করার পরবর্তী অনুরোধগুলি প্রত্যাখ্যান করা হয় যতক্ষণ না বিরতিটি ইভেন্টের ম্যানিফেস্টে উপস্থিত হয়৷
EABN API-তে করা কলগুলিতে নিম্নলিখিত তথ্য থাকতে হবে:
- সংশ্লিষ্ট লাইভ স্ট্রিমের শনাক্তকারী যেখানে বিজ্ঞাপন বিরতি তৈরি করা হচ্ছে। এই শনাক্তকারী নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
- লাইভ স্ট্রিমের "সম্পদ কী"।
- লাইভ স্ট্রিমের "কাস্টম অ্যাসেট কী", যা আপনাকে আপনার নিজস্ব শনাক্তকারী স্ট্রিং নির্দিষ্ট করে আপনার নিজস্ব কী স্পেস পরিচালনা করতে দেয়।
- লাইভ স্ট্রিমের "কন্টেন্ট সোর্স আইডি" এবং "কন্টেন্ট আইডি"।
দ্রষ্টব্য: এই শনাক্তকারীর ধরনটি ব্যবহার করতে আপনাকে অবশ্যই সক্রিয় থাকতে হবে। আরও তথ্যের জন্য, আপনার অ্যাকাউন্ট পরিচালকের সাথে যোগাযোগ করুন।
- পরবর্তী বিজ্ঞাপন বিরতির প্রত্যাশিত সময়কাল। সময়কাল যতটা সম্ভব প্রকৃত বিজ্ঞাপন বিরতির দৈর্ঘ্যের কাছাকাছি হওয়া প্রয়োজন।
এই প্রয়োজনীয় ক্ষেত্রগুলি ছাড়াও, আপনি কাস্টম টার্গেটিং প্যারামিটার, প্রয়োগ করার জন্য একটি বিজ্ঞাপন পড টেমপ্লেটের নাম বা SCTE35 কিউ আউট ডেটা পাঠাতে পারেন, যদি উপলব্ধ থাকে।
পূর্বশর্ত
EABN API ব্যবহার করার জন্য, আপনাকে অবশ্যই একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে হবে এবং অ্যাকাউন্টটি আপনার Google Ad Manager নেটওয়ার্কে যোগ করতে হবে।
একটি পরিষেবা অ্যাকাউন্ট তৈরি করা
EABN API কল করার জন্য একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন: - আপনার যদি একটি Google ক্লাউড অ্যাকাউন্ট থাকে তবে একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে IAM মডিউল ব্যবহার করুন৷ আরও তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট তৈরি এবং পরিচালনা দেখুন। - আপনার যদি একটি Google ক্লাউড অ্যাকাউন্ট না থাকে, তাহলে Google API কনসোল থেকে একটি তৈরি করতে নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:
- একটি নতুন প্রকল্প তৈরি করুন বা একটি বিদ্যমান প্রকল্প নির্বাচন করুন।
- শংসাপত্র পৃষ্ঠায়, পরিষেবা অ্যাকাউন্ট পরিচালনা করুন ক্লিক করুন।
- পরিষেবা অ্যাকাউন্ট পৃষ্ঠায়, পরিষেবা অ্যাকাউন্ট তৈরি করুন ক্লিক করুন।
- পরিষেবা অ্যাকাউন্ট তৈরি করুন পৃষ্ঠায়, অ্যাকাউন্টের বিবরণ লিখুন। তারপর, CREATE এ ক্লিক করুন।
একবার আপনি একটি পরিষেবা অ্যাকাউন্ট তৈরি করলে, অ্যাকাউন্টের JSON কীটি অনুলিপি করুন, যা প্রমাণীকরণের জন্য ব্যবহৃত হয়।
আপনার Google অ্যাড ম্যানেজার নেটওয়ার্কে আপনার পরিষেবা অ্যাকাউন্ট যোগ করা হচ্ছে
আপনার নেটওয়ার্কে আপনার পরিষেবা অ্যাকাউন্ট যোগ করতে, API অ্যাক্সেসের জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহারকারী যোগ করুন-এর ধাপগুলি সম্পূর্ণ করুন।
API সক্রিয় করা হচ্ছে
একবার আপনি পরিষেবা অ্যাকাউন্ট তৈরি করার পরে, আপনার অ্যাকাউন্টের জন্য API সক্ষম করতে আপনার অ্যাকাউন্ট পরিচালককে নিম্নলিখিত তথ্য সরবরাহ করুন:
- আপনার Google ক্লাউড অ্যাকাউন্টের ইমেল ঠিকানা
- আপনার পরিষেবা অ্যাকাউন্ট
- আপনার Google বিজ্ঞাপন ম্যানেজার নেটওয়ার্কের নেটওয়ার্ক কোড।
আপনার অ্যাকাউন্ট ম্যানেজার দ্বারা API সক্ষম করার পরে, API সক্ষম করতে নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:
- Google API লাইব্রেরিতে , "Google Ad Manager Video API" অনুসন্ধান করুন৷
- ENABLE এ ক্লিক করুন।
দ্রষ্টব্য: সার্চের ফলাফলে APIটি উপস্থিত না হলে, আপনার অ্যাকাউন্ট DAI API-এর জন্য সক্ষম করা হয়েছে তা নিশ্চিত করতে আপনার অ্যাকাউন্ট পরিচালকের সাথে যোগাযোগ করুন।
API ব্যবহার করে
আপনি JSON/REST অনুরোধ ব্যবহার করে EABN API কল করতে পারেন।
অনুমোদন
EABN API-এ অনুমোদিত কল করতে, আপনাকে আপনার পরিষেবা অ্যাকাউন্ট থেকে JSON কী ব্যবহার করে OAuth2 পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করতে হবে এবং https://www.googleapis.com/auth/video-ads
স্কোপ। আরও তথ্যের জন্য, সার্ভার থেকে সার্ভার অ্যাপ্লিকেশনের জন্য OAuth 2.0 ব্যবহার করা দেখুন।
আপনাকে অবশ্যই EABN API-তে প্রতিটি কলের জন্য একটি প্রমাণীকরণ শিরোনাম হিসাবে ফলস্বরূপ অনুমোদন টোকেন অন্তর্ভুক্ত করতে হবে।
একটি প্রাথমিক বিজ্ঞাপন বিরতি বিজ্ঞপ্তি পাঠানো হচ্ছে
একটি প্রাথমিক বিজ্ঞাপন বিরতির বিজ্ঞপ্তি পাঠাতে, আপনি কীভাবে লাইভ স্ট্রিম নির্দিষ্ট করতে পছন্দ করেন তার উপর নির্ভর করে তিনটি বৈধ EABN URL-এর একটিতে একটি POST অনুরোধ পাঠান। নিম্নলিখিত বিভাগগুলি URL-এর মধ্যে পার্থক্য ব্যাখ্যা করে এবং অনুরোধ এবং প্রতিক্রিয়া উদাহরণ প্রদান করে।
ইউআরএল
প্রাথমিক বিজ্ঞাপন বিরতির বিজ্ঞপ্তির জন্য তিনটি বৈধ URL আছে। আপনি একটি বিজ্ঞাপন বিরতি ( POST
) তৈরি করতে বা নির্ধারিত বিজ্ঞাপন বিরতির তালিকা পেতে ( GET
) তিনটি প্রকার ব্যবহার করতে পারেন৷
একটি লাইভ স্ট্রিমের সম্পদ কী ব্যবহার করতে, ব্যবহার করুন:
POST admanagervideo.googleapis.com/v1/networks/{network_code}/assets/{asset_key}/adBreaks
GET admanagervideo.googleapis.com/v1/networks/{network_code}/assets/{asset_key}/adBreaks
লাইভ স্ট্রিমের কাস্টম অ্যাসেট কী ব্যবহার করতে, ব্যবহার করুন:
POST admanagervideo.googleapis.com/v1/networks/{network_code}/customAssets/{custom_asset_key}/adBreaks
GET admanagervideo.googleapis.com/v1/networks/{network_code}/customAssets/{custom_asset_key}/adBreaks
কন্টেন্ট সোর্স আইডি এবং কন্টেন্ট আইডি পদ্ধতি ব্যবহার করতে, ব্যবহার করুন:
POST admanagervideo.googleapis.com/v1/networks/{network_code}/sources/{content_source_id}/content/{content_id}/adBreaks
GET admanagervideo.googleapis.com/v1/networks/{network_code}/sources/{content_source_id}/content/{content_id}/adBreaks
সমস্ত পরামিতি জন্য:
-
network_code
আপনার Google Ad Manager নেটওয়ার্কের নেটওয়ার্ক কোড উপস্থাপন করে। -
asset_key
আপনার লাইভ স্ট্রিম বিবরণ পৃষ্ঠায় দেখানো সম্পদ কী প্রতিনিধিত্ব করে। -
custom_asset_key
আপনার লাইভ স্ট্রিমের কাস্টম সম্পদ কী উপস্থাপন করে। -
content_source_id
Google Ad Manager-এ কন্টেন্ট সোর্সের আইডি উপস্থাপন করে। -
content_id
Google Ad Manager-এ কন্টেন্টের একটি অংশের আইডি উপস্থাপন করে।
দ্রষ্টব্য: নির্দিষ্ট content_source_id
/ content_id
জোড়া অবশ্যই Google Ad Manager-এ একটি লাইভ স্ট্রিমের সাথে যুক্ত হতে হবে।
রিকোয়েস্ট বডি - শুধুমাত্র একটি অ্যাড ব্রেক (পোস্ট) তৈরি করতে ব্যবহৃত হয়
অবজেক্ট | ||
---|---|---|
| প্রয়োজন | এই বিজ্ঞাপন বিরতির সময়কাল, Google-এর আদর্শ সময়কাল বিন্যাস ব্যবহার করে (xx.xxxs যেখানে xx.xxx সেকেন্ডের সংখ্যা) |
| ঐচ্ছিক | AM360-এ কাস্টম মানদণ্ড লক্ষ্য করার জন্য এই বিরতির জন্য বিজ্ঞাপনের অনুরোধে কী-মূল্যের জোড়াগুলি অন্তর্ভুক্ত করা হবে, দ্বারা পৃথক করা হয়েছে এবং যোগদান করেছে .
|
| ঐচ্ছিক | বিজ্ঞাপন পড টেমপ্লেট নাম |
| ঐচ্ছিক | scte35 থেকে বেস-64-এনকোড করা ডেটা কিউ আউট। অন্তর্ভুক্ত করতে পারেন বা আদেশ
|
উদাহরণ অনুরোধ
একটি বিজ্ঞাপন বিরতি তৈরি করুন
POST admanagervideo.googleapis.com/v1/networks/.../sources/.../content/.../adBreaks
Content-Type: application/json
Authorization: Bearer …
{
"expectedDuration": "30s",
"scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
"customParams": "param1=value1¶m2=value2",
"podTemplateName": "podtemplate"
}
প্রতিক্রিয়া শরীর
রেসপন্স বডিতে adBreak
অবজেক্টে পাঠানো সমস্ত প্যারামিটার থাকে, সেইসাথে একটি অতিরিক্ত name
ফিল্ড থাকে, যাতে তৈরি করা বিজ্ঞাপন বিরতির Google-ব্যাপী স্ট্যান্ডার্ড আইডি থাকে। এই ক্ষেত্রটি নিম্নলিখিত বিন্যাসে ফিরে এসেছে:
networks/{network_code}/assets/{asset_key}/adBreaks/{ad_break_id}
উদাহরণ প্রতিক্রিয়া
HTTP/1.1 200 OK
{
"name": "networks/.../assets/.../adBreaks/1",
"expectedDuration": "30s",
"scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
"customParams": "param1=value1¶m2=value2",
"podTemplateName": "podtemplate"
}
নির্ধারিত বিজ্ঞাপন বিরতি তালিকা
GET admanagervideo.googleapis.com/v1/networks/.../sources/.../content/.../adBreaks
Content-Type: application/json
Authorization: Bearer …
প্রতিক্রিয়া শরীর
প্রতিক্রিয়া বডিতে স্ট্রীমের জন্য নির্ধারিত প্রতিটি বিজ্ঞাপন বিরতির জন্য একটি অতিরিক্ত breakState
ফিল্ড সহ বিজ্ঞাপন বিরতি রয়েছে। breakState
ক্ষেত্র নিম্নলিখিত মান সমর্থন করে:
// Ad break decisioning has started.
BREAK_STATE_DECISIONED
// Break has started to be delivered to end users.
BREAK_STATE_COMPLETE
উদাহরণ প্রতিক্রিয়া
HTTP/1.1 200 OK
{
"name": "networks/.../assets/.../adBreaks/1",
"expectedDuration": "30s",
"breakState": "BREAK_STATE_COMPLETE"
}