এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করে মধ্যস্থতা-এর মাধ্যমে InMobi থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, এতে ওয়াটারফল ও বিডিং ইন্টিগ্রেশন, দুটিই কভার করা হয়েছে। এটি বিজ্ঞাপন ইউনিটের মেডিয়েশন কনফিগারেশনে InMobi কীভাবে যোগ করতে হয় এবং React Native অ্যাপে InMobi SDK ও অ্যাডাপ্টার কীভাবে ইন্টিগ্রেট করতে হয় তা কভার করে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| অ্যাপ খোলা | |
| ব্যানার | |
| স্থান | |
| পুরস্কার জিতেছেন | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
| নেটিভ | |
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:
- লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
- React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Android-এ ডিপ্লয় করতে
- Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
- iOS-এ ডিপ্লয় করতে
- iOS ডেপ্লয়মেন্ট টার্গেট 10.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Google Mobile Ads SDK for React Native-এর সাথে কনফিগার করা একটি কার্যকরী React Native প্রোজেক্ট। আরও বিবরণের জন্য
Google Mobile Ads SDK for React Native সেট-আপ করুন দেখুন।
gma-sdk-react-nativeফোল্ডার থেকেadaptersফোল্ডার ডাউনলোড ও এক্সট্র্যাক্ট করেছেন কিনা তা নিশ্চিত করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, Google Mobile Ads SDK for React Native ইনস্টল করুন বিকল্পে গিয়ে এক, দুই ও তিন নম্বর ধাপ অনুসরণ করুন।
- 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 ও অ্যাডাপ্টার ইমপোর্ট করা
আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, InMobi-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি
gma-sdk-react-native/adapters/inmobi/ডিরেক্টরি থেকে আপনার প্রোজেক্টেরlocal_packages/ডিরেক্টরিতে কপি করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/inmobi/gma-mediation-inmobi-0.1.0.tgz local_packages/EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।
আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:
npm
npm install ./local_packages/gma-mediation-inmobi-0.1.0.tgzতন্তু
yarn add ./local_packages/gma-mediation-inmobi-0.1.0.tgz
ধাপ ৪: InMobi SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
InMobi React Native অ্যাডাপ্টার ভার্সন 0.1.0 এবং পরবর্তী ভার্সনগুলি IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্ক (TCF)-এর সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে InMobi SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, জিডিপিআর (GDPR) দেখুন।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।
InMobi-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগ-ইন InMobi SDK-তে সম্মতি সংক্রান্ত তথ্য পাস করা সমর্থন করে না।
ধাপ ৫: প্রয়োজনীয় অতিরিক্ত কোড যোগ করুন
Android
InMobi ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে,
InMobi-এর
ডকুমেন্টেশন
অনুসরণ করুন।
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা এবং InMobi UI-তে টেস্ট মোড চালু করেছেন কিনা তা ভাল করে দেখে নিন।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি InMobi থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, InMobi (বিডিং) এবং InMobi (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ঐচ্ছিক ধাপ
নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার
InMobi অ্যাডাপ্টার নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার সেট করার জন্য বিজ্ঞাপনের অনুরোধে
একটি
InMobiMediationExtras
অবজেক্ট পাস করাকে সমর্থন করে। উপলভ্য প্যারামিটার সম্পর্কে আরও
জানতে,
InMobi রেফারেন্স ডকুমেন্টেশন দেখুন।
InMobi-এর জন্য টার্গেটিং ও লগিং প্যারামিটার কীভাবে কনফিগার করতে হয় তা নিম্নলিখিত স্যাম্পেল কোড থেকে জানতে পারবেন:
import {
InMobiMediationExtras,
InMobiAgeGroup,
InMobiEducation,
InMobiLogLevel,
} from '@google/gma-mediation-inmobi';
const request = {
// ...
mediationExtras: [
new InMobiMediationExtras({
ageGroup: InMobiAgeGroup.BETWEEN_25_AND_29,
education: InMobiEducation.COLLEGE_OR_GRADUATE,
logLevel: InMobiLogLevel.DEBUG,
age: 25,
postalCode: '12345',
areaCode: '678',
language: 'en',
city: 'NY',
state: 'NY',
country: 'US',
interests: 'sports',
}),
],
};
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 দেখুন। |
ভার্সন 0.1.0
- প্রাথমিক রিলিজ।
- InMobi Android অ্যাডাপ্টার ভার্সন 11.4.1.2 কাজ করে।
- InMobi iOS অ্যাডাপ্টার ভার্সন 11.4.1.0 কাজ করে।
- Google Mobile Ads React Native প্লাগ-ইন ভার্সন 0.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।