এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে AdMob Mediation ব্যবহার করে Chartboost থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে GMA Next-Gen SDK ব্যবহার করতে হয়, যা ওয়াটারফল ইন্টিগ্রেশনগুলিকে অন্তর্ভুক্ত করে। এটি একটি বিজ্ঞাপন ইউনিটের মেডিয়েশন কনফিগারেশনে Chartboost কীভাবে যুক্ত করতে হয় এবং একটি Android অ্যাপে Chartboost SDK এবং অ্যাডাপ্টার কীভাবে সংহত করতে হয় তা কভার করে।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
চার্টবুস্টের জন্য মেডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
| স্থানীয় | |
আবশ্যকতা
- অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি
সর্বশেষ GMA Next-Gen SDK
মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন
ধাপ ১: চার্টবুস্ট UI-তে কনফিগারেশন সেট আপ করুন
একটি Chartboost অ্যাকাউন্টের জন্য সাইন আপ করুন এবং আপনার অ্যাকাউন্ট যাচাই হয়ে গেলে লগ ইন করুন । তারপর, অ্যাপস ম্যানেজমেন্ট ট্যাবে যান।

আপনার অ্যাপ তৈরি করতে নতুন অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

বাকি ফর্মটি পূরণ করুন এবং আপনার অ্যাপটি চূড়ান্ত করতে অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

আপনার অ্যাপ তৈরি হয়ে গেলে, আপনাকে এর ড্যাশবোর্ডে নিয়ে যাওয়া হবে। আপনার অ্যাপের অ্যাপ আইডি এবং অ্যাপ স্বাক্ষরটি নোট করুন।

আপনার AdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য AdMob-এর Chartboost ব্যবহারকারী আইডি এবং ব্যবহারকারীর স্বাক্ষর প্রয়োজন। আপনি Chartboost UI-তে Chartboost মধ্যস্থতা ক্লিক করে এই প্যারামিটারগুলি খুঁজে পেতে পারেন।

রিসোর্সেস > এপিআই এক্সপ্লোরার ট্যাবে যান এবং প্রমাণীকরণ বিভাগের অধীনে অবস্থিত আপনার ব্যবহারকারী আইডি এবং ব্যবহারকারীর স্বাক্ষরটি নোট করুন।

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

আপনার অ্যাপের সেটিংস থেকে, আপনি আপনার অ্যাপে টেস্ট মোড টগল করতে পারেন।

একবার পরীক্ষা মোড সক্ষম হয়ে গেলে, আপনি আগে তৈরি বিজ্ঞাপন ইউনিট আইডি ব্যবহার করে বিজ্ঞাপনের অনুরোধ করতে পারেন এবং একটি চার্টবুস্ট পরীক্ষা বিজ্ঞাপন পেতে পারেন।
Chartboost পরীক্ষার বিজ্ঞাপন পাওয়ার পর, আপনার অ্যাপটি Chartboost-এর Publisher App Review- এ রাখা হবে। Chartboost-এ নগদীকরণ কাজ করার জন্য, প্রকাশক অ্যাপ পর্যালোচনাটি Chartboost দ্বারা অনুমোদিত হতে হবে।
ধাপ ২: AdMob UI তে Chartboost চাহিদা সেট আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
আপনার বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে Chartboost যোগ করতে হবে।
প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, "মধ্যস্থতা" ট্যাবে যান। যদি আপনার কাছে এমন কোনও মধ্যস্থতা গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তাহলে সেই মধ্যস্থতা গ্রুপের নামে ক্লিক করে এটি সম্পাদনা করুন এবং "চার্টবুস্টকে বিজ্ঞাপন উৎস হিসেবে যোগ করুন" এ যান ।
একটি নতুন মধ্যস্থতা গ্রুপ তৈরি করতে, মধ্যস্থতা গ্রুপ তৈরি করুন নির্বাচন করুন।

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

আপনার মধ্যস্থতা গোষ্ঠীর একটি নাম দিন এবং লক্ষ্য করার জন্য অবস্থানগুলি নির্বাচন করুন। এরপর, মধ্যস্থতা গোষ্ঠীর স্থিতি সক্ষম করুন তে সেট করুন, এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন এ ক্লিক করুন।

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

এখন আপনার নির্বাচিত বিজ্ঞাপন ইউনিটগুলি দিয়ে বিজ্ঞাপন ইউনিট কার্ডটি পূর্ণ দেখতে পাবেন:

