মেডিয়েশনের সাথে InMobi ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

এই নির্দেশিকা আপনাকে দেখায় যে কীভাবে মধ্যস্থতা ব্যবহার করে InMobi থেকে বিজ্ঞাপন লোড ও দেখাতে Google Mobile Ads Flutter Plugin হয়। এর মধ্যে ওয়াটারফল ও বিডিং ইন্টিগ্রেশন দুটিই অন্তর্ভুক্ত। এতে কীভাবে কোনও বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে InMobi যোগ করতে হয় এবং কীভাবে Flutter অ্যাপে InMobi SDK ও অ্যাডাপ্টর ইন্টিগ্রেট করতে হয় তা বলা আছে।

কাজ করে এমন ইন্টিগ্রেশন ও বিজ্ঞাপন ফর্ম্যাট

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
অ্যাপ ওপেন
ব্যানার
স্থান
পুরস্কার জিতেছেন
পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল
নেটিভ

পূর্বশর্ত

এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করিয়ে নিন:

  • Google Mobile Ads Flutter Plugin-এর লেটেস্ট ভার্সন।
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডেপ্লয় করতে
    • Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • iOS-এ ডেপ্লয় করতে
    • iOS-এর ডিপ্লয়মেন্ট টার্গেট 10.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি চালু Flutter প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ Google Mobile Ads Flutter Plugin দেখুন।
  • AdMob মধ্যস্থতা সেট-আপ করুন।

ধাপ ১: InMobi UI-তে কনফিগারেশন সেট-আপ করুন

InMobi অ্যাকাউন্টের জন্য সাইন-আপ করুন।

আপনার অ্যাকাউন্ট যাচাই করা হয়ে গেলে, লগ-ইন করুন।

অ্যাপ যোগ করুন

InMobi ড্যাশবোর্ডে আপনার অ্যাপ যোগ করতে, ইনভেনটরি > ইনভেনটরি সেটিংস বিকল্পে ক্লিক করুন।

ইনভেনটরি যোগ করুন বিকল্পে ক্লিক করুন এবং ড্রপ-ডাউন মেনু থেকে মোবাইল অ্যাপ চ্যানেল বেছে নিন।

সার্চ বারে আপনার প্রকাশিত অ্যাপ স্টোরের URL টাইপ করা শুরু করুন এবং অটো-ফিল করা ফলাফল থেকে অ্যাপটি বেছে নিন। চালিয়ে যান বিকল্পে ক্লিক করুন।

আপনার অ্যাপ প্রকাশ করা না হয়ে থাকলে, ম্যানুয়ালি লিঙ্ক করুন বিকল্পে ক্লিক করুন এবং প্রয়োজনীয় বিবরণ লিখুন। চালিয়ে যান বিকল্পে ক্লিক করুন।

অ্যাপ ও ওয়েবসাইট কম্প্লায়েন্স সেটিংস পর্যালোচনা করুন এবং তারপরে সেভ করুন এবং প্লেসমেন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

অবস্থানগুলি:

আপনি ইনভেনটরি সেট-আপ করার পরে, সিস্টেম আপনাকে প্লেসমেন্ট তৈরির ওয়ার্কফ্লোতে রিডাইরেক্ট করে।

বিডিং

বিজ্ঞাপন ইউনিটের ধরন বেছে নিন। তারপর প্লেসমেন্টের নাম লিখুন, দর্শক বিডিং ও পার্টনার এর জন্য যথাক্রমে চালু করুন ও Google SDK বিডিং বিকল্প বেছে নিন এবং ফর্মের বাকি অংশ পূরণ করুন। হয়ে গেলে প্লেসমেন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

জলপ্রপাত

বিজ্ঞাপন ইউনিটের ধরন বেছে নিন। তারপর প্লেসমেন্টের নাম লিখুন, অডিয়েন্স বিডিংয়ের জন্য বন্ধ বিকল্প বেছে নিন এবং ফর্মের বাকি অংশ পূরণ করুন। হয়ে গেলে, প্লেসমেন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

প্লেসমেন্ট তৈরি হয়ে গেলে, এর বিবরণ দেখানো হয়। প্লেসমেন্ট আইডি মনে রাখবেন, এটি আপনার AdMob বিজ্ঞাপন ইউনিট সেট-আপ করার জন্য ব্যবহার করা হবে।

অ্যাকাউন্ট আইডি

আপনার InMobi অ্যাকাউন্ট আইডি ফাইন্যান্স > পেমেন্ট সেটিংস > পেমেন্ট সংক্রান্ত তথ্য বিকল্পের মধ্যে উপলভ্য।

InMobi রিপোর্টিং API Key খুঁজে বের করা

বিডিং

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন হয় না।

জলপ্রপাত

আমার অ্যাকাউন্ট > অ্যাকাউন্ট সেটিংস বিকল্পে যান। API Key ট্যাবে নেভিগেট করুন এবং API Key তৈরি করুন বিকল্পে ক্লিক করুন।

