إعلانات البانر التكيُّفية المضمّنة

اختيار النظام الأساسي: Android (إصدار تجريبي) New-selected Android iOS Flutter

تسمح لك "إعلانات البانر التكيُّفية" بتحديد عرض الإعلان لتحديد حجم الإعلان الأمثل. تزيد "إعلانات البانر التكيُّفية" أيضًا الأداء إلى أقصى حد من خلال تحسين حجم الإعلان لكل جهاز. ويؤدي هذا النهج إلى توفّر فرص لتحسين الأداء.

"إعلانات البانر التكيُّفية" المضمّنة أكبر وأطول من "إعلانات البانر التكيُّفية الثابتة"، وتستخدم ارتفاعات متغيّرة بدلاً من الارتفاعات الثابتة. تكون إعلانات البانر التكيُّفية المضمّنة ذات ارتفاع متغيّر، وقد تشمل الشاشة بأكملها أو حدًا أقصى للارتفاع تحدّده أنت.

يمكنك وضع "إعلانات البانر التكيُّفية" المضمّنة في محتوى قابل للتمرير، على سبيل المثال:

مخطّط بياني يعرض الاختلافات بين إعلانات البانر التكيّفية وإعلانات البانر التكيّفية المضمّنة

قبل البدء

قبل المتابعة، تأكَّد من إكمال دليل البدء، إعلانات البانر.

تنفيذ "إعلانات البانر التكيُّفية" المضمّنة

يوضّح المثال التالي هذه الخطوات:

Kotlin

private fun loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()

  // Step 2 - Load the ad.
  BannerAd.load(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // Assign the loaded ad to the BannerAd object.
        bannerAd = ad
        // Step 3 - Call BannerAd.getView() to get the View and add it
        // to view hierarchy on the UI thread.
        activity?.runOnUiThread {
          binding.bannerViewContainer.addView(ad.getView(requireActivity()))
        }
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        bannerAd = null
      }
    }
  )
}

جافا

private void loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
      adSize).build();

  // Step 2 - Load the ad.
  BannerAd.load(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // Assign the loaded ad to the BannerAd object.
          bannerAd = ad;
          // Step 3 - Call BannerAd.getView() to get the View and add it
          // to view hierarchy on the UI thread.
          if (getActivity() != null) {
            getActivity()
                .runOnUiThread(() ->
                    binding.bannerViewContainer.addView(ad.getView(getActivity())));
          }
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          bannerAd = null;
        }
      });
}

عند تنفيذ "إعلانات البانر التكيُّفية" في تطبيقك، يُرجى مراعاة النقاط التالية:

  • تعمل أحجام "إعلانات البانر التكيُّفية" المضمّنة بشكل أفضل عند استخدام عرض المساحة المتاحة بأكمله. في معظم الحالات، يكون هذا الحجم هو العرض الكامل لشاشة الجهاز المستخدَم أو العرض الكامل لمحتوى "إعلان البانر" الرئيسي. يجب أن تعرف عرض المساحة التي سيظهر فيها الإعلان وعرض الجهاز وعرض المحتوى الرئيسي والمساحات المخصّصة للأقسام المهمة.

تحديد اتجاه حجم "إعلان البانر التكيُّفي" المضمّن

لتحميل إعلان بانر تكيُّفي مضمّن مسبقًا لاتجاه معيّن، استخدِم الطريقتَين التاليتَين:

إذا كان تطبيقك يتيح عرضَين عموديًا وأفقيًا، وأردت تحميل "إعلان بانر تكيُّفي" مسبقًا بالاتجاه الحالي، استخدِم AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) تعرض هذه الطريقة إعلانًا بالاتجاه الحالي.

الحدّ من ارتفاع "إعلان البانر التكيُّفي" المضمّن

تكون "إعلانات البانر التكيُّفية" المضمّنة التي يتم إنشاء مثيل لها بدون قيمة maxHeight لها maxHeight يساوي ارتفاع الجهاز. للحدّ من ارتفاع "إعلان البانر التكيُّفي" المضمّن، استخدِم الطريقة AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).