استفاده از مقداردهی اولیه آداپتور پیکربندی‌پذیر (آلفا)

به‌طور پیش‌فرض، GMA Next-Gen SDK همه آداپتورهای میانجی مرتبط با برنامه شما را درطول مقداردهی اولیه مقداردهی می‌کند. مقداردهی اولیه هر آداپتور می‌تواند بیش‌از ۳۰ ثانیه طول بکشد، که منجر به تأخیر قابل‌توجهی قبل‌از بار شدن اولین آگهی شما می‌شود.

برای حل این مشکل، AdMob «راه‌اندازی آداپتور پیکربندی‌شدنی» را ارائه می‌دهد. این ویژگی به شما امکان می‌دهد کنترل کنید کدام آداپتورها برای اولین ظهور آگهی شما مقداردهی اولیه شوند و تأخیر را برای آن ظهور کاهش می‌دهد.

این راهنما جنبه‌های زیر را از «مقداردهی اولیه آداپتور پیکربندی‌پذیر» پوشش می‌دهد:

پیش‌نیازها

  • با افزودن حاشیه‌نویسی @ExperimentalApi به کلاس خود، با این ویژگی موافقت کنید:

    Kotlin

    @OptIn(ExperimentalApi::class)
    

    جاوا

    import androidx.annotation.OptIn;
    // ...
    @OptIn(markerClass = ExperimentalApi.class)
    

ایجاد پیکربندی آداپتور

پیکربندی راه‌اندازی آداپتور به GMA Next-Gen SDK دستور می‌دهد فقط آداپتورهای لازم را راه‌اندازی کند. این کار از مسدود شدن اولین درخواست آگهی شما توسط آداپتورهای غیرضروری جلوگیری می‌کند، منابع محاسباتی را حفظ می‌کند، و تأخیر اولین ظهور آگهی را به‌طور قابل‌توجهی کاهش می‌دهد.

برای بهینه‌سازی عملکرد برنامه‌تان، هنگام ایجاد پیکربندی مقداردهی اولیه آداپتور، راهبردهای زیر را درنظر بگیرید:

اولویت‌بندی «قالب آگهی» یا «واحد آگهی» خاص

با اعلام قالب آگهی یا واحد آگهی خاص در پیکربندی مقداردهی اولیه آداپتور، عملکرد برنامه‌هایی را که بلافاصله پس‌از راه‌اندازی آگهی نشان می‌دهند (مثل آگهی در صفحه باز شدن برنامه) بهبود دهید.

نمونه زیر پیکربندی مقداردهی اولیه آداپتور را ایجاد می‌کند که فقط آداپتورهای میانجی‌گری لازم را برای واحد آگهی در صفحه باز شدن برنامه خاصی با مهلت پنج ثانیه‌ای مقداردهی اولیه می‌کند:

Kotlin

val adapterConfig =
  AdapterInitializationConfig.Builder()
    .setAllowedAdUnitIds(setOf(AD_UNIT_ID))
    .setInitializationTimeoutMs(5000)
    .build()

جاوا

AdapterInitializationConfig adapterConfig =
    new AdapterInitializationConfig.Builder()
        .setAllowedAdUnitIds(Set.of(AD_UNIT_ID))
        .setInitializationTimeoutMs(5000)
        .build();

مثال زیر پیکربندی مقداردهی اولیه آداپتور را ایجاد می‌کند که فقط آداپتورهای میانجی‌گری لازم را برای همه «آگهی‌های در صفحه باز شدن برنامه» مقداردهی اولیه می‌کند و زمان استراحت پنج ثانیه‌ای تنظیم می‌کند:

Kotlin

val adapterConfig =
  AdapterInitializationConfig.Builder()
    .setAllowedAdFormats(setOf(AdFormat.APP_OPEN_AD))
    .setInitializationTimeoutMs(5000)
    .build()

جاوا

AdapterInitializationConfig adapterConfig =
    new AdapterInitializationConfig.Builder()
        .setAllowedAdFormats(Set.of(AdFormat.APP_OPEN_AD))
        .setInitializationTimeoutMs(5000)
        .build();

راه‌اندازی آداپتورهای میانجی‌گری خاص

اگر دقیقاً می‌دانید کدام شرکای میانجی معمولاً اولین ظهور آگهی شما را پر می‌کنند، می‌توانید فقط آن آداپتور خاص را با ارائه نام کلاس آداپتور در پیکربندی مقداردهی اولیه آداپتور خود مقداردهی اولیه کنید. این را با رد کردن صریح آداپتورهای مقداردهی‌نشده و تنظیم زمان استراحت برای GMA Next-Gen SDK ترکیب کنید تا درطول مزایده منتظر آداپتورهای مقداردهی‌نشده باقی‌مانده نمانید.

مثال زیر پیکربندی مقداردهی اولیه آداپتور را ایجاد می‌کند که یک آداپتور میانجی خاص را مقداردهی اولیه می‌کند و زمان استراحت پنج ثانیه‌ای تنظیم می‌کند:

Kotlin

val adapterConfig =
  AdapterInitializationConfig.Builder()
    .setAllowedAdapterClasses(setOf(ADAPTER_JAVA_CLASS_NAME))
    .setInitializationTimeoutMs(5000)
    .build()

جاوا

AdapterInitializationConfig adapterConfig =
    new AdapterInitializationConfig.Builder()
        .setAllowedAdapterClasses(Set.of(ADAPTER_JAVA_CLASS_NAME))
        .setInitializationTimeoutMs(5000)
        .build();

