মধ্যস্থতা

এই নির্দেশিকা আপনাকে দেখায় কিভাবে আপনার Flutter অ্যাপের সাথে একটি মধ্যস্থতা অ্যাডাপ্টার সংহত করতে হয়।

পূর্বশর্ত

আপনি একটি বিজ্ঞাপন বিন্যাসের জন্য মধ্যস্থতা সংহত করার আগে, আপনাকে সেই বিজ্ঞাপন বিন্যাসটিকে আপনার অ্যাপে সংহত করতে হবে:

মধ্যস্থতায় নতুন? মধ্যস্থতার ভূমিকা পড়ুন।

মোবাইল বিজ্ঞাপন SDK শুরু করুন

দ্রুত শুরু নির্দেশিকা আপনাকে দেখায় কিভাবে মোবাইল বিজ্ঞাপন SDK শুরু করতে হয় । সেই প্রারম্ভিক কলের সময়, মধ্যস্থতা এবং বিডিং অ্যাডাপ্টারগুলিও শুরু হয়। প্রথম বিজ্ঞাপন অনুরোধে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক থেকে সম্পূর্ণ অংশগ্রহণ নিশ্চিত করার জন্য আপনি বিজ্ঞাপন লোড করার আগে শুরু করার জন্য অপেক্ষা করা গুরুত্বপূর্ণ।

নিচের নমুনা কোডটি দেখায় যে আপনি কীভাবে বিজ্ঞাপনের অনুরোধ করার আগে প্রতিটি অ্যাডাপ্টারের আরম্ভ করার স্থিতি পরীক্ষা করতে পারেন।

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

আপনার গ্রেডেল সেটিংস আপডেট করুন (শুধুমাত্র অ্যান্ড্রয়েড)

আপনার settings.gradle ফাইলে নিম্নলিখিত লাইন যোগ করুন, যাতে আপনি প্লাগইনের Android API ব্যবহার করতে পারেন:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

অংশীদার নেটওয়ার্কের জন্য নির্ভরতা যোগ করুন

মধ্যস্থতা অ্যাডাপ্টার এবং তাদের নির্ভরতা আপনার Android এবং iOS প্রকল্পে যোগ করা প্রয়োজন। অ্যান্ড্রয়েডে আপনার অ্যাপ লেভেলের build.gradle ফাইল এবং iOS-এ Podfile আপডেট করে এগুলি যোগ করা যেতে পারে। অ্যান্ড্রয়েড এবং আইওএস উভয়ের জন্যই গুগলের গিটহাবে ওপেন সোর্স অ্যাডাপ্টার রয়েছে।

প্রতিটি অংশীদার নেটওয়ার্কের জন্য Android এবং iOS ডকুমেন্টেশন দেখুন কিভাবে আপনার অ্যাপে তাদের অ্যাডাপ্টার যোগ করবেন তার বিশদ নির্দেশিকা।

কোন বিজ্ঞাপন নেটওয়ার্ক অ্যাডাপ্টার ক্লাস বিজ্ঞাপন লোড করেছে তা পরীক্ষা করুন

নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে একটি ব্যানার বিজ্ঞাপনের জন্য বিজ্ঞাপন নেটওয়ার্ক শ্রেণীর নাম লগ করতে হয়:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

অ্যাড ম্যানেজার মধ্যস্থতায় ব্যবহৃত ব্যানার বিজ্ঞাপন ইউনিটগুলির জন্য সমস্ত তৃতীয় পক্ষের বিজ্ঞাপন নেটওয়ার্ক UI-তে রিফ্রেশ নিষ্ক্রিয় করা নিশ্চিত করুন৷ এটি একটি ডবল রিফ্রেশকে বাধা দেয় যেহেতু অ্যাড ম্যানেজার আপনার ব্যানার বিজ্ঞাপন ইউনিটের রিফ্রেশ হারের উপর ভিত্তি করে একটি রিফ্রেশ ট্রিগার করে।

নেটিভ বিজ্ঞাপন মধ্যস্থতা

নেটিভ মধ্যস্থতা বাস্তবায়ন করার সময় বিবেচনা করার জন্য নিম্নলিখিত কিছু সেরা অনুশীলনগুলি রয়েছে৷

নেটিভ বিজ্ঞাপন উপস্থাপনা নীতি
প্রতিটি বিজ্ঞাপন নেটওয়ার্কের নিজস্ব নীতি আছে। মধ্যস্থতা ব্যবহার করার সময়, এটি মনে রাখা গুরুত্বপূর্ণ যে আপনার অ্যাপটিকে এখনও বিজ্ঞাপন প্রদানকারী মধ্যস্থতাকারী নেটওয়ার্কের নীতিগুলি মেনে চলতে হবে৷

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

আপনি যদি মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন বা জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) মেনে চলতে চান, তাহলে Ad Manager Privacy & Messaging-এর US রাজ্য বা GDPR বিজ্ঞাপন অংশীদারদের তালিকায় আপনার মধ্যস্থতা অংশীদারদের যোগ করতে মার্কিন রাজ্যের প্রবিধান সেটিংস বা GDPR সেটিংসের ধাপগুলি অনুসরণ করুন। এটি করতে ব্যর্থ হলে অংশীদাররা আপনার অ্যাপে বিজ্ঞাপন পরিবেশন করতে ব্যর্থ হতে পারে।

সীমাবদ্ধ ডেটা প্রসেসিং (RDP) সক্ষম করা এবং Google ব্যবহারকারী মেসেজিং প্ল্যাটফর্ম (UMP) SDK- এর সাথে GDPR সম্মতি পাওয়ার বিষয়ে আরও জানুন।