استخدام عملية تهيئة قابلة للإعداد للمحوّل (إصدار أوّلي)

تُهيئ Google Mobile Ads SDK تلقائيًا جميع محوّلات التوسّط المرتبطة بتطبيقك أثناء عملية التهيئة. قد تستغرق عملية إعداد كل محوّل أكثر من 30 ثانية، ما يؤدي إلى وقت استجابة كبير قبل تحميل إعلانك الأول.

لحلّ هذه المشكلة، توفّر AdMob ميزة "إعداد المحوِّل القابل للضبط". تتيح لك هذه الميزة التحكّم في المحوّلات التي يتم إعدادها لمرة الظهور الأولى للإعلان، كما تقلّل من وقت الاستجابة لمرة الظهور هذه.

يتناول هذا الدليل الجوانب التالية من عملية إعداد المحوّلات القابلة للضبط:

المتطلبات الأساسية

  • يمكنك الموافقة على هذه الميزة من خلال إضافة #import <GoogleMobileAds/GoogleMobileAds_Beta.h> في Objective-C أو إضافة import GoogleMobileAds_Private في Swift.

    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.
                                }];