কনফিগার করা যায় এমন অ্যাডাপ্টার ইনিশিয়ালাইজেশন (আলফা) ব্যবহার করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Android (পুরনো)

ডিফল্ট হিসেবে, Google Mobile Ads SDK ইনিশিয়ালাইজেশনের সময় আপনার অ্যাপ্লিকেশনের সাথে যুক্ত সব মধ্যস্থতা অ্যাডাপ্টার ইনিশিয়ালাইজ করে। প্রতিটি অ্যাডাপ্টার শুরু করতে ৩০ সেকেন্ডের বেশি সময় লাগতে পারে, যার ফলে আপনার প্রথম বিজ্ঞাপন লোড হওয়ার আগে উল্লেখযোগ্য লেটেন্সি হতে পারে।

এই সমস্যার সমাধান করতে, AdMob কনফিগার করা যায় এমন অ্যাডাপ্টার ইনিশিয়ালাইজেশন প্রদান করে। এই ফিচার আপনাকে প্রথম বিজ্ঞাপন ইম্প্রেশনের জন্য কোন অ্যাডাপ্টার ইনিশিয়ালাইজ করা হবে তা নিয়ন্ত্রণ করতে দেয় এবং সেই ইম্প্রেশনের জন্য লেটেন্সি কমায়।

এই নির্দেশিকায় কনফিগার করা যায় এমন অ্যাডাপ্টার ইনিশিয়ালাইজেশনের নিম্নলিখিত দিকগুলি কভার করা হয়েছে:

পূর্বশর্ত

  • Objective-C-তে #import <GoogleMobileAds/GoogleMobileAds_Beta.h> বা Swift-এ import GoogleMobileAds_Private যোগ করে এই ফিচার চালু করুন।

    Swift

    import GoogleMobileAds
    import GoogleMobileAds_Private
    

    Objective-C

    #import <GoogleMobileAds/GoogleMobileAds.h>
    #import <GoogleMobileAds/GoogleMobileAds_Beta.h>
    

অ্যাডাপ্টার কনফিগারেশন তৈরি করুন

অ্যাডাপ্টার ইনিশিয়ালাইজেশন কনফিগারেশন Google Mobile Ads SDK-কে শুধুমাত্র প্রয়োজনীয় অ্যাডাপ্টার ইনিশিয়ালাইজ করার নির্দেশ দেয়। এটি অপ্রয়োজনীয় অ্যাডাপ্টারকে আপনার প্রথম বিজ্ঞাপনের অনুরোধ ব্লক করা থেকে আটকায়, কম্পিউটেশন রিসোর্স বাঁচায় এবং প্রথম বিজ্ঞাপনের ইম্প্রেশনের জন্য লেটেন্সি উল্লেখযোগ্যভাবে কমায়।

আপনার অ্যাপের পারফর্ম্যান্স অপ্টিমাইজ করতে, আপনি অ্যাডাপ্টার ইনিশিয়ালাইজেশন কনফিগারেশন তৈরি করার সময় নিম্নলিখিত স্ট্র্যাটেজিগুলি বিবেচনা করুন:

নির্দিষ্ট বিজ্ঞাপন ফর্ম্যাট বা বিজ্ঞাপন ইউনিটকে অগ্রাধিকার দিন

আপনার অ্যাডাপ্টার ইনিশিয়ালাইজেশন কনফিগারেশনে নির্দিষ্ট বিজ্ঞাপন ফর্ম্যাট বা বিজ্ঞাপন ইউনিট ঘোষণা করে, অ্যাপ খোলার সাথে সাথে দেখা যায় এমন বিজ্ঞাপনের মতো, লঞ্চ করার সাথে সাথে বিজ্ঞাপন দেখায় এমন অ্যাপের পারফর্ম্যান্স উন্নত করুন।

