DAI Ad Break API সম্পর্কে জানুন

ডায়নামিক বিজ্ঞাপন যোগ করা (DAI) বিজ্ঞাপন বিরতি API আপনাকে লাইভস্ট্রিমে আসন্ন বিজ্ঞাপন বিরতির সময় ও বিজ্ঞাপন টার্গেটিং ডেটা তৈরি ও ম্যানেজ করতে দেয়।

DAI বিজ্ঞাপন বিরতি API-এর সাহায্যে আপনি নিম্নলিখিত কাজগুলি করতে পারবেন:

• পিক ট্রাফিকের সময় বিজ্ঞাপন ফিল রেট বাড়ানো: আপনার লাইভ ইভেন্টের জন্য সবচেয়ে বেশি উপার্জনকারী বিজ্ঞাপন বেছে নিতে DAI পরিষেবাগুলিকে আরও বেশি সময় দিন। আপনার লাইভ স্ট্রিম ইভেন্টে বেশি কনকারেন্সি, ডায়নামিক বিজ্ঞাপন ট্যাগ বা হাই-লেটেন্সি বিজ্ঞাপন থাকলে, আমরা DAI বিজ্ঞাপন বিরতি API ব্যবহার করার সাজেশন দিই।
• বিজ্ঞাপন বিরতির সম্পূর্ণ নিয়ন্ত্রণ নিন: আগে থেকেই বিজ্ঞাপন বিরতি তৈরি, আপডেট ও মুছে দিন। এটি ইন-মেনিফেস্ট বিজ্ঞাপন সিগন্যালিংয়ের চেয়ে বেশি নমনীয়তা প্রদান করে এবং পড পরিবেশনের ক্ষেত্রে তাত্ক্ষণিক সিদ্ধান্তের চেয়ে বেশি ফিল রেট দেয়।
• দর্শকদের বাধাহীন অভিজ্ঞতা প্রদান করা: সঠিক বিরতি সংক্রান্ত তথ্য প্রদান করে, বিজ্ঞাপন সম্পর্কিত প্লেব্যাক সংক্রান্ত সমস্যা যেমন, আংশিক বা সম্পূর্ণ বিজ্ঞাপন পড পূরণ না হওয়াকে কম করুন।

এই নির্দেশিকায় DAI বিজ্ঞাপন বিরতি API পদ্ধতি বর্ণনা করা হয়েছে এবং DAI সম্পূর্ণ পরিষেবা ও পড পরিবেশন ফ্লোয়ের জন্য বিজ্ঞাপন বিরতির লাইফসাইকেল সম্পর্কে বিস্তারিত বলা হয়েছে।

DAI বিজ্ঞাপন বিরতি API পদ্ধতি সম্পর্কে জানুন

API, AdBreak রিসোর্স ম্যানেজ করার জন্য নিম্নলিখিত স্ট্যান্ডার্ড পদ্ধতি প্রকাশ করে:

• Create: LiveStreamEvent এন্টিটির জন্য নতুন AdBreak এন্টিটি সংজ্ঞায়িত করে। ঐচ্ছিকভাবে, বিজ্ঞাপন বিরতি শুরু হওয়ার ৬০ সেকেন্ডের মধ্যে বিজ্ঞাপন সিদ্ধান্ত শুরু করার জন্য expectedStartTime প্রপার্টি সেট করুন।
• Get: বিজ্ঞাপন বিরতির অবস্থা ও সময় সংক্রান্ত মেটাডেটা সহ, নির্দিষ্ট AdBreak এন্টিটির বিবরণ পুনরুদ্ধার করে।
• List: কোনও নির্দিষ্ট LiveStreamEvent এন্টিটির জন্য API-এর মাধ্যমে আগে তৈরি করা AdBreak এন্টিটির একটি তালিকা রিটার্ন করে, যা উল্টো কালানুক্রমিক ক্রমে সাজানো থাকে। মনে রাখবেন, API শুধুমাত্র কন্টেন্ট স্ট্রিম ম্যানিফেস্টে সংজ্ঞায়িত বিজ্ঞাপন বিরতি রিটার্ন করে না।
• Update: বিজ্ঞাপন সম্পর্কিত সিদ্ধান্ত নেওয়া শুরু হওয়ার আগে আগে থেকে থাকা AdBreak এন্টিটি পরিবর্তন করে।
• Delete: আগে তৈরি করা AdBreak এনটিটির জন্য বিজ্ঞাপন সংক্রান্ত সিদ্ধান্ত বাতিল করে।

