VOD স্ট্রিমগুলির জন্য ডায়নামিক বিজ্ঞাপন সন্নিবেশ API

Google DAI API আপনাকে এমন পরিবেশে Google DAI-সক্ষম স্ট্রীম প্রয়োগ করতে দেয় যেখানে IMA SDK প্রয়োগ করা সমর্থিত নয়। আমরা সুপারিশ করি যে আপনি এখনও এমন প্ল্যাটফর্মগুলিতে IMA ব্যবহার করুন যেখানে IMA SDK সমর্থিত।

আমরা নিম্নলিখিত প্ল্যাটফর্মগুলিতে DAI API ব্যবহার করার পরামর্শ দিই:

  • স্যামসাং স্মার্ট টিভি (টিজেন)
  • এলজি টিভি
  • HbbTV
  • Xbox (জাভাস্ক্রিপ্ট অ্যাপ্লিকেশন)
  • KaiOS

API IMA DAI SDK দ্বারা প্রদত্ত মৌলিক বৈশিষ্ট্যগুলিকে সমর্থন করে৷ সামঞ্জস্য বা সমর্থিত বৈশিষ্ট্য সম্পর্কে নির্দিষ্ট প্রশ্নের জন্য, আপনার Google অ্যাকাউন্ট পরিচালকের সাথে যোগাযোগ করুন।

VOD স্ট্রীমের জন্য DAI API প্রয়োগ করুন

DAI API HLS এবং DASH উভয় প্রোটোকল ব্যবহার করে VOD স্ট্রিম সমর্থন করে। এই নির্দেশিকায় বর্ণিত পদক্ষেপগুলি উভয় প্রোটোকলের ক্ষেত্রেই প্রযোজ্য।

