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

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

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

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

পূর্বশর্ত

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

  • লেটেস্ট Google Mobile Ads Flutter Plugin ভার্সন।
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরের ভার্সন।
  • 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 Key জেনারেট করুন বিকল্পে ক্লিক করুন। API কী এবং ইউজারনেম/লগ-ইন নাম সহ একটি ফাইল তৈরি করা হবে।

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

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

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

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

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

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

    ধাপ ২: 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.4.0

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

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

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

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

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

    InMobi Flutter অ্যাডাপ্টার ভার্সন 1.1.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্ক (TCF)-এর সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে InMobi SDK-তে জিডিপিআর কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, জিডিপিআর (GDPR) দেখুন।

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

    মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে 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.4.0

    ভার্সন 2.3.3

    ভার্সন 2.3.2

    ভার্সন 2.3.1

    ভার্সন 2.3.0

    ভার্সন 2.2.0

    ভার্সন 2.1.0

    ভার্সন ২.০.১

    • Flutter-এর ন্যূনতম ভার্সন 3.35.1-এ আপডেট করা হয়েছে
    • Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৭.০.০-এর সাথে কাজ করার জন্য আপডেট করা হয়েছে

    ভার্সন 2.0.0

    ভার্সন 1.1.6

    ভার্সন 1.1.5

    ভার্সন ১.১.৪

    ভার্সন ১.১.৩

    ভার্সন ১.১.২

    ভার্সন ১.১.১

    ভার্সন 1.1.0

    ভার্সন 1.0.0