এই নির্দেশিকাটি দেখায় যে কীভাবে এড়িয়ে যাওয়া বিজ্ঞাপনগুলির সাথে একটি VOD স্ট্রিমের অনুরোধ করতে, Google বিজ্ঞাপনের প্রয়োজনীয়তা অনুযায়ী স্কিপ বোতামটি রেন্ডার করতে এবং সংশ্লিষ্ট ট্র্যাকিং ইভেন্টগুলি পাঠাতে DAI API ব্যবহার করতে হয়।
পূর্বশর্ত
- DAI API বাস্তবায়নকারী একটি অ্যাপ VOD স্ট্রিমগুলির জন্য কল করে৷ আরও তথ্যের জন্য DAI API VOD স্ট্রিম গাইড দেখুন।
এড়িয়ে যাওয়া বিজ্ঞাপনগুলির জন্য একটি অনুরোধ করুন
এড়িয়ে যাওয়া বিজ্ঞাপন সহ একটি VOD স্ট্রিমের অনুরোধ করতে, আপনাকে অবশ্যই আপনার স্ট্রিম অনুরোধে dai-sas প্যারামিটারটি পাস করতে হবে।
API এন্ডপয়েন্ট
POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded
পাথ প্যারামিটার
{CMS_ID} | স্ট্রীমের CMS আইডি। |
{VIDEO_ID} | স্ট্রীমের ভিডিও আইডি। |
শরীরের পরামিতি
dai-sas | এড়িয়ে যাওয়া বিজ্ঞাপন সক্ষম করতে dai-sas=1 সেট করুন। |
উদাহরণ অনুরোধ (cURL)
HLS স্ট্রিম অনুরোধের জন্য:
curl -X POST \
-d 'dai-sas=1' \
-H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
DASH স্ট্রিমগুলির জন্য URL-এ 'dash' প্রতিস্থাপন করুন:
https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream
আপনার অনুরোধের মূল অংশে একাধিক স্ট্রিম প্যারামিটার অন্তর্ভুক্ত করতে নিম্নলিখিত বিন্যাসটি ব্যবহার করুন:
-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \
এড়িয়ে যাওয়া বিজ্ঞাপনগুলি পরিচালনা করুন
এড়িয়ে যাওয়া বিজ্ঞাপনগুলি পরিচালনা করতে, আপনি বর্তমান বিজ্ঞাপন বা পুরো বিজ্ঞাপন বিরতি এড়িয়ে যাচ্ছেন কিনা তার উপর নির্ভর করে Ad struct বা AdBreak struct-এর তথ্য ব্যবহার করুন। start মান নিন এবং duration মান যোগ করুন, তারপর স্ট্রীমের সেই বিন্দুতে যান। SkipMetadata সাবমেসেজে offset মানও অন্তর্ভুক্ত থাকে, যা বিজ্ঞাপনটি এড়ানোর আগে সময়ের সেকেন্ডের একটি মান। SkipMetadata সাবমেসেজ শুধুমাত্র বাদ দেওয়া যায় এমন বিজ্ঞাপনগুলিতে অন্তর্ভুক্ত করা হবে।
ad_breaks | বিজ্ঞাপন বিরতির একটি তালিকা.
|
উদাহরণ প্রতিক্রিয়া
{
...
"ad_breaks":[
{
...
"start":0,
"duration":10,
"ads":[
{
...
"start":0,
"duration":10,
"skip_metadata":{
"offset": 5,
"tracking_url": "https://example_skip_url.com"
}
}
}
}
একবার বিজ্ঞাপনটি এড়িয়ে গেলে, স্ট্রিম প্রতিক্রিয়াতে অন্তর্ভুক্ত ইভেন্ট ইউআরএল এড়িয়ে যান। এটি SkipMetadata সাবমেসেজে অন্তর্ভুক্ত করা হয়েছে।
বোতামের প্রয়োজনীয়তাগুলি এড়িয়ে যান
বাদ দেওয়া যায় এমন বিজ্ঞাপনগুলির জন্য, নিম্নলিখিত ডিজাইনের প্রয়োজনীয়তাগুলি সহ স্কিপ বোতামটি রেন্ডার করুন৷ এই প্রয়োজনীয়তাগুলি অনুসরণ করতে ব্যর্থ হলে আপনার সাইট বা অ্যাপে দেখানো Google বিজ্ঞাপনগুলিতে বিধিনিষেধ আরোপ করা হতে পারে।
কাউন্টডাউন টাইমার
VAST-এ নির্দিষ্ট করা skipoffset সময় না হওয়া পর্যন্ত বিজ্ঞাপনটি এড়ানো যাবে না। এই অবিচ্ছিন্ন সময়ের মধ্যে, আপনাকে অবশ্যই ব্যবহারকারীকে একটি নোটিশ প্রদর্শন করতে হবে যাতে তাদের জানানো হয় যে বিজ্ঞাপনটি X সেকেন্ডের মধ্যে এড়িয়ে যেতে পারে। নোটিশটি অবশ্যই ব্যবহারকারীর ভাষায় অনুবাদ করতে হবে।
বোতামের অবস্থান এড়িয়ে যান
একটি বাম-থেকে-ডান ভাষার জন্য, ভিডিও প্লেয়ারের নীচে ডানদিকে স্কিপ বোতামটি রাখুন৷ ডান-থেকে-বাম ভাষার জন্য, ভিডিও প্লেয়ারের নীচে বাম দিকে স্কিপ বোতামটি রাখুন।
স্কিপ বোতামের আকার
বোতাম এবং পাঠ্যটি অবশ্যই যথেষ্ট বড় হতে হবে যাতে লীন-ব্যাক অভিজ্ঞতায় স্পষ্টভাবে সুস্পষ্ট হতে পারে।
টেক্সট এবং আইকন
স্কিপ বোতামে টেক্সট এবং আইকনোগ্রাফি উভয়ই থাকতে হবে। আপনি আপনার আইকনোগ্রাফি হিসাবে পরবর্তী উপাদান আইকনটি এড়িয়ে যেতে পারেন।
অ্যাক্সেসযোগ্যতা
ব্যবহারকারী একটি কীবোর্ড বা রিমোট কন্ট্রোল ব্যবহার করে স্কিপ বোতামে নেভিগেট করতে সক্ষম হওয়া উচিত। কাউন্টডাউন সম্পূর্ণ হয়ে গেলে অ্যাপটির স্কিপ বোতামে ফোকাস করা উচিত।
আন্তর্জাতিকীকরণ
স্কিপ টেক্সটটিকে ব্যবহারকারীর ভাষায় অনুবাদ করার পরামর্শ দেওয়া হয়।
বিজ্ঞাপন পড
স্কিপ বোতামটি বিজ্ঞাপন পডে বর্তমান বিজ্ঞাপনটি এড়িয়ে যেতে বা পুরো পডটি এড়িয়ে যেতে ব্যবহার করা যেতে পারে।
'বিজ্ঞাপন এড়িয়ে যান' অনুবাদ
ব্যবহারকারীর লোকেলের উপর ভিত্তি করে আপনার 'বিজ্ঞাপন এড়িয়ে যান' পাঠ্য অনুবাদ করার জন্য skipAdTranslations.json ফাইলটি ব্যবহার করুন।