PAL SDK Roku API রেফারেন্স

সতর্কতা: Roku-এর জন্য PAL SDK বাতিল করা হয়েছে এবং Roku-এর জন্য PAL SDK প্রয়োগকারী নতুন Roku অ্যাপ্লিকেশানগুলি আর প্রকাশের জন্য Roku দ্বারা প্রত্যয়িত হচ্ছে না৷ Roku-এ বিজ্ঞাপন নগদীকরণ চালিয়ে যাওয়ার জন্য একটি Google বিজ্ঞাপন ব্যবস্থাপকের বিকল্প তৈরি করা হচ্ছে। আপনি যদি বন্ধ বিটাতে যুক্ত হতে আগ্রহী হন তাহলে আপনার অ্যাকাউন্ট প্রতিনিধির সাথে যোগাযোগ করুন।

1. 1. ima
   2. ima.NonceLoader
   3. ima.NonceManager
   4. ima.NonceRequest

ক্লাস ইমা

গ্লোবাল ফাংশন যা PAL এর জন্য Roku IMA নিয়ন্ত্রণ করে।

উপরে ফিরে যান

ক্লাস ima.NonceLoader

পদ্ধতি

createNonceLoader , loadNonceManager

প্রোগ্রাম্যাটিক অ্যাক্সেস লাইব্রেরি প্রকাশকদের সংকেত সংগ্রহ করতে দেয় যা AdX চাহিদা আনলক করতে ব্যবহার করা যেতে পারে। প্রতিটি বিজ্ঞাপনের অনুরোধের জন্য, loadNonceManager-এ একটি কলের পরে প্রয়োজন অনুযায়ী প্রাসঙ্গিক সেটারদের কল করুন। প্রকাশকরা তখন NonceManager.getNonce() কে কল করতে পারেন যাতে বিজ্ঞাপনের অনুরোধে মান হিসাবে যোগ করা উচিত এমন স্ট্রিং পেতে

createNonceLoader()

ima.NonceLoader ফেরত দেয়:

loadNonceManager(request)

ima.NonceManager ফেরত দেয়: একটি বিজ্ঞাপন অনুরোধের জন্য একটি ননস তৈরি করার জন্য একজন ননস ম্যানেজার।

প্যারামিটার	টাইপ	বর্ণনা
request	ima.NonceRequest	ননস সম্পর্কে তথ্য ধারণকারী অনুরোধ অনুরোধ করা হচ্ছে.

উপরে ফিরে যান

ক্লাস ima.NonceManager

পদ্ধতি

getNonce , পোল , sendAdClick , sendAdImpression , sendAdTouch , SendPlaybackEnd , SendPlaybackStart

একটি একক সামগ্রী প্লেব্যাক সেশনের জন্য একটি নন্স এবং এর ইভেন্ট রিপোর্টিং পরিচালনা করে। ima.NonceManager.sendAdClick , ima.NonceManager.sendAdTouch , ima.NonceManager.sendPlaybackStart , এবং sendPlaybackEnd সহ বিষয়বস্তু প্লেব্যাক সেশনের জীবনচক্র পদ্ধতিগুলিকে অবশ্যই কল করতে হবে কারণ প্রোগ্রাম্যাটিক নগদীকরণ সক্ষম করার জন্য এই সম্পর্কিত ঘটনাগুলি ঘটে৷

getNonce()

রিটার্ন String : এই ম্যানেজারের জন্য ননস তৈরি করা হয়েছে যখন এটি লোড করা হয়েছিল। একটি প্রদত্ত NonceManager উদাহরণের জন্য এই মান কখনই পরিবর্তিত হবে না। এই অপ্রত্যাশিত মান শুধুমাত্র একটি একক সামগ্রী প্লেব্যাক সেশনের জন্য সর্বোচ্চ 6 ঘন্টা পর্যন্ত বৈধ।

poll()

