Google মোবাইল বিজ্ঞাপন SDK-তে এখন MRAID v3-এর জন্য বিটা সাপোর্ট রয়েছে, যা MRAID v2-এর জন্য বিদ্যমান সাপোর্টের উপর ভিত্তি করে তৈরি, যা বিজ্ঞাপনদাতাদের 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 ইভেন্টের পরিবর্তে একটি শ্রোতা ব্যবহার করার পরামর্শ দিচ্ছি। mraid.isViewable() পদ্ধতিটিও অবচিত। তবে ব্যাকওয়ার্ড সামঞ্জস্য বজায় রাখার জন্য এই অবচিত পদ্ধতিগুলি এখনও সমর্থিত।
বিজ্ঞাপনের ভিউ পরিবর্তন হলেই exposureChange ইভেন্টের সংজ্ঞা পাঠানো হয়। SDK-তে একটি পোলিং মেকানিজম রয়েছে যাতে অনেক বেশি ইভেন্ট তৈরি না হয়। বিজ্ঞাপনটি একজন শ্রোতাকে নিবন্ধন করার পরে প্রাথমিক অবস্থা অ্যাসিঙ্ক্রোনাসভাবে পাঠানো হয়। কলব্যাকে exposed_percentage প্যারামিটার অন্তর্ভুক্ত থাকে যা 0.0 এবং 100.0 এর মধ্যে একটি ফ্লোটিং-পয়েন্ট নম্বর।
নমুনা ব্যবহারের জন্য MRAID v3 স্পেসিফিকেশন দেখুন।
MRAID সনাক্তকরণ এবং আরম্ভকরণ এবং MRAID_ENV বৈশিষ্ট্য
SDK MRAID v3 স্পেসিফিকেশনে সংজ্ঞায়িত ইনিশিয়ালাইজেশন প্রোটোকল মেনে চলে।
MRAID_ENV অবজেক্টে, SDK IDFA , limitAdTracking , App ID, অথবা 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() , তখন বিভিন্ন সৃজনশীল ধরণের জন্য নেটিভ লেয়ারটি নিম্নরূপ প্রতিক্রিয়া জানায়:
| আদর্শ | আনলোড() আচরণ |
|---|---|
| ব্যানার | বর্তমান বিজ্ঞাপনের মতো একই অনুরোধের প্যারামিটার ব্যবহার করে একটি নতুন বিজ্ঞাপন অনুরোধ করুন। |
| ইন্টারস্টিশিয়াল | ইন্টারস্টিশিয়ালটি বন্ধ করুন। |
VPAID (ভিডিও প্লেয়ার বিজ্ঞাপন ইন্টারফেসের সংজ্ঞা)
গুগল মোবাইল বিজ্ঞাপন SDK VPAID সমর্থন করে না। mraid.supports('vpaid') মিথ্যা প্রদান করে।
mraid.use কাস্টম ক্লোজ()
mraid.useCustomClose() সমর্থিত নাও হতে পারে, এটি ফর্ম্যাট এবং সৃজনশীল ধরণের উপর নির্ভর করে।
MRAID v2 বাস্তবায়নের বিশদ বিবরণ
mraid.getVersion()
mraid.getVersion() ক্রিয়েটিভ লোড না হওয়া পর্যন্ত 2.0 রিটার্ন করে না। mraid.getState() loading রিটার্ন করার সময় MRAID ভার্সনটি চেক করবেন না।
mraid.resize()
যখন mraid.resize() কল করা হয়, তখন মূল ব্যানারটি ব্যানারের স্ক্রিনশট চিত্র দিয়ে প্রতিস্থাপিত হয়। যদি আকার পরিবর্তন করা বিজ্ঞাপনটি মূল বিজ্ঞাপনের স্থানটি কভার না করে তবে এটি লক্ষণীয়।
আকার পরিবর্তন করা বিজ্ঞাপনগুলিও মূল ব্যানার ফ্রেম অনুসরণ করে না। যদি একটি ব্যানার স্ক্রলিং ভিউতে স্থাপন করা হয়, তাহলে আকার পরিবর্তন করা বিজ্ঞাপনটি ব্যানারের সাথে স্ক্রোল করবে না।
mraid.setResizeProperties()
mraid.setResizeProperties() এ করা সকল কলে প্রয়োজনীয় বৈশিষ্ট্যের একটি সম্পূর্ণ তালিকা থাকা উচিত। যদি resize বৈশিষ্ট্যগুলি অবৈধ হয়, তাহলে সেগুলি তাদের ডিফল্টে সেট করা হবে এবং 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.storeছবি()
একটি অ্যাপ mraid.storePicture() সমর্থন করার জন্য, এতে android.permission.WRITE_EXTERNAL_STORAGE অনুমতি অন্তর্ভুক্ত করতে হবে।