বিজ্ঞাপনের উৎস হিসেবে Chartboost যোগ করুন
বিজ্ঞাপন উৎস বিভাগের ওয়াটারফল কার্ডের অধীনে, বিজ্ঞাপন উৎস যোগ করুন নির্বাচন করুন।
Chartboost নির্বাচন করুন এবং Optimize সুইচটি সক্রিয় করুন। Chartboost-এর জন্য বিজ্ঞাপন উৎস অপ্টিমাইজেশন সেট আপ করতে পূর্ববর্তী বিভাগে প্রাপ্ত ব্যবহারকারী আইডি এবং ব্যবহারকারীর স্বাক্ষর লিখুন। তারপর Chartboost-এর জন্য একটি eCPM মান লিখুন এবং Continue এ ক্লিক করুন।

যদি আপনার ইতিমধ্যেই Chartboost-এর জন্য একটি ম্যাপিং থাকে, তাহলে আপনি এটি নির্বাচন করতে পারেন। অন্যথায়, Add maping এ ক্লিক করুন।

এরপর, পূর্ববর্তী বিভাগে প্রাপ্ত অ্যাপ আইডি , অ্যাপ স্বাক্ষর এবং বিজ্ঞাপনের অবস্থান লিখুন। তারপর সম্পন্ন ক্লিক করুন।