می‌توانید نام‌های کلاس آداپتور را به‌صورت برنامه‌نویسی واکشی کنید. مثال زیر نام کلاس‌های آداپتور را به‌صورت برنامه‌نویسی‌شده می‌کشد:

Kotlin

ExampleMediationAdapter::class.java.name

جاوا

ExampleMediationAdapter.class.getName()

مستثنی کردن آداپتورهای میانجی خاص

اگر متوجه شدید که برخی‌از آداپتورهای میانجی‌گری به‌طور مداوم تأخیر بالایی دارند، می‌توانید این آداپتورها را مستثنی کنید و آن‌ها را در زمان دیگری مقداردهی اولیه کنید.

مثال زیر پیکربندی مقداردهی اولیه آداپتوری را ایجاد می‌کند که آداپتورهای خاصی را از مقداردهی اولیه مستثنی می‌کند و مهلت زمانی پنج ثانیه‌ای تنظیم می‌کند:

Kotlin

val adapterConfig =
  AdapterInitializationConfig.Builder()
    .setExcludedAdapterClasses(setOf(ADAPTER_JAVA_CLASS_NAME))
    .setInitializationTimeoutMs(5000)
    .build()

جاوا

AdapterInitializationConfig adapterConfig =
    new AdapterInitializationConfig.Builder()
        .setExcludedAdapterClasses(Set.of(ADAPTER_JAVA_CLASS_NAME))
        .setInitializationTimeoutMs(5000)
        .build();

رد کردن آداپتورهای مقداردهی‌نشده

اگر قصد دارید آداپتورهای میانجی خاصی را مقداردهی اولیه یا مستثنی کنید، می‌توانید درخواست آگهی‌تان را به‌گونه‌ای پیکربندی کنید که آداپتورهای مقداردهی‌نشده را که هنوز در آبشار شما وجود دارند نادیده بگیرد.

اگر پیکربندی آداپتور ایجاد نکنید، همچنان می‌توانید درخواست آگهی‌تان را پیکربندی کنید تا آداپتورهای مقداردهی‌نشده را رد کند. GMA Next-Gen SDK بدون منتظر ماندن برای اتمام مهلت آداپتورها یا عدم مقداردهی اولیه آن‌ها، درخواست آگهی صادر می‌کند.

مثال زیر کیت توسعه نرم‌افزار را با پیکربندی مقداردهی اولیه آداپتور مقداردهی اولیه می‌کند و درخواست آگهی در صفحه باز شدن برنامه ایجاد می‌کند که آداپتورهای مقداردهی اولیه نشده را رد می‌کند:

Kotlin

val initConfig =
  InitializationConfig.Builder(appId)
    .setAdapterInitializationConfig(adapterInitializationConfig)
    .build()

// Initialize the GMA Next-Gen SDK with a config containing your adapter initialization
// settings.
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
  MobileAds.initialize(context = context, initConfig) {

    // Make your ad request after adapter initialization completes.
    AppOpenAd.load(
      AdRequest.Builder(adUnitId = adUnitId)
        // Set this to guarantee that the ad request
        // doesn't wait for any other uninitialized adapters.
        .skipUninitializedAdapters()
        .build(),
      adLoadCallback =
        object : AdLoadCallback<AppOpenAd> {

          override fun onAdLoaded(ad: AppOpenAd) {
            // TODO: Your ad logic here
            // ....

            // Execute non-time-sensitive tasks after ad load completes.
            performPostLaunchSetup()
          }

          override fun onAdFailedToLoad(adError: LoadAdError) {
            // TODO: Handle load error.
            // ....

            // Ensure non-time-sensitive post-launch tasks execute even if ad load fails.
            performPostLaunchSetup()
          }
        },
    )
  }
}

جاوا

InitializationConfig initConfig =
    new InitializationConfig.Builder(appId)
        .setAdapterInitializationConfig(adapterInitializationConfig)
        .build();

// Initialize the GMA Next-Gen SDK with a config containing your adapter initialization
// settings.
MobileAds.initialize(
    context,
    initConfig,
    initializationStatus -> {
      // Make your ad request after adapter initialization completes.
      AppOpenAd.load(
          new AdRequest.Builder(adUnitId)
              // Set this to guarantee that the ad request
              // doesn't wait for any other uninitialized adapters.
              .skipUninitializedAdapters()
              .build(),
          new AdLoadCallback<AppOpenAd>() {
            @Override
            public void onAdLoaded(@NonNull AppOpenAd ad) {
              // TODO: Your ad logic here
              // ....

              // Execute non-time-sensitive tasks after ad load completes.
              performPostLaunchSetup();
            }

            @Override
            public void onAdFailedToLoad(@NonNull LoadAdError error) {
              // TODO: Handle load error.
              // ....

              // Ensure non-time-sensitive post-launch tasks execute even if ad load fails.
              performPostLaunchSetup();
            }
          });
    });

راه‌اندازی آداپتورهای باقی‌مانده

پس‌از بار شدن فرصت‌های آگهی حساس به زمان، آداپتورهای باقی‌مانده را مقداردهی اولیه کنید تا از پوشش کامل میانجی‌گری شریک برای بقیه جلسه برنامه مطمئن شوید.

مثال زیر بقیه آداپتورها را با ارائه پیکربندی خالی مقداردهی اولیه می‌کند:

Kotlin


// Provide initializeAdapters with an empty configuration to initialize
// any adapters not initialized with configurable initialization.
MobileAds.initializeAdapters(AdapterInitializationConfig.Builder().build())

جاوا

// Provide initializeAdapters with an empty configuration to initialize
// any adapters not initialized with configurable initialization.
MobileAds.initializeAdapters(new AdapterInitializationConfig.Builder().build());