মধ্যস্থতার সাথে InMobi সংহত করুন

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

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
স্থানীয়

প্রয়োজনীয়তা

  • সর্বশেষ Google Mobile Ads Flutter Plugin
  • ফ্লাটার ৩.৭.০ বা উচ্চতর
  • [বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, InMobi-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইন 4.5.0 বা তার উচ্চতর সংস্করণ ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহারের পরামর্শ দেওয়া হচ্ছে )।
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১০.০ বা তার বেশি
  • Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Flutter Plugin সেট আপ করুন’ দেখুন।
  • মধ্যস্থতার ব্যবস্থা করুন

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

একটি ইনমোবি অ্যাকাউন্টের জন্য সাইন আপ করুন

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

একটি অ্যাপ যোগ করুন

আপনার অ্যাপটি InMobi ড্যাশবোর্ডে যোগ করতে, Inventory > Inventory Settings-এ ক্লিক করুন।

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

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

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

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

প্লেসমেন্ট

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

নিলাম

বিজ্ঞাপন ইউনিটের ধরন নির্বাচন করুন। এরপর একটি প্লেসমেন্টের নাম লিখুন, অডিয়েন্স বিডিং এবং পার্টনারের জন্য যথাক্রমে ‘অন’ এবং ‘গুগল ওপেন বিডিং’ নির্বাচন করুন এবং ফর্মের বাকি অংশ পূরণ করুন। কাজ শেষ হলে ‘ক্রিয়েট প্লেসমেন্ট’-এ ক্লিক করুন।

জলপ্রপাত

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

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

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

আপনার InMobi অ্যাকাউন্ট আইডি Finance > Payment Settings > Payment Information -এ পাওয়া যাবে।

InMobi রিপোর্টিং API কী সনাক্ত করুন

নিলাম

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

জলপ্রপাত

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

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

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

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

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

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

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

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

ধাপ ২: অ্যাড ম্যানেজার UI-তে ইনমোবি ডিমান্ড সেট আপ করুন।

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

অ্যান্ড্রয়েড

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

নির্দেশাবলীর জন্য, iOS গাইডের ধাপ ২ দেখুন।

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা সংক্রান্ত বিজ্ঞাপন অংশীদারদের তালিকায় InMobi-কে যুক্ত করুন

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

ধাপ ৩: InMobi SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন

pub.dev এর মাধ্যমে একীকরণ

আপনার প্যাকেজের pubspec.yaml ফাইলে InMobi SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণ সহ নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন:

dependencies:
  gma_mediation_inmobi: ^2.0.1

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

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

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

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

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

InMobi-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটি InMobi SDK-তে সম্মতির তথ্য প্রেরণ সমর্থন করে না।

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

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

InMobi-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটি InMobi SDK-তে সম্মতির তথ্য প্রেরণ সমর্থন করে না।

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

অ্যান্ড্রয়েড

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

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

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

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারে রেজিস্টার করুন এবং ইনমোবি ইউআই-তে টেস্ট মোড চালু করুন

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি InMobi থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে InMobi (Bidding) এবং InMobi (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ঐচ্ছিক পদক্ষেপ

অ্যান্ড্রয়েড

অনুমতি

সর্বোত্তম পারফরম্যান্সের জন্য, 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" />

আপনি চাইলে এই অনুমতিগুলো Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml ফাইলে যোগ করতে পারেন।

আইওএস

iOS ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত পদক্ষেপের প্রয়োজন নেই।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি InMobi থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

অ্যান্ড্রয়েড

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

আইওএস

GADMAdapterInMobi
GADMediationAdapterInMobi

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন InMobi অ্যাডাপ্টার থেকে প্রদর্শিত কোড এবং তার সাথে থাকা বার্তাগুলো নিচে দেওয়া হলো:

অ্যান্ড্রয়েড

ত্রুটি কোড কারণ
০-৯৯ InMobi SDK-তে ত্রুটি। আরও বিস্তারিত জানতে কোড দেখুন।
১০০ অ্যাড ম্যানেজার UI-তে কনফিগার করা InMobi সার্ভার প্যারামিটারগুলো অনুপস্থিত বা অবৈধ।
১০১ InMobi SDK চালু করতে ব্যর্থ হয়েছে।
১০২ অনুরোধ করা বিজ্ঞাপনের আকারটি InMobi সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৩ বিজ্ঞাপনের অনুরোধটি একটি সমন্বিত নেটিভ বিজ্ঞাপনের অনুরোধ নয়।
১০৪ InMobi SDK ইনিশিয়ালাইজ না করেই একটি InMobi বিজ্ঞাপনের জন্য অনুরোধ করার চেষ্টা করা হয়েছে। তত্ত্বগতভাবে এমনটা কখনোই হওয়া উচিত নয়, কারণ অ্যাডাপ্টারটি InMobi বিজ্ঞাপনের জন্য অনুরোধ করার আগেই InMobi SDK ইনিশিয়ালাইজ করে।
১০৫ ইনমোবির বিজ্ঞাপনটি এখনো প্রদর্শনের জন্য প্রস্তুত নয়।
১০৬ InMobi একটি বিজ্ঞাপন প্রদর্শন করতে ব্যর্থ হয়েছে.
১০৭ InMobi এমন একটি নেটিভ বিজ্ঞাপন ফেরত দিয়েছে, যেটিতে একটি প্রয়োজনীয় অ্যাসেট অনুপস্থিত।
১০৮ InMobi-এর নিজস্ব বিজ্ঞাপনের ছবিতে একটি ত্রুটিপূর্ণ URL রয়েছে।
১০৯ অ্যাডাপ্টারটি ইনমোবির নিজস্ব বিজ্ঞাপনের ছবিগুলো ডাউনলোড করতে ব্যর্থ হয়েছে।

আইওএস

ত্রুটি কোড কারণ
১০১ অ্যাড ম্যানেজার UI-তে কনফিগার করা InMobi সার্ভার প্যারামিটারগুলো অনুপস্থিত বা অবৈধ।
১০২ ইনমোবি অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন ফরম্যাটটি সমর্থন করে না।
১০৩ এই নেটওয়ার্ক কনফিগারেশনের জন্য একটি InMobi বিজ্ঞাপন ইতিমধ্যেই লোড হয়ে গেছে।
অন্যান্য InMobi SDK একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে IMRequestStatus.h দেখুন।

ইনমোবি ফ্লাটার মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

সংস্করণ ২.০.২ (নির্মাণাধীন)

সংস্করণ ২.০.১

  • ফ্লাটারের সর্বনিম্ন সংস্করণ ৩.৩৫.১-এ আপডেট করা হয়েছে।
  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 7.0.0 সমর্থন করার জন্য আপডেট করা হয়েছে।

সংস্করণ ২.০.০

সংস্করণ ১.১.৬

সংস্করণ ১.১.৫

সংস্করণ ১.১.৪

সংস্করণ ১.১.৩

সংস্করণ ১.১.২

সংস্করণ ১.১.১

সংস্করণ ১.১.০

সংস্করণ ১.০.০