চার্টবুস্ট বিজ্ঞাপন অবস্থান ( নামযুক্ত অবস্থান ) হল আপনার অ্যাপের এমন একটি স্থানের সহজ নাম যেখানে আপনি একটি বিজ্ঞাপন দেখাতে চান। অ্যাডমব সেটিংসে নির্দিষ্ট স্থানে অনুরোধ পাঠায়। অনুরোধ পাঠানো হয়ে গেলে, চার্টবুস্ট রিপোর্টিংয়ের উদ্দেশ্যে অবস্থানটি তার প্ল্যাটফর্মে যুক্ত করে। ব্যবহারকারীরা তাদের গেমগুলিতে কল করার আগে সরাসরি চার্টবুস্ট প্ল্যাটফর্মে নতুন বিজ্ঞাপন অবস্থান তৈরি করার ক্ষমতাও রাখে।
Chartboost UI-তে, Advanced Settings-এ ক্লিক করে আপনার বিজ্ঞাপনের অবস্থানগুলি বেসিক সেটিংস পৃষ্ঠায় প্রকাশ করা যেতে পারে। আরও বিস্তারিত জানার জন্য Chartboost-এর [Named Locations](//docs.chartboost.com/en/monetization/publishing/ad-locations/) নির্দেশিকা দেখুন।
অবশেষে, বিজ্ঞাপন উৎস হিসেবে Chartboost যোগ করতে Done এ ক্লিক করুন, এবং তারপর Save এ ক্লিক করুন।
GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালার বিজ্ঞাপন অংশীদারদের তালিকায় Chartboost যোগ করুন
AdMob UI-তে ইউরোপীয় এবং মার্কিন যুক্তরাষ্ট্রের রাজ্যের নিয়ন্ত্রণ বিজ্ঞাপন অংশীদারদের তালিকায় Chartboost যোগ করতে ইউরোপীয় নিয়ন্ত্রণ সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের রাজ্যের নিয়ন্ত্রণ সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ ৩: চার্টবুস্ট SDK এবং অ্যাডাপ্টার আমদানি করুন
অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)
আপনার প্রজেক্ট-লেভেল settings.gradle.kts ফাইলে, নিম্নলিখিত সংগ্রহস্থলগুলি যোগ করুন:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
}
}
}
আপনার অ্যাপ-লেভেল গ্রেডল ফাইলে, নিম্নলিখিত বাস্তবায়ন নির্ভরতা এবং কনফিগারেশন যোগ করুন:
কোটলিন
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.google.ads.mediation:chartboost:9.11.1.0") } 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.24.0-beta02' implementation 'com.google.ads.mediation:chartboost:9.11.1.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
ম্যানুয়াল ইন্টিগ্রেশন
Maven Central থেকে Chartboost SDK এর সর্বশেষ সংস্করণের
.aarফাইলটি ডাউনলোড করুন এবং এটি আপনার প্রকল্পে যুক্ত করুন।গুগলের ম্যাভেন রিপোজিটরিতে চার্টবুস্ট অ্যাডাপ্টার আর্টিফ্যাক্টগুলিতে নেভিগেট করুন। সর্বশেষ সংস্করণটি নির্বাচন করুন, চার্টবুস্ট অ্যাডাপ্টারের
.aarফাইলটি ডাউনলোড করুন এবং এটি আপনার প্রকল্পে যুক্ত করুন।
ধাপ ৪: Chartboost SDK-তে গোপনীয়তা সেটিংস বাস্তবায়ন করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডের ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং আইনত প্রয়োজনে কুকিজ বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, ভাগ করে নেওয়া এবং ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণ (GDPR) এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে। আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পাঠানো হয়েছে কিনা তা যাচাই করার জন্য আপনার দায়িত্ব। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতি পছন্দ প্রেরণ করতে অক্ষম।
SDK সংস্করণ 8.1.0-এ, Chartboost addDataUseConsent() পদ্ধতি যোগ করেছে। নিম্নলিখিত নমুনা কোডটি NON_BEHAVIORAL তে ডেটা ব্যবহারের সম্মতি সেট করে। আপনি যদি এই পদ্ধতিটি কল করতে চান, GMA Next-Gen SDK মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হচ্ছে।
জাভা
DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);
কোটলিন
val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)
আরও বিস্তারিত জানার জন্য এবং প্রতিটি পদ্ধতিতে কী কী মান দেওয়া যেতে পারে তার জন্য Chartboost-এর GDPR নিবন্ধ এবং তাদের Android গোপনীয়তা পদ্ধতি দেখুন।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন অনুসারে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" (যেমন আইন এই শর্তাবলী সংজ্ঞায়িত করে) "বিক্রয়" থেকে বেরিয়ে আসার অধিকার দেওয়া হয়, যেখানে "বিক্রয়কারী" পক্ষের হোমপেজে "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউট করার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন সম্মতি নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে অক্ষম। অতএব, আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্ক চিহ্নিত করতে হবে যারা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই প্রতিটি নেটওয়ার্কের নির্দেশিকা অনুসরণ করতে হবে।
SDK সংস্করণ 8.1.0-এ, Chartboost addDataUseConsent() পদ্ধতি যোগ করেছে। নিম্নলিখিত নমুনা কোডটি OPT_IN_SALE তে ডেটা ব্যবহারের সম্মতি সেট করে। আপনি যদি এই পদ্ধতিটি কল করতে চান, GMA Next-Gen SDK মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হচ্ছে।
জাভা
DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);
কোটলিন
val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)
আরও বিস্তারিত জানার জন্য এবং প্রতিটি পদ্ধতিতে কী কী মান দেওয়া যেতে পারে তার জন্য Chartboost-এর CCPA নিবন্ধ এবং তাদের Android Privacy Methods দেখুন।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
অ্যাক্টিভিটি কনফিগারেশনের পরিবর্তনগুলি আপডেট করুন
AndroidManifest.xml ফাইলের প্রতিটি কার্যকলাপে নিম্নলিখিত বৈশিষ্ট্য যোগ করুন যা Chartboost বিজ্ঞাপন দেখায় এবং বিভিন্ন ওরিয়েন্টেশন সমর্থন করে:
android:configChanges="keyboardHidden|orientation|screenSize"
ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষামূলক বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনি AdMob-এর জন্য আপনার পরীক্ষামূলক ডিভাইসটি নিবন্ধন করেছেন এবং Chartboost UI-তে পরীক্ষামূলক মোড সক্ষম করেছেন ।
পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন
আপনি Chartboost থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Chartboost (Waterfall) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক বিভাগে একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।
ঐচ্ছিক পদক্ষেপ
অনুমতিসমূহ
সর্বোত্তম কর্মক্ষমতার জন্য, Chartboost আপনার অ্যাপের AndroidManifest.xml ফাইলে নিম্নলিখিত ঐচ্ছিক অনুমতিগুলি যোগ করার পরামর্শ দেয়:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
ত্রুটি কোড
যদি অ্যাডাপ্টারটি Chartboost থেকে কোনও বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdSourceResponses() ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
কোনও বিজ্ঞাপন লোড না হলে চার্টবুস্ট অ্যাডাপ্টার দ্বারা প্রেরিত কোড এবং তার সাথে থাকা বার্তাগুলি এখানে দেওয়া হল:
| ত্রুটি কোড | কারণ |
|---|---|
| ০-৯৯ | Chartboost SDK একটি ত্রুটি ফেরত দিয়েছে। আরও বিস্তারিত জানার জন্য Chartboost এর ডকুমেন্টেশন দেখুন। |
| ১০১ | অনুরোধ করা বিজ্ঞাপনের আকার চার্টবুস্ট সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| ১০২ | চার্টবুস্ট একবারে প্রতি লোকেশনে কেবল ১টি বিজ্ঞাপন লোড করতে পারে। |
| ১০৩ | AdMob UI-তে কনফিগার করা চার্টবুস্ট সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ। |
| ১০৪ | চার্টবুস্ট ইন্টারস্টিশিয়াল বা পুরস্কৃত বিজ্ঞাপনটি দেখানোর জন্য প্রস্তুত নয়। |