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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে GMA Next-Gen SDK ব্যবহার করে AdMob মিডিয়েশনের মাধ্যমে InMobi থেকে বিজ্ঞাপন লোড ও প্রদর্শন করা যায়, যেখানে ওয়াটারফল এবং বিডিং উভয় ইন্টিগ্রেশনই অন্তর্ভুক্ত। এতে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে InMobi যোগ করার পদ্ধতি এবং একটি অ্যান্ড্রয়েড অ্যাপে InMobi SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করার পদ্ধতিও আলোচনা করা হয়েছে।

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

InMobi-এর মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

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

• অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি

• [বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, InMobi অ্যাডাপ্টার 10.6.3.0 বা তার উচ্চতর সংস্করণ ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহারের পরামর্শ দেওয়া হচ্ছে )।

• সর্বশেষ GMA Next-Gen SDK

• মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন।

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

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

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

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

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

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

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

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

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

প্লেসমেন্ট

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

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

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

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

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

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

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

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

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

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

ধাপ ২: AdMob UI-তে InMobi ডিমান্ড সেট আপ করুন।

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

আপনার অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে ইনমোবি (InMobi) যোগ করতে হবে।

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, মিডিয়েশন ট্যাবে যান। আপনার যদি আগে থেকে থাকা কোনো মিডিয়েশন গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তবে সেটি সম্পাদনা করার জন্য সেই মিডিয়েশন গ্রুপের নামের উপর ক্লিক করুন এবং সরাসরি 'অ্যাড ইনমোবি অ্যাজ অ্যান অ্যাড সোর্স' অংশে চলে যান।

নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, ‘মধ্যস্থতা গোষ্ঠী তৈরি করুন’ নির্বাচন করুন।

আপনার বিজ্ঞাপনের ধরণ ও প্ল্যাটফর্ম লিখুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের একটি নাম দিন এবং টার্গেট করার জন্য লোকেশন নির্বাচন করুন। এরপর, মিডিয়েশন গ্রুপের স্ট্যাটাস ‘এনাবলড’- এ সেট করুন এবং তারপর ‘অ্যাড অ্যাড ইউনিটস’-এ ক্লিক করুন।

এই মিডিয়েশন গ্রুপটিকে আপনার বিদ্যমান এক বা একাধিক AdMob অ্যাড ইউনিটের সাথে যুক্ত করুন। তারপর 'Done'-এ ক্লিক করুন।

এখন আপনি অ্যাড ইউনিট কার্ডটিতে আপনার নির্বাচিত অ্যাড ইউনিটগুলো দেখতে পাবেন:

বিজ্ঞাপনের উৎস হিসেবে ইনমোবি যোগ করুন

নিলাম

বিডিং কার্ডের অ্যাড সোর্সেস সেকশনে, অ্যাড অ্যাড সোর্স সিলেক্ট করুন। তারপর ইনমোবি (এসডিকে) সিলেক্ট করুন।

InMobi-এর সাথে কীভাবে একটি অংশীদারিত্ব চুক্তি স্বাক্ষর করবেন এবং একটি বিডিং অংশীদারিত্ব স্থাপন করবেন , তা জানতে ক্লিক করুন।



স্বীকৃতি ও সম্মতিতে ক্লিক করুন, তারপর চালিয়ে যান-এ ক্লিক করুন।



আপনার যদি আগে থেকেই InMobi-এর কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, ‘Add mapping’-এ ক্লিক করুন।



এরপর, পূর্ববর্তী ধাপে প্রাপ্ত অ্যাকাউন্ট আইডি এবং প্লেসমেন্ট আইডি প্রবেশ করান। তারপর 'সম্পন্ন' (Done ) বোতামে ক্লিক করুন।

জলপ্রপাত

Ad Sources সেকশনের Waterfall কার্ডের অধীনে, Add Ad Source নির্বাচন করুন।

InMobi নির্বাচন করুন এবং Optimize সুইচটি চালু করুন। InMobi-এর জন্য বিজ্ঞাপন উৎস অপ্টিমাইজেশন সেট আপ করতে পূর্ববর্তী বিভাগে প্রাপ্ত ইউজারনেম এবং এপিআই কী (API Key) প্রবেশ করান। তারপর InMobi-এর জন্য একটি eCPM মান প্রবেশ করান এবং Continue-তে ক্লিক করুন।



আপনার যদি আগে থেকেই InMobi-এর কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, ‘Add mapping’-এ ক্লিক করুন।

এরপর, পূর্ববর্তী ধাপে প্রাপ্ত অ্যাকাউন্ট আইডি এবং প্লেসমেন্ট আইডি প্রবেশ করান। তারপর 'সম্পন্ন' (Done ) বোতামে ক্লিক করুন।

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

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

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

অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)

আপনার অ্যাপ-লেভেলের গ্রেডল ফাইলে নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি এবং কনফিগারেশনগুলো যোগ করুন:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:inmobi:11.1.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:inmobi:11.1.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

