লাইভস্ট্রিমের জন্য SGAI দিয়ে শুরু করুন

সার্ভার গাইডেড অ্যাড ইনসারশন (SGAI) ক্লায়েন্ট ডিভাইসে স্টিচিং করার জন্য প্রস্তুত একটি অ্যাড পড ম্যানিফেস্ট প্রদান করে। আপনি যদি আপনার Google Ad Manager নেটওয়ার্কে Pod Serving DAI সক্রিয় করে থাকেন, তাহলে আপনি SGAI ব্যবহার করার সুযোগ পাবেন। যদি আপনার Pod Serving DAI সক্রিয় করা না থাকে, তাহলে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

SGAI-এর মাধ্যমে, আপনি বিজ্ঞাপনের মেটাডেটা এবং বিজ্ঞাপন পড ম্যানিফেস্টগুলো পুনরুদ্ধার করে একটি স্ট্রিম তৈরি করার জন্য পড সার্ভিং এপিআই এন্ডপয়েন্টগুলো ব্যবহার করেন।

আপনার যদি একটি ম্যানিফেস্ট ম্যানিপুলেশন সার্ভার থাকে, তবে আপনি আপনার পছন্দসই স্পেসিফিকেশন অনুযায়ী অ্যাড পড ম্যানিফেস্ট ইউআরএল তৈরি করতে এবং আপনার কন্টেন্ট স্ট্রিমে অ্যাড পড ম্যানিফেস্ট তথ্য বহনকারী অ্যাড মার্কার সন্নিবেশ করতে পারেন।

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

পূর্বশর্ত

এগিয়ে যাওয়ার আগে, নিশ্চিত করুন যে আপনার কাছে নিম্নলিখিত জিনিসগুলি আছে:

  • আপনার গুগল অ্যাড ম্যানেজার নেটওয়ার্কে DAI Pod পরিবেশন সক্রিয় করা হয়েছে।
  • পড সার্ভিং ম্যানিফেস্ট টাইপের একটি লাইভস্ট্রিম ইভেন্ট। ইভেন্টটি তৈরি করতে, DAI-এর জন্য একটি লাইভস্ট্রিম সেট আপ করুন দেখুন।

সুপারিশগুলো অনুসরণ করুন

অ্যাড পড ম্যানিফেস্ট ইউআরএল তৈরি করার আগে, আমরা আপনাকে আর্লি অ্যাড ব্রেক নোটিফিকেশন (EABN) এপিআই কল করে প্রতিটি অ্যাড ব্রেকের প্রত্যাশিত সময়কাল, টার্গেটিং তথ্য এবং অন্যান্য প্যারামিটার নির্দিষ্ট করার পরামর্শ দিই।

প্রোডাকশন এবং টেস্ট স্ট্রিমের জন্য EABN API কল করুন, বিশেষ করে যদি আপনার অ্যাড নেটওয়ার্কে কোনো প্রোগ্রাম্যাটিক ক্যাম্পেইন থাকে। আরও তথ্যের জন্য, প্রোগ্রাম্যাটিক ডিরেক্ট-এর বৈশিষ্ট্য এবং নির্দেশিকা দেখুন।

স্ট্রিম রেজিস্ট্রেশনের জন্য অনুরোধ করুন

যখন কোনো ব্যবহারকারী আপনার ভিডিও প্লেয়ার অ্যাপে একটি কন্টেন্ট স্ট্রিম শুরু করেন, তখন আপনি অ্যাড ম্যানেজারে একটি স্ট্রিমিং সেশন তৈরি করার জন্য টার্গেটিং প্যারামিটারসহ একটি স্ট্রিম রেজিস্ট্রেশন অনুরোধ পাঠান। স্ট্রিম রেজিস্ট্রেশন অনুরোধ পাঠানোর বিস্তারিত তথ্যের জন্য, Method:stream দেখুন। এরপর, আপনি অনুরোধটি থেকে প্রতিক্রিয়া ডেটা গ্রহণ করেন।

নিম্নলিখিত উদাহরণগুলি একটি স্ট্রিম রেজিস্ট্রেশন অনুরোধ তৈরি করে:

