গুগল ima AdPodInfo
একটি বিজ্ঞাপন বিজ্ঞাপনের একটি পড অংশ হতে পারে. এই বস্তুটি সেই পডের সাথে সম্পর্কিত মেটাডেটা প্রকাশ করে, যেমন পডের মধ্যে বিজ্ঞাপনের সংখ্যা এবং পডের মধ্যে বিজ্ঞাপনের অবস্থান।
এই বস্তুর মধ্যে থাকা getTotalAds API প্রায়ই সঠিক, কিন্তু কিছু পরিস্থিতিতে, এটি SDK-এর সেরা অনুমানকে উপস্থাপন করে। আরও তথ্যের জন্য সেই পদ্ধতির ডকুমেন্টেশন দেখুন।
পদ্ধতি
অ্যাডপোজিশন পান
getAdPosition() নম্বর প্রদান করে
বিজ্ঞাপনের অবস্থান ফেরত দেয়।
- রিটার্নস
numberপডের মধ্যে বিজ্ঞাপনের অবস্থান। ফেরত দেওয়া মানটি এক-ভিত্তিক, উদাহরণস্বরূপ, 2-এর 1, 2-এর 2 এবং আরও অনেক কিছু৷
getIsBumper
getIsBumper() বুলিয়ান রিটার্ন করে
বিজ্ঞাপনটি একটি বাম্পার বিজ্ঞাপন হলে সত্য প্রদান করে। বাম্পার বিজ্ঞাপন হল সংক্ষিপ্ত রৈখিক বিজ্ঞাপন যা ব্যবহারকারীকে নির্দেশ করতে পারে যখন ব্যবহারকারী বিজ্ঞাপন বিরতিতে প্রবেশ করছে বা বের হচ্ছে।
- রিটার্নস
booleanবিজ্ঞাপনটি একটি বাম্পার বিজ্ঞাপন কিনা।
GetMaxDuration
getMaxDuration() নম্বর প্রদান করে
সেকেন্ডে পডের সর্বোচ্চ সময়কাল। অজানা সময়ের জন্য, -1 ফেরত দেওয়া হয়।
- রিটার্নস
numberএই পডের বিজ্ঞাপনের সর্বোচ্চ সময়কাল সেকেন্ডে।
getPodIndex
getPodIndex() নম্বর প্রদান করে
ক্লায়েন্ট সাইড এবং DAI VOD: বিজ্ঞাপন পডের সূচী প্রদান করে। একটি প্রিরোল পডের জন্য, 0 রিটার্ন করে। মিডরোলের জন্য, 1, 2,..., N. একটি পোস্টরোল পডের জন্য, -1 প্রদান করে। যদি এই বিজ্ঞাপনটি কোনো পডের অংশ না হয়, অথবা এই পডটি কোনো প্লেলিস্টের অংশ না হয় তাহলে ডিফল্ট 0. DAI লাইভ স্ট্রিম: সর্বদা -1 ফেরত দেয়।
- রিটার্নস
numberবিজ্ঞাপন প্লেলিস্টে পডের সূচী।
getTimeOffset
getTimeOffset() নম্বর প্রদান করে
সামগ্রীর সময় অফসেট প্রদান করে যেখানে বর্তমান বিজ্ঞাপন পড নির্ধারিত ছিল। গতিশীলভাবে সন্নিবেশিত বিজ্ঞাপন সহ VOD স্ট্রীমের পডগুলির জন্য, স্ট্রিমের সময় ফেরত দেওয়া হয়।
প্রিরোল পডের জন্য, 0 ফেরত দেওয়া হয়। মিডরোলদের জন্য, নির্ধারিত সময় ফেরত দেওয়া হয়। পোস্টরোলের জন্য, -1 ফেরত দেওয়া হয়।
যদি এই বিজ্ঞাপনটি কোনো পডের অংশ না হয়, বা পডটি কোনো বিজ্ঞাপন প্লেলিস্টের অংশ না হয় তাহলে ডিফল্ট 0.
- রিটার্নস
numberবর্তমান বিজ্ঞাপন পডের জন্য অফসেট সময়।
মোট বিজ্ঞাপন পান
getTotalAds() নম্বর প্রদান করে
বাম্পার সহ এই পডের মধ্যে থাকা বিজ্ঞাপনের মোট সংখ্যা। বাম্পার বিজ্ঞাপন হল সংক্ষিপ্ত রৈখিক বিজ্ঞাপন যা ব্যবহারকারীকে নির্দেশ করতে পারে যখন ব্যবহারকারী বিজ্ঞাপন বিরতিতে প্রবেশ করছে বা বের হচ্ছে।
যদি এই বিজ্ঞাপনটি একটি পডের অংশ না হয় তবে 1 এ ডিফল্ট।
নির্দিষ্ট পরিস্থিতিতে, SDK নিশ্চিতভাবে জানে না যে এই বিজ্ঞাপন পডের মধ্যে কতগুলি বিজ্ঞাপন রয়েছে৷ এই পরিস্থিতিতে বিজ্ঞাপন পড অন্তর্ভুক্ত, যা একটি একক বিজ্ঞাপন ট্যাগের মধ্যে একাধিক বিজ্ঞাপন। এই পরিস্থিতিতে, প্রথম কয়েকটি অ্যাড ইভেন্ট ফায়ার করা হয়েছে (AD_METADATA, LOADED এবং আরও অনেক কিছু।) প্লেলিস্ট প্রতিক্রিয়া থেকে বিজ্ঞাপন ট্যাগের মোট সংখ্যা থাকতে পারে। আমরা FIRST_QUARTILE ইভেন্টটিকে ইভেন্ট হিসাবে ব্যবহার করার পরামর্শ দিই যেখানে প্রকাশকরা এই বস্তু থেকে তথ্য সংগ্রহ করে এবং প্লেয়ারের ভিজ্যুয়াল উপাদান আপডেট করে, যদি থাকে।
- রিটার্নস
numberপডে বিজ্ঞাপনের মোট সংখ্যা।
গুগল ima AdPodInfo
একটি বিজ্ঞাপন বিজ্ঞাপনের একটি পড অংশ হতে পারে. এই বস্তুটি সেই পডের সাথে সম্পর্কিত মেটাডেটা প্রকাশ করে, যেমন পডের মধ্যে বিজ্ঞাপনের সংখ্যা এবং পডের মধ্যে বিজ্ঞাপনের অবস্থান।
এই বস্তুর মধ্যে থাকা getTotalAds API প্রায়ই সঠিক, কিন্তু কিছু পরিস্থিতিতে, এটি SDK-এর সেরা অনুমানকে উপস্থাপন করে। আরও তথ্যের জন্য সেই পদ্ধতির ডকুমেন্টেশন দেখুন।
পদ্ধতি
অ্যাডপোজিশন পান
getAdPosition() নম্বর প্রদান করে
বিজ্ঞাপনের অবস্থান ফেরত দেয়।
- রিটার্নস
numberপডের মধ্যে বিজ্ঞাপনের অবস্থান। ফেরত দেওয়া মানটি এক-ভিত্তিক, উদাহরণস্বরূপ, 2-এর 1, 2-এর 2 এবং আরও অনেক কিছু৷
getIsBumper
getIsBumper() বুলিয়ান রিটার্ন করে
বিজ্ঞাপনটি একটি বাম্পার বিজ্ঞাপন হলে সত্য প্রদান করে। বাম্পার বিজ্ঞাপন হল সংক্ষিপ্ত রৈখিক বিজ্ঞাপন যা ব্যবহারকারীকে নির্দেশ করতে পারে যখন ব্যবহারকারী বিজ্ঞাপন বিরতিতে প্রবেশ করছে বা বের হচ্ছে।
- রিটার্নস
booleanবিজ্ঞাপনটি একটি বাম্পার বিজ্ঞাপন কিনা।
GetMaxDuration
getMaxDuration() নম্বর প্রদান করে
সেকেন্ডে পডের সর্বোচ্চ সময়কাল। অজানা সময়ের জন্য, -1 ফেরত দেওয়া হয়।
- রিটার্নস
numberএই পডের বিজ্ঞাপনের সর্বোচ্চ সময়কাল সেকেন্ডে।
getPodIndex
getPodIndex() নম্বর প্রদান করে
ক্লায়েন্ট সাইড এবং DAI VOD: বিজ্ঞাপন পডের সূচী প্রদান করে। একটি প্রিরোল পডের জন্য, 0 রিটার্ন করে। মিডরোলের জন্য, 1, 2,..., N. একটি পোস্টরোল পডের জন্য, -1 প্রদান করে। যদি এই বিজ্ঞাপনটি কোনো পডের অংশ না হয়, অথবা এই পডটি কোনো প্লেলিস্টের অংশ না হয় তাহলে ডিফল্ট 0. DAI লাইভ স্ট্রিম: সর্বদা -1 ফেরত দেয়।
- রিটার্নস
numberবিজ্ঞাপন প্লেলিস্টে পডের সূচী।
getTimeOffset
getTimeOffset() নম্বর প্রদান করে
সামগ্রীর সময় অফসেট প্রদান করে যেখানে বর্তমান বিজ্ঞাপন পড নির্ধারিত ছিল। গতিশীলভাবে সন্নিবেশিত বিজ্ঞাপন সহ VOD স্ট্রীমের পডগুলির জন্য, স্ট্রিমের সময় ফেরত দেওয়া হয়।
প্রিরোল পডের জন্য, 0 ফেরত দেওয়া হয়। মিডরোলদের জন্য, নির্ধারিত সময় ফেরত দেওয়া হয়। পোস্টরোলের জন্য, -1 ফেরত দেওয়া হয়।
যদি এই বিজ্ঞাপনটি কোনো পডের অংশ না হয়, বা পডটি কোনো বিজ্ঞাপন প্লেলিস্টের অংশ না হয় তাহলে ডিফল্ট 0.
- রিটার্নস
numberবর্তমান বিজ্ঞাপন পডের জন্য অফসেট সময়।
মোট বিজ্ঞাপন পান
getTotalAds() নম্বর প্রদান করে
বাম্পার সহ এই পডের মধ্যে থাকা বিজ্ঞাপনের মোট সংখ্যা। বাম্পার বিজ্ঞাপন হল সংক্ষিপ্ত রৈখিক বিজ্ঞাপন যা ব্যবহারকারীকে নির্দেশ করতে পারে যখন ব্যবহারকারী বিজ্ঞাপন বিরতিতে প্রবেশ করছে বা বের হচ্ছে।
যদি এই বিজ্ঞাপনটি একটি পডের অংশ না হয় তবে 1 এ ডিফল্ট।
নির্দিষ্ট পরিস্থিতিতে, SDK নিশ্চিতভাবে জানে না যে এই বিজ্ঞাপন পডের মধ্যে কতগুলি বিজ্ঞাপন রয়েছে৷ এই পরিস্থিতিতে বিজ্ঞাপন পড অন্তর্ভুক্ত, যা একটি একক বিজ্ঞাপন ট্যাগের মধ্যে একাধিক বিজ্ঞাপন। এই পরিস্থিতিতে, প্রথম কয়েকটি অ্যাড ইভেন্ট ফায়ার করা হয়েছে (AD_METADATA, LOADED এবং আরও অনেক কিছু।) প্লেলিস্ট প্রতিক্রিয়া থেকে বিজ্ঞাপন ট্যাগের মোট সংখ্যা থাকতে পারে। আমরা FIRST_QUARTILE ইভেন্টটিকে ইভেন্ট হিসাবে ব্যবহার করার পরামর্শ দিই যেখানে প্রকাশকরা এই বস্তু থেকে তথ্য সংগ্রহ করে এবং প্লেয়ারের ভিজ্যুয়াল উপাদান আপডেট করে, যদি থাকে।
- রিটার্নস
numberপডে বিজ্ঞাপনের মোট সংখ্যা।