নিম্নলিখিত উদাহরণটি একটি অ্যাডাপ্টার ইনিশিয়ালাইজেশন কনফিগারেশন তৈরি করে যা পাঁচ সেকেন্ডের টাইমআউট সহ একটি নির্দিষ্ট অ্যাপ খোলার সাথে সাথে দেখা যায় এমন বিজ্ঞাপন ইউনিটের জন্য শুধুমাত্র প্রয়োজনীয় মধ্যস্থতা অ্যাডাপ্টার ইনিশিয়ালাইজ করে:

Swift

let adapterConfig = MediationInitializationConfiguration()
adapterConfig.includedAdUnitIDs = [adUnitID]
adapterConfig.initializationTimeout = 5.0

Objective-C

GADMediationInitializationConfiguration *adapterConfig =
    [[GADMediationInitializationConfiguration alloc] init];
adapterConfig.includedAdUnitIDs = [NSSet setWithArray:@[ kTestAdUnitID ]];
adapterConfig.initializationTimeout = 5.0;

নিম্নলিখিত উদাহরণটি একটি অ্যাডাপ্টার ইনিশিয়ালাইজেশন কনফিগারেশন তৈরি করে যা সব অ্যাপ খোলার সাথে সাথে দেখা যায় এমন বিজ্ঞাপনের জন্য শুধুমাত্র প্রয়োজনীয় মধ্যস্থতা অ্যাডাপ্টার ইনিশিয়ালাইজ করে এবং পাঁচ সেকেন্ডের টাইমআউট সেট করে:

Swift

let adapterConfig = MediationInitializationConfiguration()
adapterConfig.includedAdFormats = [AdFormat.appOpen.rawValue as NSNumber]
adapterConfig.initializationTimeout = 5.0

Objective-C

GADMediationInitializationConfiguration *adapterConfig =
    [[GADMediationInitializationConfiguration alloc] init];
adapterConfig.includedAdFormats = [NSSet setWithArray:@[ @(GADAdFormatAppOpen) ]];
adapterConfig.initializationTimeout = 5.0;

নির্দিষ্ট মিডিয়েশন অ্যাডাপ্টার শুরু করুন

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

নিম্নলিখিত উদাহরণটি একটি অ্যাডাপ্টার ইনিশিয়ালাইজেশন কনফিগারেশন তৈরি করে যা একটি নির্দিষ্ট মিডিয়েশন অ্যাডাপ্টার শুরু করে এবং পাঁচ সেকেন্ডের টাইমআউট সেট করে:

Swift

let adapterConfig = MediationInitializationConfiguration()
adapterConfig.includedAdapterClasses = [adapterClassName]
adapterConfig.initializationTimeout = 5.0

Objective-C

GADMediationInitializationConfiguration *adapterConfig =
    [[GADMediationInitializationConfiguration alloc] init];
adapterConfig.includedAdapterClasses = [NSSet setWithArray:@[ kTestAdapterClassName ]];
adapterConfig.initializationTimeout = 5.0;

নির্দিষ্ট মিডিয়েশন অ্যাডাপ্টার বাদ দিন

আপনি যদি দেখেন যে নির্দিষ্ট কিছু মেডিয়েশন অ্যাডাপ্টারে ক্রমাগত বেশি লেটেন্সি হচ্ছে, তাহলে আপনি এইসব অ্যাডাপ্টার বাদ দিতে এবং পরে সেগুলি শুরু করতে পারেন।

নিম্নলিখিত উদাহরণটি একটি অ্যাডাপ্টার ইনিশিয়ালাইজেশন কনফিগারেশন তৈরি করে যা ইনিশিয়ালাইজ করা থেকে নির্দিষ্ট অ্যাডাপ্টার বাদ দেয় এবং পাঁচ সেকেন্ডের টাইমআউট সেট করে:

Swift

let adapterConfig = MediationInitializationConfiguration()
adapterConfig.excludedAdapterClasses = [adapterClassName]
adapterConfig.initializationTimeout = 5.0

Objective-C

GADMediationInitializationConfiguration *adapterConfig =
    [[GADMediationInitializationConfiguration alloc] init];