ম্যানেজার স্টেট আপডেট করে যাতে এটি প্লেব্যাকের অগ্রগতির ট্র্যাক রাখতে পারে।

sendAdClick()

Google বিজ্ঞাপন সার্ভারগুলিকে বিজ্ঞপ্তি দেয় যে প্রদত্ত সামগ্রী প্লেব্যাক সেশনের সময় একটি বিজ্ঞাপনে একটি ক্লিকথ্রু ঘটেছে৷

sendAdImpression()

অবচয়। ima.NonceManager.sendPlaybackStart এবং ima.NonceManager.sendPlaybackEnd/code>.


sendAdTouch(touch)

Google বিজ্ঞাপন সার্ভারগুলিকে বিজ্ঞপ্তি দেয় যে প্রদত্ত বিষয়বস্তু প্লেব্যাক সেশনের সময় ব্যবহারকারী একটি ক্লিকথ্রু (উদাহরণস্বরূপ, স্কিপ, মিউট, ট্যাপ, ইত্যাদি) ছাড়া অন্য বিজ্ঞাপনে স্পর্শ বা ক্লিক করেছেন।

প্যারামিটার	টাইপ	বর্ণনা
touch	roInputEvent|String	onKeyEvent থেকে প্রাপ্ত কী (যদি SceneGraph ব্যবহার করে), অথবা অন্যথায় roInputEvent থেকে।

sendPlaybackEnd()

Google বিজ্ঞাপন সার্ভারগুলিকে সূচিত করে যে প্রদত্ত সামগ্রী প্লেব্যাক সেশনের জন্য প্লেব্যাক শেষ হয়েছে৷ প্লেব্যাক শেষ হলে এটি বলা উচিত (উদাহরণস্বরূপ, যখন প্লেয়ার স্ট্রিমের শেষে পৌঁছে যায়, বা যখন ব্যবহারকারী প্লেব্যাক মাঝপথে প্রস্থান করে, বা যখন ব্যবহারকারী চ্যানেল ছেড়ে দেয়, বা প্লেলিস্ট সেটিংসে পরবর্তী বিষয়বস্তু আইটেমে অগ্রসর হয়) . এই পদ্ধতিটি সেন্ডপ্লেব্যাকস্টার্টে শুরু হওয়া Google সার্ভারে অ্যাসিঙ্ক্রোনাস কলগুলি শেষ করে।

sendPlaybackStart()

Google বিজ্ঞাপন সার্ভারগুলিকে সূচিত করে যে প্রদত্ত সামগ্রী প্লেব্যাক সেশনের জন্য প্লেব্যাক শুরু হয়েছে৷ এটিকে "ভিডিও প্লেয়ার স্টার্ট" বলা উচিত। এটি একটি ব্যবহারকারীর সূচনা ক্রিয়া (ক্লিক-টু-প্লে) বা একটি চ্যানেল শুরু করা ক্রিয়া (অটোপ্লে) এর প্রতিক্রিয়া হতে পারে। এই পদ্ধতিটি IVT পর্যবেক্ষণ এবং সনাক্তকরণের জন্য প্রয়োজনীয় সংকেত সংগ্রহ করতে Google সার্ভারে অ্যাসিঙ্ক্রোনাস কল শুরু করবে।

উপরে ফিরে যান

ক্লাস ima.NonceRequest

ক্ষেত্র

adWillAutoPlay , adWillPlayMuted , একটানা প্লেব্যাক , descriptionUrl , directedForChildOrUnknownAge , আইকন সমর্থিত , ppid , sessionId , স্টোরেজ অনুমোদিত , সমর্থিত ApiFrameworks , ভিডিও উচ্চতা , ভিডিও প্রস্থ

পদ্ধতি

createNonceRequest

PAL নন্সের অনুরোধ করার সময় একজন প্রকাশক যে তথ্য প্রদান করতে পারেন।

বৈশিষ্ট্য

