এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে Google Mobile Ads SDK ব্যবহার করে Chartboost থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, যা মধ্যস্থতা ব্যবহার করে, জলপ্রপাত ইন্টিগ্রেশনগুলিকে অন্তর্ভুক্ত করে। এটি একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে Chartboost কীভাবে যুক্ত করতে হয় এবং একটি Flutter অ্যাপে Chartboost SDK এবং অ্যাডাপ্টার কীভাবে একীভূত করতে হয় তা কভার করে।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
Chartboost-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
আবশ্যকতা
- সর্বশেষ গুগল মোবাইল বিজ্ঞাপন SDK
- ফ্লাটার ৩.৭.০ বা তার বেশি
- অ্যান্ড্রয়েডে স্থাপন করতে
- অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
- iOS-এ স্থাপন করতে
- iOS স্থাপনার লক্ষ্য ১২.০ বা তার বেশি
- Google মোবাইল বিজ্ঞাপন SDK দিয়ে কনফিগার করা একটি কার্যকরী Flutter প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন
ধাপ ১: চার্টবুস্ট 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 চাহিদা সেট আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, Android এর জন্য নির্দেশিকায় ধাপ ২ দেখুন।
আইওএস
নির্দেশাবলীর জন্য, iOS এর জন্য নির্দেশিকায় ধাপ ২ দেখুন।
GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালার বিজ্ঞাপন অংশীদারদের তালিকায় Chartboost যোগ করুন
AdMob UI-তে ইউরোপীয় এবং মার্কিন যুক্তরাষ্ট্রের রাজ্যের নিয়ন্ত্রণ বিজ্ঞাপন অংশীদারদের তালিকায় Chartboost যোগ করতে ইউরোপীয় নিয়ন্ত্রণ সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের রাজ্যের নিয়ন্ত্রণ সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ ৩: চার্টবুস্ট SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml ফাইলে Chartboost SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যোগ করুন:
dependencies:
gma_mediation_chartboost: ^1.3.0
ম্যানুয়াল ইন্টিগ্রেশন
Chartboost এর জন্য Google Mobile Ads mediation plugin এর সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার Flutter প্রজেক্টে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_chartboost:
path: path/to/local/package
ধাপ ৪: Chartboost SDK-তে গোপনীয়তা সেটিংস বাস্তবায়ন করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডের ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং আইনত প্রয়োজনে কুকিজ বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, ভাগ করে নেওয়া এবং ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণ (GDPR) এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে। আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পাঠানো হয়েছে কিনা তা যাচাই করার জন্য আপনার দায়িত্ব। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতি পছন্দ প্রেরণ করতে অক্ষম।
Chartboost ভার্সন 3.1.0 এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগইনটিতে Chartboost.AddDataUseConsent() পদ্ধতি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি NonBehavioral এ ডেটা ব্যবহারের সম্মতি সেট করে। আপনি যদি এই পদ্ধতিটি কল করতে চান, তাহলে Google Mobile Ads SDK ব্যবহার করে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হচ্ছে।
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন অনুসারে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" (যেমন আইন এই শর্তাবলী সংজ্ঞায়িত করে) "বিক্রয়" থেকে বেরিয়ে আসার অধিকার দেওয়া হয়, যেখানে "বিক্রয়কারী" পক্ষের হোমপেজে "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউট করার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন সম্মতি নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে অক্ষম। অতএব, আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্ক চিহ্নিত করতে হবে যারা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই প্রতিটি নেটওয়ার্কের নির্দেশিকা অনুসরণ করতে হবে।
Chartboost ভার্সন 3.1.0 এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগইনটিতে Chartboost.AddDataUseConsent() পদ্ধতি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি OptInSale তে ডেটা ব্যবহারের সম্মতি সেট করে। আপনি যদি এই পদ্ধতিটি কল করতে চান, তাহলে Google Mobile Ads SDK ব্যবহার করে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হচ্ছে।
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
চার্টবুস্ট ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।
আইওএস
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে Chartboost-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষামূলক বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনি AdMob-এর জন্য আপনার পরীক্ষামূলক ডিভাইসটি নিবন্ধন করেছেন এবং Chartboost UI-তে পরীক্ষামূলক মোড সক্ষম করেছেন ।
পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন
আপনি Chartboost থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Chartboost (Waterfall) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক বিভাগে একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।
ঐচ্ছিক পদক্ষেপ
অ্যান্ড্রয়েড
অনুমতিসমূহ
সর্বোত্তম কর্মক্ষমতার জন্য, Chartboost আপনার অ্যাপের AndroidManifest.xml ফাইলে নিম্নলিখিত ঐচ্ছিক অনুমতিগুলি যোগ করার পরামর্শ দেয়:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
আইওএস
iOS ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত পদক্ষেপের প্রয়োজন নেই।
ত্রুটি কোড
যদি অ্যাডাপ্টারটি Chartboost থেকে কোনও বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
আইওএস
GADMAdapterChartboost
GADMediationAdapterChartboost
কোনও বিজ্ঞাপন লোড না হলে চার্টবুস্ট অ্যাডাপ্টার দ্বারা প্রেরিত কোড এবং তার সাথে থাকা বার্তাগুলি এখানে দেওয়া হল:
অ্যান্ড্রয়েড
| ত্রুটি কোড | কারণ |
|---|---|
| ০-৯৯ | Chartboost SDK একটি ত্রুটি ফেরত দিয়েছে। |
| ১০১ | অনুরোধ করা বিজ্ঞাপনের আকার চার্টবুস্ট সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| ১০২ | চার্টবুস্ট একবারে প্রতি লোকেশনে কেবল ১টি বিজ্ঞাপন লোড করতে পারে। |
| ১০৩ | AdMob UI-তে কনফিগার করা চার্টবুস্ট সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ। |
| ১০৪ | চার্টবুস্ট ইন্টারস্টিশিয়াল বা পুরস্কৃত বিজ্ঞাপনটি দেখানোর জন্য প্রস্তুত নয়। |
আইওএস
| ত্রুটি কোড | কারণ |
|---|---|
| ১০১ | AdMob UI-তে কনফিগার করা চার্টবুস্ট সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ। |
| ১০২ | Chartboost SDK একটি আরম্ভিক ত্রুটি ফেরত দিয়েছে। |
| ১০৩ | চার্টবুস্ট বিজ্ঞাপনটি শোয়ের সময় ক্যাশে করা হয় না। |
| ১০৪ | অনুরোধ করা বিজ্ঞাপনের আকার চার্টবুস্ট সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| ১০৫ | ডিভাইসের OS সংস্করণটি Chartboost SDK এর সর্বনিম্ন সমর্থিত OS সংস্করণের চেয়ে কম। |
| ২০০-২৯৯ | চার্টবুস্ট SDK ক্যাশে ত্রুটি। আরও বিস্তারিত জানার জন্য কোড দেখুন। |
| ৩০০-৩৯৯ | চার্টবুস্ট SDK ত্রুটি দেখায়। আরও বিস্তারিত জানার জন্য কোড দেখুন। |
| ৪০০-৪৯৯ | চার্টবুস্ট SDK ক্লিক ত্রুটি। আরও বিস্তারিত জানার জন্য কোড দেখুন। |
Chartboost Flutter Mediation Adapter Changelog
সংস্করণ 1.3.0
- চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 9.10.0.0 সমর্থন করে।
- Charboost iOS অ্যাডাপ্টার সংস্করণ 9.10.0.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.2.1
- চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 9.9.2.0 সমর্থন করে।
- Charboost iOS অ্যাডাপ্টার সংস্করণ 9.9.2.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.2.0
- চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 9.9.0.0 সমর্থন করে।
- Charboost iOS অ্যাডাপ্টার সংস্করণ 9.9.1.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.1.0
- চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 9.8.3.1 সমর্থন করে।
- Charboost iOS অ্যাডাপ্টার সংস্করণ 9.9.0.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.0.2
- চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 9.8.3.1 সমর্থন করে।
- Charboost iOS অ্যাডাপ্টার সংস্করণ 9.8.1.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.0.1
- চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 9.8.3.0 সমর্থন করে।
- Charboost iOS অ্যাডাপ্টার সংস্করণ 9.8.1.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.0.0
- প্রাথমিক প্রকাশ।
- চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 9.8.1.0 সমর্থন করে।
- Charboost iOS অ্যাডাপ্টার সংস্করণ 9.8.0.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.2.0 দিয়ে তৈরি এবং পরীক্ষিত।