VOD স্ট্রিমগুলির জন্য আপনার অ্যাপ্লিকেশনে API একত্রিত করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

  1. স্ট্রীম এন্ডপয়েন্টে একটি POST কল করে একটি স্ট্রীমের অনুরোধ করুন:

    উদাহরণ অনুরোধের বডি:

    https://dai.google.com/ondemand/v1/dash/content/2559737/vid/tos-dash/stream

  {
    key1 : "value1",
    stream_parameter1 : "value2"
  }

    উদাহরণ প্রতিক্রিয়া বডি:

    {
   "stream_id":"d32f8920-612a-4d46-8bc7-d73fd6c17c85",
   "total_duration":636.458,
   "content_duration":596.458,
   "valid_for":"8h0m0s",
   "valid_until":"2020-06-04T20:39:41.274707306-07:00",
   "stream_manifest":"https://dai.google.com/ondemand/dash/content/2559737/vid/tos-dash/ATL/streams/d32f8920-612a-4d46-8bc7-d73fd6c17c85/manifest.mpd",
   "media_verification_url":"https://dai.google.com/view/p/service/vod/stream/d32f8920-612a-4d46-8bc7-d73fd6c17c85/loc/ATL/network/124319096/content/2559737/vid/tos-dash/media/",
   "ad_breaks":[
      {
         "type":"pre",
         "start":0,
         "duration":10,
         "ads":[
            {
               "seq":1,
               "duration":10,
               "title":"External NCA1C1L1 Preroll",
               "description":"External NCA1C1L1 Preroll ad",
               "clickthrough_url":"https://dai.google.com/ondemand/v1/dash/content/2474148/vid/bbb-clear/location/ATL/stream/d32f8920-612a-4d46-8bc7-d73fd6c17c85/videoclick/5489259204425938365",
               "events":[
                  {
                     "time":0.1,
                     "type":"start"
                  },
                  {
                     "time":2.5,
                     "type":"firstquartile"
                  },
                  {
                     "time":4.75,
                     "type":"midpoint"
                  },
                  {
                     "time":7.5,
                     "type":"thirdquartile"
                  },
                  {
                     "time":9,
                     "type":"complete"
                  }
               ]
            }
         ]
      },
      {
         "type":"mid",
         "start":45,
         "duration":10,
         "ads":[
            {.... }
               ]
            }
         ]
      },
      {
         "type":"post",
         "start":626.458,
         "duration":10,
         "ads":[...]
      }
   ]
}

    ত্রুটি প্রতিক্রিয়া

    ত্রুটির ক্ষেত্রে, স্ট্যান্ডার্ড HTTP ত্রুটি কোডগুলি JSON প্রতিক্রিয়া বডি ছাড়াই ফেরত দেওয়া হয়।

  2. JSON প্রতিক্রিয়া পার্স করুন এবং নিম্নলিখিত মানগুলি সংরক্ষণ করুন:

    • stream_id
    • stream_manifest
    • media_verification_url
    • ad_breaks

  3. মিডিয়া যাচাইকরণ করতে, ID3 ইভেন্টের জন্য শুনুন:

    1. মিডিয়া ইভেন্টগুলিকে একটি সারিতে সংরক্ষণ করুন, প্রতিটি মিডিয়া আইডি তার টাইমস্ট্যাম্প সহ সংরক্ষণ করুন (যদি প্লেয়ার দ্বারা প্রদর্শিত হয়)।
    2. প্লেয়ার থেকে প্রতিবার আপডেটের সময়, বা একটি সেট ফ্রিকোয়েন্সিতে (প্রস্তাবিত 500ms), প্লেহেডের সাথে ইভেন্ট টাইমস্ট্যাম্পের তুলনা করে সম্প্রতি প্লে হওয়া ইভেন্টগুলির জন্য মিডিয়া ইভেন্টের সারি দেখুন।
    3. মিডিয়া ইভেন্টগুলির জন্য যা আপনি নিশ্চিত করেছেন যে প্লেব্যাক হয়েছে, মিডিয়া যাচাইকরণের শেষ পয়েন্টে মিডিয়া আইডি যুক্ত করে এবং একটি GET অনুরোধ করে প্লেব্যাক ট্র্যাক করুন৷

    উদাহরণ অনুরোধের বডি:

    https://dai.google.com/view/p/service/linear/stream/c6bbee18-0d20-4c55-b071-efdf3a81da33:ATL/loc/ATL/network/51636543/event/0ndl1dJcRmKDUPxTRjvdog/media/

    উদাহরণ প্রতিক্রিয়া:

    Accepted for asynchronous verification - HTTP/1.1 202 Accepted
Successful empty response - HTTP/1.1 204 No Content
Media verification not found - HTTP/1.1 404 Not Found
Media verification sent by someone else - HTTP/1.1 409 Conflict

    আপনি স্ট্রিম অ্যাক্টিভিটি মনিটরে ট্র্যাকিং ইভেন্টগুলি যাচাই করতে পারেন৷

  4. ঐচ্ছিক: কি ধরনের ইভেন্ট চালানো হয়েছে তা দেখতে স্ট্রীম তৈরি প্রতিক্রিয়া থেকে ad_breaks ডেটা ব্যবহার করুন।

  5. সারি থেকে মিডিয়া ইভেন্ট সরান.

সীমাবদ্ধতা

ওয়েবভিউগুলির মধ্যে API ব্যবহার করলে, লক্ষ্য নির্ধারণের ক্ষেত্রে নিম্নলিখিত সীমাবদ্ধতাগুলি প্রযোজ্য:

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

সর্বোত্তম অনুশীলন

VOD-এ উপযুক্ত ইভেন্টের ধরনে ID3 ট্যাগ ম্যাপ করা ক্লান্তিকর। সরাসরি ইভেন্টটি দেখতে JSON-এ ফিরে আসা ad_breaks তথ্য ব্যবহার করুন, যেমন আপনি লাইভ কন্টেন্টের সাথে করেন।

অতিরিক্ত সম্পদ