সাধারণ টেক্সট HTTP

  • অনুরোধ: 
authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2
  • প্রতিক্রিয়া: 
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

খোলস

  • কমান্ড লাইন: 
curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"
  • আউটপুট: 
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

জাভাস্ক্রিপ্ট

  • Fetch API ব্যবহার করে: 
const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);
  • কনসোল লগ: 
{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

বিজ্ঞাপন বিরতির মেটাডেটার জন্য জরিপ

আপনি একটি স্ট্রিম রেজিস্ট্রেশন অনুরোধ করার পরে, বিজ্ঞাপনের মেটাডেটার জন্য পোল করুন। পোল করার জন্য, রেজিস্ট্রেশন ধাপে স্ট্রিম রেসপন্সে polling_frequence ব্যবহার করে একটি টাইমার সেট করুন, যা বিজ্ঞাপনের মেটাডেটা কল করবে। প্রতিটি পোলের জন্য, মেটাডেটা উপলব্ধ হওয়ার সাথে সাথে আপনি বিজ্ঞাপনগুলির একটি আংশিক তালিকা পেতে পারেন।

অ্যাড পড ম্যানিফেস্ট ইউআরএল তৈরি করুন

পড সার্ভিং এপিআই-এর পড রিসোর্সের জন্য একটি ইউআরএল তৈরি করুন। এরপর, অ্যাড পড লোড করা শুরু করতে ইউআরএলটি একটি ভিডিও প্লেয়ারে পাঠান।

নিম্নলিখিত উদাহরণটি অ্যাড পড ম্যানিফেস্ট ইউআরএল-এর গঠন প্রদর্শন করে:

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/ad_break_id/ab101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

আপনি ভিডিও প্লেয়ার থেকে প্রাপ্ত বিজ্ঞাপন বিরতির তথ্য অথবা সার্ভার নোটিফিকেশনের উপর ভিত্তি করে বিজ্ঞাপন পড ম্যানিফেস্ট ইউআরএল প্যারামিটারগুলো গণনা করতে পারেন। এই প্যারামিটারগুলোর প্রয়োজনীয়তার জন্য, পদ্ধতি: পড ম্যানিফেস্ট দেখুন।

অ্যাড পড ম্যানিফেস্টটি চালান

ক্লায়েন্ট ভিডিও প্লেয়ার অ্যাপে, একটি প্রাথমিক ভিডিও প্লেয়ার দিয়ে কন্টেন্ট স্ট্রিম প্লেব্যাক শুরু করুন এবং প্রাসঙ্গিক হলে, প্লেব্যাক ও বিজ্ঞাপনের সময়সূচী পর্যবেক্ষণের জন্য আপনার ভিডিও প্লেয়ারের ডকুমেন্টেশন অনুসরণ করুন।

যদি আপনি অ্যাড পড ম্যানিফেস্ট ইউআরএলগুলো তৈরি করে সার্ভার সাইডের ম্যানিফেস্টে যুক্ত করেন, তাহলে ভিডিও প্লেয়ারের আসন্ন অ্যাড ব্রেক ইভেন্টগুলো পর্যবেক্ষণ করুন এবং প্রতিটি অ্যাড ব্রেক প্লেব্যাকের সময় id3 ইভেন্টগুলোতে সাবস্ক্রাইব করা নিশ্চিত করুন। যদি আপনি ক্লায়েন্ট সাইড থেকে অ্যাড ব্রেক ইভেন্টগুলো শিডিউল করেন, তাহলে ইভেন্টগুলো তৈরি হওয়ার সময়েই id3 ইভেন্টগুলোতে সাবস্ক্রাইব করুন।

ইম্প্রেশন এবং বিজ্ঞাপন ইভেন্ট রিপোর্ট করুন

যখন কোনো ভিডিও প্লেয়ার অ্যাড পডটি প্লে করে এবং id3 টাইমড মেটাডেটার সম্মুখীন হয়, তখন ভিডিও প্লেয়ার দ্বারা ট্রিগার করা অ্যাড ইভেন্টগুলো শুনুন এবং মিডিয়া ভেরিফিকেশন পিং পাঠানোর জন্য সেগুলোকে প্রসেস করুন।