Google Mobile Ads SDK-তে এখন MRAID v3-এর জন্য বিটা সাপোর্ট আছে, যা MRAID v2-এর জন্য আগে থেকে থাকা সাপোর্টের উপর তৈরি করা হয়েছে, এর ফলে বিজ্ঞাপনদাতারা Ad Manager প্রকাশকদের MRAID v3 ক্রিয়েটিভ দেখাতে পারবেন। এই নির্দেশিকা MRAID প্রয়োগের বিবরণ স্পষ্ট করে যা MRAID v3 স্পেক-এ অস্পষ্ট এবং ব্যাখ্যার জন্য উন্মুক্ত ছিল। এর উদ্দিষ্ট দর্শক হল MRAID v3 ক্রিয়েটিভ লেখক।
পূর্বশর্ত
প্রকাশকদের অবশ্যই এগুলি চালাতে হবে:
সহায়ক প্রাইমার
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_ENV অবজেক্টে MRAID ভার্সন, SDK-এর নাম ও SDK ভার্সন সহ
প্রয়োজনীয় সব ভেরিয়েবল প্রদান করে।
শ্রবণযোগ্যতা পরিমাপ
অডিও শোনা যাচ্ছে কিনা এবং কখন ভলিউম পরিবর্তন হচ্ছে তা শনাক্ত করতে একটি নতুন ইভেন্ট (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 মোবাইল বিজ্ঞাপন 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.setResizeProperties() সঠিক প্যারামিটার সহ আবার কল না করা পর্যন্ত
mraid.resize()-এ পরবর্তী সব কল ব্যর্থ হবে।
mraid.getMaxSize()
mraid.getMaxSize() শুধুমাত্র সাইজ পরিবর্তন করা বিজ্ঞাপনের সর্বাধিক সাইজ নির্ধারণ করার জন্য ব্যবহার করা
উচিত। বড় করা যায় এমন বিজ্ঞাপনের সাইজ নির্ধারণ করতে, mraid.getScreenSize() ব্যবহার করুন।
mraid.setOrientationProperties()
allowOrientationChange প্রপার্টি true-এ সেট করে mraid.setOrientationProperties() কল করার সময়, forceOrientation প্রপার্টি সেট করলে কোনও কাজ হবে না।
যেসব ক্রিয়েটিভ ওরিয়েন্টেশন পরিবর্তন করতে চায়, তাদের allowOrientationChange-কে
false-এ সেট করতে হবে।
mraid.isViewable()
কোনও ভিউ যদি অন্য কোনও দৃশ্যমান বিজ্ঞাপনকে ঢেকে দেয়, তাহলে mraid.isViewable() এখনও
true রিটার্ন করবে। অ্যাপের কন্টেন্ট যেন দৃশ্যমান বিজ্ঞাপনকে ঢেকে না দেয়।
mraid.getCurrentPosition()
দুটি অংশ নিয়ে গঠিত বড় করা যায় এমন বিজ্ঞাপন বড় করা অবস্থায় থাকলে, প্রথম অংশে mraid.getCurrentPosition()-এ কল করলে স্ক্রিনের সাইজ
ফেরত পাওয়া যাবে।
mraid.storePicture()
কোনও অ্যাপে mraid.storePicture() কাজ করার জন্য, সেটিতে android.permission.WRITE_EXTERNAL_STORAGE অনুমতি
অন্তর্ভুক্ত করতে হবে।