গুগল ima AdDisplay Container
এই শ্রেণীটি বিজ্ঞাপন প্রদর্শনের জন্য একটি ধারক প্রতিনিধিত্ব করে। SDK স্বয়ংক্রিয়ভাবে কন্টেইনার এলিমেন্ট প্যারামিটারের ভিতরে ভিডিও এবং ওভারলে বিজ্ঞাপনের জন্য কাঠামো তৈরি করবে।
যখন এই ক্লাসের একটি উদাহরণ তৈরি করা হয়, তখন এটি কন্টেইনার এলিমেন্টে একটি IFRAME তৈরি করে এবং SDK কোর লোড করে। SDK সঠিকভাবে কাজ করার জন্য এই IFRAME অবশ্যই সংরক্ষণ করতে হবে। একবার সমস্ত বিজ্ঞাপন প্লে হয়ে গেলে এবং SDK এর আর প্রয়োজন হবে না, SDK আনলোড করতে destroy() পদ্ধতি ব্যবহার করুন।
কনটেইনারএলিমেন্ট প্যারামিটারটি অবশ্যই এমন একটি উপাদান হতে হবে যা DOM-এর অংশ। বিজ্ঞাপনগুলি সঠিকভাবে দেখানোর জন্য কন্টেইনার এলিমেন্টটি সঠিকভাবে স্থাপন করা প্রয়োজন। এটিকে বিষয়বস্তু ভিডিও প্লেয়ারের উপরে অবস্থান এবং পুরো ভিডিও প্লেয়ারকে কভার করার জন্য এটির আকার দেওয়ার পরামর্শ দেওয়া হয়৷ প্রস্তাবিত বাস্তবায়ন সম্পর্কে বিস্তারিত জানার জন্য SDK ডকুমেন্টেশন পড়ুন।
দ্রষ্টব্য: কোডে initialize() পদ্ধতিতে কল করা সর্বদা প্রয়োজন যা ব্যবহারকারীর ক্রিয়া দ্বারা সরাসরি আহ্বান করা হয়েছিল (যেমন একটি ক্লিক বা ট্যাপ)।
কনস্ট্রাক্টর
AdDisplay Container
নতুন AdDisplayContainer(containerElement, videoElement, clickTrackingElement)
প্যারামিটার | |
|---|---|
ধারক উপাদান | যে উপাদানটিতে বিজ্ঞাপন দেখানো হবে। AdDisplayContainer তৈরি করার আগে উপাদানটিকে DOM-এ প্রবেশ করাতে হবে। মান শূন্য হতে হবে না. |
ভিডিও উপাদান | ঐচ্ছিক বিকল্প ভিডিও বিজ্ঞাপন প্লেব্যাক উপাদান নির্দিষ্ট করে। আমরা সবসময় আপনার কন্টেন্ট ভিডিও প্লেয়ারে পাস করার পরামর্শ দিই। মান শূন্য হতে হবে না. |
ক্লিক ট্র্যাকিং এলিমেন্ট | ঐচ্ছিক বিকল্প ভিডিও বিজ্ঞাপন ক্লিক উপাদান নির্দিষ্ট করে। SDK-কে ক্লিকগুলি পরিচালনা করতে দিতে এই নালটি ছেড়ে দিন। সরবরাহ করা হলেও, SDK শুধুমাত্র তখনই কাস্টম ক্লিক ট্র্যাকিং উপাদান ব্যবহার করবে যখন নন-AdSense/AdX ক্রিয়েটিভগুলি এমন পরিবেশে প্রদর্শিত হয় যা ভিডিও প্লেয়ারকে (উদাহরণস্বরূপ, iPhone বা প্রি-4.0 Android) ওভারলে করা UI উপাদানগুলিকে সমর্থন করে না৷ কাস্টম ক্লিক ট্র্যাকিং উপাদানটি কখনই ভিডিও প্লেয়ারে রেন্ডার করা উচিত নয় কারণ এটি SDK রেন্ডার করা UI উপাদানগুলিতে ক্লিকগুলিকে বাধা দিতে পারে৷ এছাড়াও মনে রাখবেন যে SDK কাস্টম ক্লিক ট্র্যাকিং উপাদানটির দৃশ্যমানতা পরিবর্তন করবে না। এর মানে হল যদি একটি কাস্টম ক্লিক ট্র্যাকিং উপাদান সরবরাহ করা হয়, লিনিয়ার বিজ্ঞাপনটি চালানোর সময় এটি অবশ্যই সঠিকভাবে প্রদর্শিত হবে। আপনি ima.AdsManager.isCustomClickTrackingUsed চেক করতে পারেন যখন ima.AdEvent.Type.STARTED ইভেন্টটি আপনার কাস্টম ক্লিক ট্র্যাকিং উপাদান প্রদর্শন করা হবে কিনা তা নির্ধারণ করতে চালিত হয়। আপনার UI এর জন্য উপযুক্ত হলে, ima.AdEvent.Type.CONTENT_RESUME_REQUESTED ইভেন্ট ফায়ার হলে আপনার ক্লিক ট্র্যাকিং উপাদানটি লুকানো উচিত৷ মান শূন্য হতে হবে না. |
পদ্ধতি
ধ্বংস
ধ্বংস()
অভ্যন্তরীণ অবস্থা এবং পূর্বে তৈরি DOM উপাদান ধ্বংস করে। IMA SDK আনলোড করা হবে এবং কোনো API-কে আর কোনো কল করা উচিত নয়।
আরম্ভ করা
আরম্ভ করা()
প্লেব্যাকের জন্য অভ্যন্তরীণ ভিডিও উপাদানগুলি শুরু করে৷ আপনাকে অবশ্যই এই পদ্ধতিটিকে ব্যবহারকারীর কর্মের সরাসরি ফলাফল হিসাবে কল করতে হবে, যাতে ব্রাউজার ভিডিও উপাদানটিকে ব্যবহারকারীর সূচনা হিসাবে চিহ্নিত করতে পারে।
ভিডিওটি নিঃশব্দ থাকলে কিছু ব্রাউজার ব্যবহারকারীর ইন্টারঅ্যাকশন ছাড়াই ভিডিও প্লেব্যাকের অনুমতি দেবে। এই আচরণের জন্য, AdsRequest.setAdWillPlayMuted(true) ব্যবহার করুন এবং AdsManager.start() এর আগে এই পদ্ধতিটিকে কল করুন।