1. InMobi Android SDK ডাউনলোড করুন এবং libs ফোল্ডারের অধীনে InMobiSDK.aar ফাইলটি এক্সট্র্যাক্ট করে আপনার প্রজেক্টে যুক্ত করুন।

2. গুগলের মেভেন রিপোজিটরিতে থাকা ইনমোবি অ্যাডাপ্টার আর্টিফ্যাক্টস -এ যান। সর্বশেষ সংস্করণটি নির্বাচন করুন, ইনমোবি অ্যাডাপ্টারের .aar ফাইলটি ডাউনলোড করুন এবং আপনার প্রোজেক্টে যোগ করুন।

3. InMobi-এর জন্য আরও কিছু ডিপেন্ডেন্সি অন্তর্ভুক্ত করা প্রয়োজন। অতিরিক্ত বিবরণের জন্য অনুগ্রহ করে InMobi-এর ডকুমেন্টেশন দেখুন।

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

ইইউ সম্মতি এবং জিডিপিআর

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

সংস্করণ 7.1.0.0-এ, InMobi অ্যাডাপ্টারটি InMobiConsent ক্লাসটি যুক্ত করেছে, যা আপনাকে InMobi-তে সম্মতির তথ্য পাঠাতে দেয়। নিম্নলিখিত নমুনা কোডটি InMobiConsent ক্লাসের updateGDPRConsent() মেথডটিকে কল করে। আপনি যদি এই মেথডটি কল করার সিদ্ধান্ত নেন, GMA Next-Gen SDK মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগেই তা করার পরামর্শ দেওয়া হচ্ছে।

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception)
}

InMobiConsent.updateGDPRConsent(consentObject)

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception);
}

InMobiConsent.updateGDPRConsent(consentObject);

এই কনসেন্ট অবজেক্টে InMobi যে সম্ভাব্য কী এবং ভ্যালুগুলো গ্রহণ করে, সে সম্পর্কে আরও তথ্যের জন্য InMobi-এর GDPR বাস্তবায়নের বিবরণ দেখুন।

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

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

সংস্করণ 10.5.7.1-এ, InMobi অ্যাডাপ্টারটি শেয়ার্ড প্রেফারেন্স থেকে IAB US প্রাইভেসি স্ট্রিং পড়ার সুবিধা যোগ করেছে। শেয়ার্ড প্রেফারেন্সে US প্রাইভেসি স্ট্রিং সেট করতে মার্কিন অঙ্গরাজ্যগুলোর গোপনীয়তা আইন সংক্রান্ত ডকুমেন্টেশনের নির্দেশাবলী অনুসরণ করুন।

এছাড়াও, InMobi ড্যাশবোর্ডে CCPA সেটিংস কীভাবে চালু করতে হয়, সে সম্পর্কিত নির্দেশনার জন্য InMobi-এর CCPA ডকুমেন্টেশন দেখুন।

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

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

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

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

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

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

আপনি 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" />

নেটওয়ার্ক-নির্দিষ্ট পরামিতি

InMobi অ্যাডাপ্টারটি অতিরিক্ত রিকোয়েস্ট প্যারামিটার সমর্থন করে, যেগুলো একটি অ্যান্ড্রয়েড বান্ডেল হিসেবে অ্যাডাপ্টারে পাঠানো যায়। অ্যাডাপ্টারটি বান্ডেলের মধ্যে নিম্নলিখিত কী-গুলো খুঁজে থাকে:

এই বিজ্ঞাপন অনুরোধের প্যারামিটারগুলো কীভাবে সেট করতে হয় তার একটি কোড উদাহরণ নিচে দেওয়া হলো:

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44)
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE)
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44);
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE);
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter.class, extras)
   .build();

• AD_UNIT_ID এর জায়গায় আপনার অ্যাড ইউনিট আইডি বসান।

• AREA_CODE_VALUE এলাকা কোড দিয়ে প্রতিস্থাপন করুন।

নেটিভ বিজ্ঞাপন ব্যবহার করে

বিজ্ঞাপন রেন্ডারিং

InMobi অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনগুলোকে NativeAd অবজেক্ট হিসেবে ফেরত দেয়। এটি একটি NativeAd এর জন্য নিম্নলিখিত নেটিভ বিজ্ঞাপনের ফিল্ডের বিবরণগুলো পূরণ করে।

^{ইনমোবি} অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনের জন্য মূল ইমেজ অ্যাসেটে সরাসরি অ্যাক্সেস দেয় না। পরিবর্তে, অ্যাডাপ্টারটি MediaView একটি ভিডিও বা একটি ছবি যুক্ত করে।

ইম্প্রেশন এবং ক্লিক ট্র্যাকিং

GMA Next-Gen SDK ইম্প্রেশন এবং ক্লিক ট্র্যাকিংয়ের জন্য InMobi SDK-এর কলব্যাক ব্যবহার করে, তাই উভয় ড্যাশবোর্ডের রিপোর্টগুলো প্রায় কোনো অমিল ছাড়াই মিলে যাওয়ার কথা।

ত্রুটি কোড

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

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

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