SGAI দিয়ে শুরু করুন, SGAI দিয়ে শুরু করুন, SGAI দিয়ে শুরু করুন

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

SGAI-এর সাথে, আপনি বিজ্ঞাপন মেটাডেটা পুনরুদ্ধার করার জন্য একটি স্ট্রীম তৈরি করার জন্য Pod সার্ভিং API এন্ডপয়েন্ট ব্যবহার করেন এবং অ্যাড পড ম্যানিফেস্ট করে।

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

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

পূর্বশর্ত

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

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

সুপারিশ অনুসরণ করুন

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

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

একটি স্ট্রিম নিবন্ধন অনুরোধ করুন

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

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

প্লেইন টেক্সট 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"
}

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

  • ফেচ 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 ব্যবহার করে একটি টাইমার সেট করেন। প্রতিটি পোলের জন্য, আপনি মেটাডেটা সহ বিজ্ঞাপনগুলির একটি আংশিক তালিকা উপলব্ধ হতে পারে।

বিজ্ঞাপন পড ম্যানিফেস্ট URL তৈরি করুন

Pod Serving API-এর পড রিসোর্সের জন্য একটি URL তৈরি করুন। তারপরে, বিজ্ঞাপন পড লোড করা শুরু করতে একটি ভিডিও প্লেয়ারে URL পাস করুন৷

নিম্নলিখিত উদাহরণ বিজ্ঞাপন পড ম্যানিফেস্ট URL এর গঠন প্রদর্শন করে:

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

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

বিজ্ঞাপন পড ম্যানিফেস্ট খেলুন

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

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

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

যখন একটি ভিডিও প্লেয়ার বিজ্ঞাপন পড চালায় এবং id3 টাইমড মেটাডেটার সম্মুখীন হয়, তখন ভিডিও প্লেয়ারটি ট্রিগার করে এমন বিজ্ঞাপন ইভেন্টগুলি শুনুন এবং মিডিয়া যাচাইকরণ পিংগুলি পাঠাতে সেগুলিকে প্রক্রিয়া করুন৷