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

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

DAI অ্যাড ব্রেক API-এর মাধ্যমে আপনি নিম্নলিখিত কাজগুলি করতে পারবেন:

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

এই নির্দেশিকা DAI অ্যাড ব্রেক API পদ্ধতি বর্ণনা করে এবং DAI সম্পূর্ণ পরিষেবা এবং পড পরিবেশন ফ্লোর জন্য অ্যাড ব্রেক লাইফসাইকেলের মাধ্যমে আপনাকে গাইড করে।

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

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

  • 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_COMPLETE: ব্যবহারকারীদের বিজ্ঞাপন বিরতি দেখানো হয়েছে।
  • BREAK_STATE_EXPIRED: বিজ্ঞাপন বিরতির মেয়াদ শেষ হয়ে গেছে। লাইভস্ট্রিম ইভেন্টে মাল্টি-ব্রেক শিডিউলিং চালু করলে তবেই এটি প্রযোজ্য হয়। বিস্তারিত জানতে, মিড-রোল বিজ্ঞাপন বিরতি সেটিংস দেখুন। সাধারণত, expectedStartTime ফিল্ডের ভ্যালুর ৩০ মিনিট পরে অথবা আপনি expectedStartTime ফিল্ড সেট না করলে, সিদ্ধান্ত নেওয়া শুরু হওয়ার ৩০ মিনিট পরে অ্যাড ব্রেকের মেয়াদ শেষ হয়ে যায়। আপনি expireDuration ফিল্ড ব্যবহার করে এই সময়সীমা কাস্টমাইজ করতে পারবেন।

নিম্নলিখিত ডায়াগ্রামটি AdBreak এন্টিটির টাইমলাইন দেখায়, তৈরি করা থেকে শেষ হওয়া পর্যন্ত।

বিজ্ঞাপন বিরতি এন্টিটি তৈরি থেকে সম্পূর্ণ হওয়া পর্যন্ত।

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

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

নিম্নলিখিত বিভাগে DAI সম্পূর্ণ পরিষেবা এবং পড পরিবেশন ফ্লোতে বিজ্ঞাপন বিরতির স্টেট ট্রানজিশন কভার করা হয়েছে।

সম্পূর্ণ-পরিষেবা DAI ফ্লো সম্পর্কে বোঝা

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

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

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

লাইভ স্ট্রিম ইভেন্টে মাল্টি-ব্রেক শিডিউলিং চালু করলে, আপনি AdBreak এন্টিটিতে matchParams ফিল্ড সেট করতে পারবেন। এই প্রসেসের মাধ্যমে Google DAI, BREAK_STATE_SCHEDULED বা BREAK_STATE_DECISIONED স্ট্যাটাসে থাকা বিজ্ঞাপন বিরতির সাথে শনাক্ত করা ম্যানিফেস্ট বিজ্ঞাপন মার্কার ম্যাচ করতে পারে।

ফুল-সার্ভিস DAI ফ্লোতে তৈরি করা থেকে সম্পূর্ণ হওয়া পর্যন্ত বিজ্ঞাপন বিরতি এন্টিটি।

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

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

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

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

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

বিজ্ঞাপন বিরতি এন্টিটি সম্পূর্ণ হওয়ার স্ট্যাটাস।

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

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