adapterConfig.excludedAdapterClasses = [NSSet setWithArray:@[ kTestAdapterClassName ]];
adapterConfig.initializationTimeout = 5.0;

আনইনিশিয়ালাইজড অ্যাডাপ্টার এড়িয়ে যান

আপনি যদি নির্দিষ্ট মিডিয়েশন অ্যাডাপ্টার শুরু বা বাদ দেওয়ার পরিকল্পনা করেন, তাহলে আপনার ওয়াটারফলে এখনও উপস্থিত শুরু না করা অ্যাডাপ্টারগুলি এড়িয়ে যাওয়ার জন্য আপনার বিজ্ঞাপনের অনুরোধ কনফিগার করতে পারেন।

আপনি অ্যাডাপ্টার কনফিগারেশন তৈরি না করলেও, শুরু না করা অ্যাডাপ্টার এড়িয়ে যাওয়ার জন্য বিজ্ঞাপনের অনুরোধ কনফিগার করতে পারবেন। অ্যাডাপ্টার টাইম-আউট হওয়া বা শুরু হতে না পারার জন্য অপেক্ষা না করেই Google Mobile Ads SDK বিজ্ঞাপনের অনুরোধ ইস্যু করে।

নিম্নলিখিত উদাহরণে অ্যাডাপ্টার ইনিশিয়ালাইজেশন কনফিগারেশনের মাধ্যমে SDK ইনিশিয়ালাইজ করা হয় এবং অ্যাপ খোলার সাথে সাথে দেখা যায় এমন বিজ্ঞাপন সংক্রান্ত অনুরোধ তৈরি করা হয় যা ইনিশিয়ালাইজ না করা অ্যাডাপ্টারকে এড়িয়ে যায়:

Swift

await MobileAds.shared.start(with: adapterInitializationConfig)

// Make your ad request after adapter initialization completes.
let request = Request()
// Set this to guarantee that the ad request
// doesn't wait for any other uninitialized adapters.
request.skipUninitializedAdapters = true

do {
  let _ = try await AppOpenAd.load(with: adUnitID, request: request)
} catch {
  print("Failed to load app open ad with error: \(error.localizedDescription)")
  // TODO: Handle error
}

// Handle non time-sensitive tasks after the ad has loaded regardless of whether ad load
// succeeded.
performPostLaunchSetup()

Objective-C


[[GADMobileAds sharedInstance]
    startWithMediationInitializationConfiguration:adapterInitializationConfig
                                completionHandler:^(GADInitializationStatus *_Nonnull status) {
                                  // Make your ad request after adapter initialization
                                  // completes.
                                  GADRequest *request = [GADRequest request];
                                  // Set this to guarantee that the ad request
                                  // doesn't wait for any other uninitialized adapters
                                  request.shouldSkipUninitializedAdapters = YES;

                                  [GADAppOpenAd
                                      loadWithAdUnitID:adUnitID
                                               request:request
                                      completionHandler:^(GADAppOpenAd *_Nullable ad,
                                                          NSError *_Nullable error) {
                                       if (error) {
                                         NSLog(@"Failed to load app open ad with error: %@",
                                               error.localizedDescription);
                                       }

                                       // Handle non time-sensitive tasks after the
                                       // ad has loaded regardless of whether ad load succeeded.
                                       [self performPostLaunchSetup];
                                     }];
                                }];

বাকি অ্যাডাপ্টার শুরু করুন

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

নিম্নলিখিত উদাহরণটি একটি খালি কনফিগারেশন প্রদান করে বাকি অ্যাডাপ্টারগুলি শুরু করে:

Swift


// Provide start with nil to initialize any adapters
// not initialized with configurable initialization.
MobileAds.shared.start(with: nil) { status in
  // Remaining adapters are now initialized.
}

Objective-C


// Call start with nil to initialize any adapters not initialized via configurable initialization.
[[GADMobileAds sharedInstance]
    startWithMediationInitializationConfiguration:nil
                                completionHandler:^(GADInitializationStatus *_Nonnull status) {
                                  // Remaining adapters are now initialized.
                                }];