নাম	টাইপ	বর্ণনা
adWillAutoPlay		ব্যবহারকারীর ইন্টারঅ্যাকশনের জন্য অপেক্ষা না করে বিজ্ঞাপনটি স্বয়ংক্রিয়ভাবে চালানো হলে সত্যে সেট করুন। বিজ্ঞাপনটি চালানোর আগে ব্যবহারকারীর ইন্টারঅ্যাকশনের জন্য অপেক্ষা করলে মিথ্যাতে সেট করুন।
adWillPlayMuted		বিজ্ঞাপনটি নিঃশব্দে চালানো হলে সত্যে সেট করুন৷ বিজ্ঞাপনটি আনমিউট করা হলে মিথ্যাতে সেট করুন।
continuousPlayback		যদি প্লেয়ার টিভি সম্প্রচার বা ভিডিও প্লেলিস্টের মতো একের পর এক বিষয়বস্তু ভিডিও ক্রমাগত প্লে করতে চায় তাহলে সত্যে সেট করুন৷ অন্যথায় মিথ্যা সেট করুন।
descriptionUrl		কন্টেন্টের বর্ণনা URL যে সময়ে বিজ্ঞাপনটি চালানো হবে। 500 অক্ষরের চেয়ে দীর্ঘ যেকোন বর্ণনা URL স্ট্রিং উপেক্ষা করা হবে এবং নন্স থেকে বাদ দেওয়া হবে।
directedForChildOrUnknownAge		বিজ্ঞাপনের অনুরোধটি অজানা বয়সের (TFCD বা TFUA) কোনো শিশু বা ব্যবহারকারীর জন্য নির্দেশিত কিনা। ডিফল্ট মান মিথ্যা।
iconsSupported		VAST আইকনগুলি ভিডিও প্লেয়ার দ্বারা সমর্থিত কিনা৷ রোকুতে এই মানটি সর্বদা মিথ্যা হওয়া উচিত।
ppid		প্রকাশক আইডি দিয়েছেন। 200 অক্ষরের বেশি যেকোন PPID উপেক্ষা করা হবে। দ্রষ্টব্য: PPID ব্যক্তিগতকরণে ব্যবহার করা হবে না। ব্যক্তিগতকরণের জন্য পিপিআইড ব্যবহার করা উপযুক্ত হলে, আপনার বিজ্ঞাপনের অনুরোধে স্পষ্ট পাঠ্যে এটি আলাদাভাবে অন্তর্ভুক্ত করুন।
sessionId		সেশন আইডি একটি অস্থায়ী র্যান্ডম আইডি। এটি ফ্রিকোয়েন্সি ক্যাপিংয়ের জন্য একচেটিয়াভাবে ব্যবহৃত হয়। একটি সেশন আইডি একটি UUID হতে হবে।
storageAllowed		IAB TCF V2 স্পেক থেকে স্টোরেজ সম্মতি (উদ্দেশ্য 1 সম্মতি) ব্যবহারকারীর দ্বারা দেওয়া হয়েছে কিনা। ডিফল্ট থেকে সত্য।
supportedApiFrameworks		AdCOM 1.0 "API Frameworks" তালিকা https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list-এ সংজ্ঞায়িত হিসাবে প্লেয়ার দ্বারা সমর্থিত API ফ্রেমওয়ার্কগুলির প্রতিনিধিত্বকারী স্ট্রিংগুলির একটি অ্যারে গ্রহণ করে -এপিআই-ফ্রেমওয়ার্ক-। উদাহরণ: ["2","7","9"] নির্দেশ করে যে এই প্লেয়ারটি VPAID 2.0, OMID 1.0, এবং SIMID 1.1 সমর্থন করে৷
videoHeight		বিজ্ঞাপন ভিডিও উপাদানের উচ্চতা.
videoWidth		বিজ্ঞাপন ভিডিও উপাদানের প্রস্থ।

createNonceRequest()

ima.NonceRequest ফেরত দেয়:

উপরে ফিরে যান