যে ব্যবহারকারীর জন্য কী প্রয়োজন তার ইমেল বেছে নিন এবং API কী জেনারেট করুন বিকল্পে ক্লিক করুন। API কী ও ইউজারনেম/লগ-ইন নাম সহ একটি ফাইল তৈরি করা হবে ।

অ্যাকাউন্টের প্রকাশকের অ্যাডমিনিস্ট্রেটরই শুধুমাত্র সব ব্যবহারকারীর জন্য API কী তৈরি করতে পারবেন। আগে তৈরি করা API key ভুলে গেলে, API Key ট্যাবে আপনার ইমেলের উপরে মাউস নিয়ে গিয়ে API key রিসেট করুন।

আপনার app-ads.txt আপডেট করা

অ্যাপের জন্য অনুমোদিত বিক্রেতা app-ads.txt হল একটি IAB টেক ল্যাব ইনিশিয়েটিভ যা কনফার্ম করতে সাহায্য করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেনটরি আপনি যাদের অনুমোদিত হিসেবে শনাক্ত করেছেন, শুধুমাত্র সেইসব চ্যানেলের মাধ্যমেই বিক্রি করা কনফার্ম করতে সাহায্য করে। বিজ্ঞাপন থেকে হওয়া উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। আপনি আগে থেকে এটি না করে থাকলে, আপনার অ্যাপের জন্য একটি app-ads.txt ফাইল সেট-আপ করুন।

app-ads.txt প্রয়োগ করতে, InMobi-এর জন্য, আপনার পছন্দমতো কোড স্নিপেট যোগ করুন।

টেস্ট মোড চালু করা

সব লাইভ ইম্প্রেশন বা শুধুমাত্র নির্দিষ্ট টেস্ট ডিভাইসের জন্য আপনার প্লেসমেন্টে টেস্ট মোড চালু করুন।

ধাপ ২: AdMob UI-তে InMobi চাহিদা সেট-আপ করুন

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করা

Android

নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

iOS

নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

জিডিপিআর (GDPR) ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনার তালিকায় InMobi যোগ করা

AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনার তালিকায় InMobi যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করুন।

ধাপ ৩: InMobi SDK ও অ্যাডাপ্টার ইমপোর্ট করা

pub.dev-এর মাধ্যমে ইন্টিগ্রেশন

আপনার প্যাকেজের pubspec.yaml ফাইলে InMobi SDK ও অ্যাডাপ্টরের লেটেস্ট ভার্সনের সাথে নিম্নলিখিত নির্ভরতা যোগ করুন:

dependencies:
  gma_mediation_inmobi: ^2.3.3

ম্যানুয়াল ইন্টিগ্রেশন

এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন: InMobi, ডাউনলোড করা ফাইল এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগ-ইন ফোল্ডার (ও এর কন্টেন্ট) আপনার Flutter প্রোজেক্টে যোগ করুন। তারপর, নিম্নলিখিত ডিপেন্ডেন্সি যোগ করে আপনার pubspec.yaml ফাইলে প্লাগ-ইনটি রেফারেন্স করুন:

dependencies:
  gma_mediation_inmobi:
    path: path/to/local/package

ধাপ ৪: InMobi SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা

Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডে বসবাসকারী ব্যবহারকারীদের কাছে নির্দিষ্ট কিছু তথ্য প্রকাশ করতে হবে এবং আইনত প্রয়োজনীয় হলে কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য তাদের সম্মতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রেরণ করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।

InMobi Flutter মধ্যস্থতা প্লাগ-ইন ভার্সন 1.1.0 থেকে শুরু করে, InMobi অটোমেটিক GDPR সম্মতি পড়ে যা সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা সেট করা হয় যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন, সাপোর্ট করে যার মধ্যে UMP SDK অন্তর্ভুক্ত। আরও তথ্যের জন্য, Android ও iOS-এর জন্য SDK ইনিশিয়ালাইজ করা সংক্রান্ত InMobi-র ডকুমেন্টেশন দেখুন।

মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের গোপনীয়তা আইন

মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের গোপনীয়তা আইন ব্যবহারকারীদের অধিকার দেয় যে তারা তাদের "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প থেকে অপ্ট-আউট করতে পারবেন (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত করা হয়েছে)। অপ্ট-আউট করার এই বিকল্প "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google-এর বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রসেসিং চালু করার সুবিধা দেয়, কিন্তু Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মধ্যস্থতা চেনে এমন প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে আপনাকে শনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রি করার কাজে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের নির্দেশিকা মেনে চলতে হবে।

InMobi-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইন InMobi SDK-তে সম্মতি সংক্রান্ত তথ্য পাস করার সুবিধা দেয় না।

ধাপ ৫: প্রয়োজনীয় অতিরিক্ত কোড যোগ করুন

Android

InMobi ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোড প্রয়োজন নেই।

iOS

SKAdNetwork ইন্টিগ্রেশন