বিজ্ঞাপন বিরতির লাইফসাইকেল বোঝা

AdBreak এন্টিটির নিম্নলিখিত স্ট্যাটাস আছে:

• BREAK_STATE_UNSPECIFIED: ডিফল্ট অবস্থা।
• BREAK_STATE_SCHEDULED: বিজ্ঞাপন বিরতি সফলভাবে তৈরি করা হয়েছে এবং বিজ্ঞাপন সংক্রান্ত সিদ্ধান্তের জন্য শিডিউল করা হয়েছে।
• BREAK_STATE_DECISIONED: বিজ্ঞাপন বিরতির জন্য DAI পরিষেবা বিজ্ঞাপন বেছে নেওয়ার প্রক্রিয়া শুরু করেছে। আপনি বিজ্ঞাপন বিরতি পরিবর্তন করতে পারবেন না, তবে বিজ্ঞাপন সার্ভারের উপর সম্ভাব্য বিরূপ প্রভাব সহ বিজ্ঞাপন বিরতি বাতিল করতে পারবেন।

সতর্কতা: BREAK_STATE_DECISIONED অবস্থায় বিজ্ঞাপন বিরতি বাতিল করলে বিজ্ঞাপন সার্ভার বিজ্ঞাপন দেখাতে পারে না, এর ফলে বিজ্ঞাপন সার্ভারের বাজেট ও ফ্রিকোয়েন্সি ক্যাপ করার কার্যকারিতার উপর নেতিবাচক প্রভাব পড়ে।

• BREAK_STATE_COMPLETE: ব্যবহারকারীদের বিজ্ঞাপন বিরতি দেখানো হয়েছে।

নিচে দেওয়া ডায়াগ্রামে AdBreak এন্টিটির টাইমলাইন দেখানো হয়েছে, এটি তৈরি হওয়ার থেকে সম্পূর্ণ হওয়া পর্যন্ত।

বিজ্ঞাপন বিরতি শুরু হওয়ার সম্ভাব্য সময়ের ১ থেকে ৩০০ মিনিট আগে আপনি AdBreak এন্টিটি তৈরি করতে পারবেন।

• ব্রেকের সম্ভাব্য শুরুর সময়ের এক মিনিটের কম সময় আগে বিজ্ঞাপন বিরতি তৈরি করা এড়িয়ে চলুন, কারণ Google DAI-এর কাছে বিজ্ঞাপন সংক্রান্ত সিদ্ধান্ত নেওয়ার জন্য পর্যাপ্ত সময় নাও থাকতে পারে, এর ফলে বিজ্ঞাপন ফিল রেট কম হতে পারে।
• বিজ্ঞাপন বিরতির সম্ভাব্য শুরুর সময়ের ৬ ঘণ্টার বেশি আগে বিজ্ঞাপন বিরতি তৈরি করা এড়িয়ে চলুন, কারণ বিজ্ঞাপন সার্ভার অনুরোধ করা বিজ্ঞাপন বাতিল করে দিতে পারে।

মনে রাখবেন: লাইভ স্ট্রিম ইভেন্ট ডিঅ্যাক্টিভেট করলে, BREAK_STATE_SCHEDULED বা BREAK_STATE_DECISIONED স্ট্যাটাসে থাকা বিজ্ঞাপন বিরতি বাতিল হয়ে যায়।

