Google মোবাইল বিজ্ঞাপন SDK-এ এখন MRAID v3-এর জন্য বিটা সমর্থন রয়েছে, MRAID v2-এর জন্য বিদ্যমান সমর্থনের উপর নির্মিত, বিজ্ঞাপনদাতাদের বিজ্ঞাপন ম্যানেজার প্রকাশকদের MRAID v3 ক্রিয়েটিভ পরিবেশন করতে সক্ষম করে৷ এই নির্দেশিকাটি MRAID বাস্তবায়নের বিশদ ব্যাখ্যা করে যা MRAID v3 স্পেকের মধ্যে অস্পষ্ট এবং ব্যাখ্যার জন্য উন্মুক্ত ছিল। এর উদ্দিষ্ট শ্রোতা হল MRAID v3 সৃজনশীল লেখক।
পূর্বশর্ত
প্রকাশকদের অবশ্যই চলমান থাকতে হবে:
- MRAID v3 এর জন্য iOS 7.30.0 বা উচ্চতরের জন্য Google মোবাইল বিজ্ঞাপন SDK
- MRAID v2 এর জন্য iOS 7.4.0 বা উচ্চতরের জন্য Google মোবাইল বিজ্ঞাপন SDK
সহায়ক প্রাইমার
আপনি যদি 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 বৈশিষ্ট্য
MRAID v3 spec- এ সংজ্ঞায়িত SDK প্রারম্ভিক প্রোটোকলের সাথে সঙ্গতিপূর্ণ।
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()
, তখন নেটিভ লেয়ার বিভিন্ন সৃজনশীল প্রকারের জন্য নিম্নরূপ প্রতিক্রিয়া জানায়:
টাইপ | 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.resize()
এর পরবর্তী সমস্ত কলগুলি ব্যর্থ হবে যতক্ষণ না mraid.setResizeProperties()
বৈধ প্যারামিটার সহ পুনরায় কল করা হয়।
mraid.getMaxSize()
mraid.getMaxSize()
শুধুমাত্র রিসাইজ করা বিজ্ঞাপনের সর্বোচ্চ আকার নির্ধারণ করতে ব্যবহার করা উচিত। একটি প্রসারণযোগ্য বিজ্ঞাপনের আকার নির্ধারণ করতে, mraid.getScreenSize()
ব্যবহার করুন।
mraid.setOrientationProperties()
allowOrientationChange
প্রপার্টির সাথে mraid.setOrientationProperties()
কল true
সময়, forceOrientation
প্রপার্টি সেট করা কিছু করবে না। যে সকল ক্রিয়েটিভ অরিয়েন্টেশন জোর করতে চায় তাদের allowOrientationChange
চেঞ্জকে false
সেট করা উচিত।
mraid.isViewable()
যদি একটি ভিউ অন্যভাবে দৃশ্যমান বিজ্ঞাপন কভার করে, mraid.isViewable()
তখনও true
ফিরে আসবে। অ্যাপ কন্টেন্ট দৃশ্যমান বিজ্ঞাপন কভার করা উচিত নয়.
mraid.getCurrentPosition()
একটি টু-পিস প্রসারণযোগ্য বিজ্ঞাপন প্রসারিত অবস্থায় থাকাকালীন, প্রথম অংশে mraid.getCurrentPosition()
এ একটি কল স্ক্রিনের আকার ফিরিয়ে দেবে।
mraid.supports()
SDK সংস্করণ 7.11.0 থেকে শুরু করে, mraid.supports("storePicture")
এবং mraid.supports("calendar")
সর্বদা false
ফেরত দেয়। MRAID v2 স্পেক অনুযায়ী, এই পদ্ধতিগুলি অনুপলব্ধ হলে সৃজনশীলদের কেস পরিচালনা করতে সক্ষম হওয়া উচিত।
mraid.storePicture()
একটি MRAID ক্রিয়েটিভ যখন mraid.storePicture()
কল করে তখন অ্যাপটি স্বয়ংক্রিয়ভাবে একটি ছবি সংরক্ষণ করার অনুমতির অনুরোধ করে।