Google Mobile Ads SDK-তে এখন MRAID v3-এর জন্য বিটা সহায়তা আছে, এটি MRAID v2-এর জন্য বিদ্যমান সহায়তার উপর ভিত্তি করে তৈরি করা হয়েছে, এর ফলে বিজ্ঞাপনদাতারা Ad Manager প্রকাশকদের MRAID v3 ক্রিয়েটিভ দেখাতে পারবেন। এই নির্দেশিকাটি MRAID ইমপ্লিমেন্টেশন সংক্রান্ত সেইসব বিবরণ স্পষ্ট করে যা MRAID v3 স্পেসিফিকেশন-এ অস্পষ্ট ছিল এবং যার একাধিক ব্যাখ্যা হতে পারত। এর লক্ষ্য হল MRAID v3 ক্রিয়েটিভের লেখকরা।
পূর্বশর্ত
প্রকাশকদের এগুলি অবশ্যই চালাতে হবে:
- MRAID v3-এর জন্য Google Play পরিষেবা 15.0.0 বা তার পরের যেকোনও ভার্সন
- MRAID v2-এর জন্য Google Play পরিষেবা 7.8 বা তার পরের যেকোনও ভার্সন
সহায়ক প্রাইমার
আপনি MRAID-এর সাথে পরিচিত না হলে, IAB MRAID পৃষ্ঠা থেকে আরও জানতে পারবেন। এছাড়াও, আপনি MRAID v3 সংজ্ঞা ডকুমেন্ট ডাউনলোড করতে পারেন, যা নিচে আলোচনা করা সমস্ত প্যারামিটার সম্পর্কে বিবরণ দেয়, পাশাপাশি MRAID v3-এর উপর IAB ব্লগ পোস্ট।
MRAID v3 (বিটা) প্রয়োগ করা সংক্রান্ত বিবরণ
ভিউয়েবিলিটি - exposureChange ইভেন্ট
এই ইভেন্ট কাজ করে এবং আমরা সাজেস্ট করি যে বাতিল করা viewableChange ইভেন্টের পরিবর্তে নতুন
exposureChange ইভেন্টের জন্য লিসনার ব্যবহার করুন।
mraid.isViewable() পদ্ধতিটিও বন্ধ করে দেওয়া হয়েছে। পুরনো ভার্সনের সাথে সামঞ্জস্য বজায় রাখার জন্য
এইসব বাতিল করা পদ্ধতি এখনও কাজ করে।
বিজ্ঞাপন ভিউ
পরিবর্তিত হলেই exposureChange ইভেন্ট সংজ্ঞা ডিসপ্যাচ করা হয়। অনেক বেশি ইভেন্ট তৈরি করা এড়াতে SDK-তে একটি পোলিং মেকানিজম আছে।
বিজ্ঞাপন কোনও লিসনার রেজিস্টার করার পরে প্রাথমিক স্টেট অ্যাসিঙ্ক্রোনাসভাবে পাঠানো হয়।
কলব্যাকে exposed_percentage প্যারামিটার থাকে যা 0.0 ও 100.0-এর মধ্যে একটি ফ্লোটিং-পয়েন্ট
সংখ্যা।
ব্যবহারের নমুনা দেখতে MRAID v3 স্পেসিফিকেশন দেখুন।
MRAID শনাক্তকরণ ও ইনিশিয়ালাইজেশন এবং MRAID_ENV অ্যাট্রিবিউট
SDK, MRAID v3 স্পেসিফিকেশন-এ বর্ণিত ইনিশিয়ালাইজেশন প্রোটোকল মেনে চলে।
MRAID_ENV অবজেক্টে, SDK IDFA, limitAdTracking,
অ্যাপ আইডি বা COPPA (যেগুলি ঐচ্ছিক) পাঠায় না। এটি MRAID ভার্সন, SDK নাম ও SDK ভার্সন সহ MRAID_ENV অবজেক্টে
প্রয়োজনীয় সব ভেরিয়েবল প্রদান করে।
শ্রবণযোগ্যতা পরিমাপ
অডিও শোনা যাচ্ছে কিনা এবং ভলিউম কখন পরিবর্তন হচ্ছে তা শনাক্ত করতে একটি নতুন ইভেন্ট (audioVolumeChange)
চালু করা হয়েছে।
audioVolumeChange ইভেন্টে একটি প্যারামিটার আছে: volume_percentage.
ভ্যালু হল সর্বাধিক অডিও প্লেব্যাক ভলিউমের শতকরা হার। এটি 0.0 ও 100.0-এর মধ্যে
ফ্লোটিং-পয়েন্ট সংখ্যা (প্লেব্যাক
অনুমোদিত না হলে 0.0) অথবা ভলিউম নির্ধারণ করা না গেলে null।
ব্যবহারের নমুনা দেখতে MRAID v3 স্পেসিফিকেশন দেখুন।
mraid.getLocation()
mraid.getLocation() কাজ করে না বলে, এটি সবসময় -1 রিটার্ন করে।
mraid.unload()
এই পদ্ধতিটি যেকোনও সময় কল করা যেতে পারে এবং SDK বিজ্ঞাপনটি বাতিল করে, রিসোর্স ডিঅ্যালোকেট করে এবং তারপরে ওয়েবভিউ সরিয়ে দেয় বা এটিকে অন্য ডকুমেন্ট বা নতুন বিজ্ঞাপন দিয়ে প্রতিস্থাপন করে প্রতিক্রিয়া জানায়।
ক্রিয়েটিভ কল করলে unload(), বিভিন্ন ধরনের ক্রিয়েটিভের জন্য নেটিভ লেয়ার নিম্নলিখিতভাবে উত্তর দেয়:
| ধরন | unload() আচরণ |
|---|---|
| ব্যানার | বর্তমান বিজ্ঞাপনের মতো একই অনুরোধ প্যারামিটার সহ একটি নতুন বিজ্ঞাপনের অনুরোধ করুন। |
| ইন্টারস্টিশিয়াল | ইন্টারস্টিশিয়াল বন্ধ করুন। |
VPAID (ভিডিও প্লেয়ার বিজ্ঞাপন ইন্টারফেস সংজ্ঞা)
Google Mobile Ads SDK-তে VPAID কাজ করে না। mraid.supports('vpaid')
মিথ্যা রিটার্ন করে।
mraid.useCustomClose()
mraid.useCustomClose() ফর্ম্যাট ও ক্রিয়েটিভ ধরনের উপর নির্ভর করে কাজ নাও করতে পারে।
MRAID v2 প্রয়োগ সংক্রান্ত বিবরণ
mraid.getVersion()
ক্রিয়েটিভ লোড না হওয়া পর্যন্ত mraid.getVersion(), 2.0 রিটার্ন করে না। mraid.getState() loading রিটার্ন করলে MRAID ভার্সন চেক
করবেন না।
mraid.resize()
mraid.resize() কল করা হলে, আসল ব্যানারটি ব্যানারের
স্ক্রিনশট ছবি দিয়ে প্রতিস্থাপন করা হয়। রিসাইজ করা বিজ্ঞাপনটি
আসল বিজ্ঞাপনের জায়গাটি কভার না করলে এটি চোখে পড়ার মতো হয়।
এছাড়াও, রিসাইজ করা বিজ্ঞাপন আসল ব্যানার ফ্রেম মেনে চলে না। কোনও ব্যানার স্ক্রল করা যায় এমন ভিউতে রাখা হলে, রিসাইজ করা বিজ্ঞাপনটি ব্যানারের সাথে স্ক্রল করে না।
mraid.setResizeProperties()
mraid.setResizeProperties()-এ করা সব কলে প্রয়োজনীয় প্রপার্টির
সম্পূর্ণ তালিকা থাকতে হবে। রিসাইজ প্রপার্টি ভুল হলে, সেগুলি ডিফল্ট ভ্যালুতে
ফিরিয়ে আনা হবে এবং সঠিক প্যারামিটার সহ mraid.resize() আবার কল না করা পর্যন্ত
mraid.setResizeProperties()-এ পরবর্তী সব কল ব্যর্থ হবে।
mraid.getMaxSize()
mraid.getMaxSize() শুধুমাত্র রিসাইজ করা
বিজ্ঞাপনের সর্বাধিক সাইজ নির্ধারণ করতে ব্যবহার করা উচিত। এক্সপ্যান্ড করা যায় এমন বিজ্ঞাপনের সাইজ নির্ধারণ করতে, mraid.getScreenSize() ব্যবহার করুন।
mraid.setOrientationProperties()
mraid.setOrientationProperties()-এ কল করার সময় allowOrientationChange
প্রপার্টি true হিসেবে সেট করা থাকলে, forceOrientation প্রপার্টি সেট করে কোনও লাভ হবে না।
যেসব ক্রিয়েটিভ ওরিয়েন্টেশন জোর করে প্রয়োগ করতে চায়, সেগুলিকে allowOrientationChange-এ
false সেট করতে হবে।
mraid.isViewable()
কোনও ভিউ যদি অন্যথায় দৃশ্যমান বিজ্ঞাপনকে ঢেকে দেয়, তাহলেও mraid.isViewable()
true রিটার্ন করবে। অ্যাপ কন্টেন্ট যেন দৃশ্যমান বিজ্ঞাপনকে ঢেকে না দেয়।
mraid.getCurrentPosition()
দুটি অংশ নিয়ে গঠিত বড় করা যায় এমন বিজ্ঞাপন বড় করা অবস্থায় থাকাকালীন, প্রথম অংশে
mraid.getCurrentPosition() কল করলে স্ক্রিনের
সাইজ রিটার্ন করবে।
mraid.storePicture()
কোনও অ্যাপকে mraid.storePicture()-এর সাথে কাজ করতে হলে, সেটিতে
android.permission.WRITE_EXTERNAL_STORAGE অনুমতি থাকতে হবে।