এই নির্দেশিকা আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে মধ্যস্থতা ব্যবহার করে Chartboost থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, জলপ্রপাত একীকরণ কভার করে। এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে Chartboost যোগ করতে হয় এবং কীভাবে একটি Flutter অ্যাপে Chartboost SDK এবং অ্যাডাপ্টারকে একীভূত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
Chartboost-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
ইন্টিগ্রেশন | |
---|---|
বিডিং | |
জলপ্রপাত | |
বিন্যাস | |
ব্যানার | |
ইন্টারস্টিশিয়াল | |
পুরস্কৃত |
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: Chartboost UI এ কনফিগারেশন সেট আপ করুন
একটি Chartboost অ্যাকাউন্টের জন্য সাইন আপ করুন এবং আপনার অ্যাকাউন্ট যাচাই হয়ে গেলে লগ ইন করুন । তারপরে, অ্যাপস ম্যানেজমেন্ট ট্যাবে নেভিগেট করুন।
আপনার অ্যাপ তৈরি করতে নতুন অ্যাপ যোগ করুন বোতামে ক্লিক করুন।
বাকি ফর্মটি পূরণ করুন এবং আপনার অ্যাপ চূড়ান্ত করতে অ্যাপ যোগ করুন বোতামে ক্লিক করুন।
আপনার অ্যাপ তৈরি হওয়ার পর, আপনাকে এর ড্যাশবোর্ডে নিয়ে যাওয়া হবে। আপনার অ্যাপের অ্যাপ আইডি এবং অ্যাপ স্বাক্ষর নোট করুন।
অ্যান্ড্রয়েড
iOS
আপনার AdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য AdMob-এর চার্টবুস্ট ব্যবহারকারী আইডি এবং ব্যবহারকারীর স্বাক্ষর প্রয়োজন। আপনি Chartboost UI-তে Chartboost মধ্যস্থতায় ক্লিক করে এই প্যারামিটারগুলি খুঁজে পেতে পারেন।
সম্পদ > API এক্সপ্লোরার ট্যাবে নেভিগেট করুন এবং প্রমাণীকরণ বিভাগের অধীনে অবস্থিত আপনার ব্যবহারকারী আইডি এবং ব্যবহারকারীর স্বাক্ষর নোট করুন।
পরীক্ষা মোড চালু করুন
আপনি Chartboost UI থেকে অ্যাপস ম্যানেজমেন্ট ট্যাবে নেভিগেট করে, তালিকা থেকে আপনার অ্যাপ নির্বাচন করে এবং অ্যাপ সেটিংস সম্পাদনা করুন- এ ক্লিক করে আপনার অ্যাপে পরীক্ষা মোড সক্ষম করতে পারেন।
অ্যান্ড্রয়েড
iOS
আপনার অ্যাপের সেটিংস থেকে, আপনি আপনার অ্যাপে টেস্ট মোড টগল করতে পারেন।
একবার পরীক্ষা মোড সক্ষম হলে, আপনি আগে তৈরি করা বিজ্ঞাপন ইউনিট আইডি ব্যবহার করে বিজ্ঞাপনের জন্য অনুরোধ করতে পারেন এবং একটি Chartboost পরীক্ষার বিজ্ঞাপন পেতে পারেন।
আপনি Chartboost পরীক্ষার বিজ্ঞাপনগুলি পেতে সক্ষম হওয়ার পরে, আপনার অ্যাপটি Chartboost-এর প্রকাশক অ্যাপ পর্যালোচনাতে রাখা হবে। চার্টবুস্টে কাজ করার জন্য নগদীকরণের জন্য, প্রকাশক অ্যাপ পর্যালোচনাটি Chartboost দ্বারা অনুমোদিত হতে হবে।
ধাপ 2: AdMob UI-তে Chartboost চাহিদা সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS এর জন্য নির্দেশিকাতে ধাপ 2 দেখুন।
GDPR এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় Chartboost যোগ করুন
AdMob UI-তে GDPR এবং US রাজ্যের বিধিবিধানের বিজ্ঞাপন অংশীদারদের তালিকায় Chartboost যোগ করতে GDPR সেটিংস এবং মার্কিন রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ 3: Chartboost SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml
ফাইলে Chartboost SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন:
dependencies:
gma_mediation_chartboost: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
Chartboost- এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি বের করুন এবং নিষ্কাশন করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রকল্পে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml
ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_chartboost:
path: path/to/local/package
ধাপ 4: Chartboost SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতির অধীনে, আপনাকে নিশ্চিত করতে হবে যে ডিভাইস শনাক্তকারী এবং ব্যক্তিগত ডেটার ব্যবহার সম্পর্কিত ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ব্যবহারকারীদের নির্দিষ্ট কিছু প্রকাশ দেওয়া হয়েছে এবং তাদের কাছ থেকে সম্মতি নেওয়া হয়েছে। এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ সম্মতি চাওয়ার সময়, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত ডেটা সংগ্রহ, গ্রহণ বা ব্যবহার করতে পারে এবং প্রতিটি নেটওয়ার্কের ব্যবহার সম্পর্কে তথ্য প্রদান করতে পারে। Google বর্তমানে স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
Chartboost সংস্করণ 3.1.0-এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনে Chartboost.AddDataUseConsent()
পদ্ধতি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি NonBehavioral
এ ডেটা ব্যবহারের সম্মতি সেট করে। আপনি যদি এই পদ্ধতিতে কল করতে চান, তাহলে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়।
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার প্রদান করতে হবে (যেমন আইন সেই শর্তগুলিকে সংজ্ঞায়িত করে), "বিক্রয়" এ একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউটের প্রস্তাব দেওয়া হয়েছে "পার্টির হোমপেজ। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
Chartboost সংস্করণ 3.1.0-এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনে Chartboost.AddDataUseConsent()
পদ্ধতি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোড OptInSale
এ ডেটা ব্যবহারের সম্মতি সেট করে। আপনি যদি এই পদ্ধতিতে কল করতে চান, তাহলে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়।
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
Chartboost ইন্টিগ্রেশনের জন্য কোন অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist
ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে Chartboost-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ 6: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনি AdMob-এর জন্য আপনার পরীক্ষার ডিভাইসটি নিবন্ধন করেছেন এবং Chartboost UI-তে পরীক্ষা মোড সক্ষম করেছেন ৷
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি Chartboost থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, Chartboost (Waterfall) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উৎস পরীক্ষা চালু করুন।
ঐচ্ছিক পদক্ষেপ
অ্যান্ড্রয়েড
অনুমতি
সর্বোত্তম পারফরম্যান্সের জন্য, Chartboost আপনার অ্যাপের AndroidManifest.xml
ফাইলে নিম্নলিখিত ঐচ্ছিক অনুমতিগুলি যোগ করার পরামর্শ দেয়:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
iOS ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত পদক্ষেপের প্রয়োজন নেই।
ত্রুটি কোড
যদি অ্যাডাপ্টার Chartboost থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo
ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
একটি বিজ্ঞাপন লোড হতে ব্যর্থ হলে Chartboost অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
অ্যান্ড্রয়েড
ত্রুটি কোড | কারণ |
---|---|
0-99 | Chartboost SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। |
101 | অনুরোধ করা বিজ্ঞাপনের আকার একটি Chartboost সমর্থিত ব্যানার আকারের সাথে মেলে না। |
102 | Chartboost শুধুমাত্র প্রতি লোকেশনে একবারে 1টি বিজ্ঞাপন লোড করতে পারে। |
103 | AdMob UI-তে কনফিগার করা Chartboost সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
104 | চার্টবুস্ট ইন্টারস্টিশিয়াল বা পুরস্কৃত বিজ্ঞাপন দেখানোর জন্য প্রস্তুত নয়। |
iOS
ত্রুটি কোড | কারণ |
---|---|
101 | AdMob UI-তে কনফিগার করা Chartboost সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
102 | Chartboost SDK একটি প্রাথমিক ত্রুটি ফিরিয়ে দিয়েছে। |
103 | Chartboost বিজ্ঞাপনটি শো টাইমে ক্যাশে করা হয় না। |
104 | অনুরোধ করা বিজ্ঞাপনের আকার একটি Chartboost সমর্থিত ব্যানার আকারের সাথে মেলে না। |
105 | ডিভাইসের OS সংস্করণ Chartboost SDK-এর ন্যূনতম সমর্থিত OS সংস্করণের চেয়ে কম। |
200-299 | Chartboost SDK ক্যাশে ত্রুটি। আরো বিস্তারিত জানার জন্য কোড দেখুন. |
300-399 | Chartboost SDK ত্রুটি দেখায়। আরো বিস্তারিত জানার জন্য কোড দেখুন. |
400-499 | Chartboost SDK ক্লিক ত্রুটি। আরো বিস্তারিত জানার জন্য কোড দেখুন. |
Chartboost Flutter Mediation Adapter Changelog
1.0.0
- প্রাথমিক মুক্তি।
- চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 9.8.1.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- Chartboost iOS অ্যাডাপ্টার সংস্করণ 9.8.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.2.0 দিয়ে তৈরি এবং পরীক্ষিত।