নিম্নলিখিত বিভাগগুলি DAI ফুল সার্ভিস ও পড পরিবেশন ফ্লোতে বিজ্ঞাপন বিরতির স্টেট ট্রানজিশন কভার করে।

সম্পূর্ণ পরিষেবা DAI ফ্লো সম্পর্কে জানুন

Google Full-service DAI কন্টেন্ট ম্যানিফেস্ট ও বিজ্ঞাপন পড, দু'টিই ম্যানেজ করে।

কাস্টম বিজ্ঞাপন টার্গেটিংয়ের জন্য, কন্টেন্ট লাইভস্ট্রিম ম্যানিফেস্টে সংশ্লিষ্ট বিজ্ঞাপন মার্কারের আগে একটি AdBreak এন্টিটি তৈরি করতে DAI বিজ্ঞাপন বিরতি API ব্যবহার করুন।

• এই লিড টাইম Google DAI পরিষেবাকে বিজ্ঞাপন সংক্রান্ত সিদ্ধান্তের জন্য আপনার AdBreak ডেটা ব্যবহার করতে দেয়।
• Google DAI যখন ম্যানিফেস্ট বিজ্ঞাপন মার্কার শনাক্ত করে, তখন সিস্টেম AdBreak এন্টিটি ডেটা সহ ad decisions ব্যবহার করে এবং এন্টিটির স্টেট BREAK_STATE_COMPLETE-এ পরিবর্তন করে।

সতর্কতা: Google DAI, ম্যানিফেস্ট বিজ্ঞাপন মার্কার শনাক্ত করলে এবং AdBreak এনটিটি BREAK_STATE_SCHEDULED অবস্থায় থাকলে, সিস্টেমটি AdBreak ডেটা ব্যবহার করে না। বিজ্ঞাপন বিরতি বাতিল করার জন্য Delete মেথড কল না করা পর্যন্ত AdBreak এন্টিটি BREAK_STATE_SCHEDULED স্টেটে থাকে।

পড পরিবেশন করার ফ্লো বোঝা

এই ফ্লোতে, আপনি কন্টেন্ট লাইভস্ট্রিম ম্যানিফেস্ট ম্যানেজ করেন অথবা ম্যানিফেস্টে বিজ্ঞাপন মার্কার শনাক্ত করতে থার্ড-পার্টি ম্যানিফেস্ট ম্যানিপুলেশন পরিষেবা ব্যবহার করেন।

বিজ্ঞাপন বিরতির সম্ভাব্য শুরুর সময়ের আগে DAI বিজ্ঞাপন বিরতি API কল করে একটি AdBreak এন্টিটি তৈরি করুন। এটি আপনাকে বিজ্ঞাপন পড সেগমেন্ট বা বিজ্ঞাপন মেনিফেস্টের অনুরোধ করার আগে করতে হবে।

আপনার ভিডিও স্টিচার যখন ম্যানিফেস্ট বিজ্ঞাপন মার্কার শনাক্ত করে এবং বিজ্ঞাপন বিরতি আইডি সহ বিজ্ঞাপন সেগমেন্ট অনুরোধ করে, তখন Google DAI বিজ্ঞাপনের সিদ্ধান্ত নেওয়ার জন্য একই আইডি সহ AdBreak ডেটা ব্যবহার করে।

আপনার ক্লায়েন্ট বিজ্ঞাপন মিডিয়ার অনুরোধ করার পরে, API-এর মাধ্যমে আপনার তৈরি করা AdBreak এন্টিটি BREAK_STATE_COMPLETE স্টেটে পরিবর্তিত হয়।

আপনার প্রথম অনুরোধ করা

API অ্যাক্সেস সেট-আপ করতে এবং আপনার প্রথম অনুরোধ করতে, DAI বিজ্ঞাপন বিরতি API ব্যবহার করুন দেখুন।