মধ্যস্থতা স্থাপন করুন, মধ্যস্থতা স্থাপন করুন

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

পূর্বশর্ত

কোনো বিজ্ঞাপন ফরম্যাটের জন্য মিডিয়েশন ইন্টিগ্রেট করার আগে, আপনাকে সেই বিজ্ঞাপন ফরম্যাটটি আপনার অ্যাপে ইন্টিগ্রেট করতে হবে:

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

Google Mobile Ads Flutter Plugin শুরু করুন

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

নিম্নলিখিত নমুনা কোডটি দেখায় যে, একটি অ্যাড রিকোয়েস্ট করার আগে আপনি কীভাবে প্রতিটি অ্যাডাপ্টারের ইনিশিয়ালাইজেশন স্ট্যাটাস চেক করতে পারেন।

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 ফাইলে নিম্নলিখিত লাইনগুলো যোগ করুন, যাতে আপনি প্লাগইনটির অ্যান্ড্রয়েড এপিআইগুলো ব্যবহার করতে পারেন:

def flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

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

আপনার অ্যান্ড্রয়েড এবং আইওএস প্রজেক্টে মিডিয়েশন অ্যাডাপ্টার এবং তাদের ডিপেন্ডেন্সিগুলো যোগ করতে হবে। অ্যান্ড্রয়েডের ক্ষেত্রে অ্যাপ লেভেলের build.gradle ফাইল এবং আইওএস-এর ক্ষেত্রে 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

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

Google User Messaging Platform (UMP) SDK ব্যবহার করে সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ (RDP) সক্রিয় করা এবং GDPR সম্মতি প্রাপ্তি সম্পর্কে আরও জানুন।