আপনার প্রজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, InMobi-এর ডকুমেন্টেশন অনুসরণ করুন।

ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

টেস্ট বিজ্ঞাপন চালু করা

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন এবং InMobi UI-তে টেস্ট মোড চালু করেছেন কিনা তা ভাল করে দেখে নিন।

টেস্ট বিজ্ঞাপন যাচাই করা

আপনি যে InMobi-এর থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন। এর জন্য InMobi (বিডিং) ও InMobi (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করুন।

ঐচ্ছিক ধাপ

Android

অনুমতি

অপ্টিমাল পারফর্ম্যান্সের জন্য, InMobi আপনার অ্যাপের AndroidManifest.xml ফাইলে নিম্নলিখিত ঐচ্ছিক অনুমতি যোগ করার সাজেশন দেয়।

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

iOS

iOS ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও ধাপের প্রয়োজন নেই।

সমস্যার কোড

অ্যাডাপ্টার InMobi-এর থেকে বিজ্ঞাপন না পেলে, প্রকাশকরা নিচের ক্লাস থেকে ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে আসল সমস্যা চেক করতে পারবেন:

Android

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

কোনও বিজ্ঞাপন লোড করা না গেলে InMobi অ্যাডাপ্টার এইসব কোড ও সংশ্লিষ্ট মেসেজ দেখায়:

Android

সমস্যার কোড কারণ
0-99 InMobi SDK সংক্রান্ত সমস্যা। আরও বিবরণের জন্য কোড দেখুন।
100 AdMob UI-তে কনফিগার করা InMobi সার্ভার প্যারামিটার নেই/ভুল।
১০১ InMobi SDK চালু করা যায়নি।
102 অনুরোধ করা বিজ্ঞাপনের সাইজ InMobi-তে কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
103 বিজ্ঞাপনের অনুরোধ ইউনিফায়েড নেটিভ বিজ্ঞাপন অনুরোধ নয়।
104 InMobi SDK চালু না করেই InMobi বিজ্ঞাপনের অনুরোধ করা হয়েছে। এটি তত্ত্বগতভাবে কখনই হওয়া উচিত নয়, কারণ InMobi বিজ্ঞাপন অনুরোধ করার আগে অ্যাডাপ্টার InMobi SDK ইনিশিয়ালাইজ করে।
১০৫ InMobi-এর বিজ্ঞাপন এখনও দেখানোর জন্য রেডি নয়।
106 InMobi বিজ্ঞাপন দেখাতে পারেনি।
107 InMobi একটি নেটিভ বিজ্ঞাপন রিটার্ন করেছে যাতে একটি প্রয়োজনীয় অ্যাসেট নেই।
108 InMobi-এর নেটিভ বিজ্ঞাপনের ইমেজ অ্যাসেটে ভুল URL আছে।
১০৯ অ্যাডাপ্টার InMobi-এর নেটিভ বিজ্ঞাপন ছবির অ্যাসেট ডাউনলোড করতে পারেনি।

iOS

সমস্যার কোড কারণ
১০১ AdMob UI-তে কনফিগার করা InMobi সার্ভার প্যারামিটার নেই/ভুল।
102 অনুরোধ করা বিজ্ঞাপনের সাইজ InMobi-তে কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
103 এই নেটওয়ার্ক কনফিগারেশনের জন্য একটি InMobi বিজ্ঞাপন আগেই লোড করা হয়েছে।
104 InMobi নেটিভ বিজ্ঞাপন, অনুপস্থিত নেটিভ অ্যাসেট সহ রিটার্ন করেছে অথবা প্রয়োজনীয় ছবি যুক্ত অ্যাসেট ডাউনলোড করা যায়নি।
১০৫ InMobi বিজ্ঞাপন দেখানোর জন্য রেডি নয়।
106 InMobi-এর তরফ থেকে খালি বা শূন্য বিড টোকেন রিটার্ন করা হয়।
অন্যান্য InMobi SDK-তে সমস্যা হয়েছে। আরও বিবরণের জন্য IMRequestStatus.h দেখুন।

InMobi Flutter মেডিয়েশন অ্যাডাপ্টার পরিবর্তন লগ

ভার্সন 2.3.3

ভার্সন 2.3.2

ভার্সন 2.3.1

ভার্সন 2.3.0

ভার্সন 2.2.0

ভার্সন 2.1.0

ভার্সন 2.0.1

  • Flutter-এর ন্যূনতম ভার্সন 3.35.1-এ আপডেট করা হয়েছে
  • Google Mobile Ads Flutter Plugin-এর 7.0.0 ভার্সন কাজ করে এমনভাবে আপডেট করা হয়েছে

ভার্সন 2.0.0

ভার্সন ১.১.৬

ভার্সন 1.1.5

ভার্সন 1.1.4

ভার্সন 1.1.3

ভার্সন 1.1.2

ভার্সন 1.1.1

ভার্সন 1.1.0

ভার্সন 1.0.0