إعلانات البانر القابلة للتصغير

اختيار النظام الأساسي: Android Android iOS Unity Flutter

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

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

• إكمال دليل البدء في استخدام إعلانات البانر.

التنفيذ

تأكَّد من تحديد طريقة عرض البانر بالحجم الذي تريد أن يراه المستخدمون في حالة البانر العادي (المصغَّر). أدرِج مَعلمة إضافية في طلب الإعلان باستخدام collapsible كمفتاح وموضع الإعلان كقيمة.

يحدّد موضع الإعلان القابل للتصغير كيفية تثبيت المنطقة الموسّعة في "إعلان البانر".

إذا كان الإعلان الذي تم تحميله "إعلان بانر قابل للتصغير"، يعرض البانر التراكب القابل للتصغير فور وضعه في هيكلية طرق العرض.

private fun loadBannerAd() {
  // ...

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val bannerAdRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize)
    .setGoogleExtrasBundle(extras)
    .build()

  BannerAd.load(
    bannerAdRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // ...
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        // ...
      }
    },
  )
}

private void loadBannerAd() {
  // ...

  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  BannerAdRequest bannerAdRequest = new BannerAdRequest.Builder("AD_UNIT_ID", adSize)
      .setGoogleExtrasBundle(extras)
      .build();

  BannerAd.load(
      bannerAdRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // ...
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          // ...
        }
      });
}

سلوك إعادة تحميل الإعلانات

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

إذا أردت تحميل "إعلان بانر قابل للتصغير" آخر لاحقًا في الجلسة، يمكنك تحميل إعلان يدويًا من خلال طلب يحتوي على المَعلمة القابلة للتصغير.

التحقّق ممّا إذا كان الإعلان الذي تم تحميله قابلاً للتصغير

تكون إعلانات البانر غير القابلة للتصغير مؤهّلة للعرض مقابل طلبات "إعلانات البانر القابلة للتصغير" لتحقيق أفضل أداء. استخدِم الدالة isCollapsible للتحقّق ممّا إذا كان آخر بانر تم تحميله قابلاً للتصغير. إذا تعذّر تحميل الطلب وكان البانر السابق قابلاً للتصغير، تعرض واجهة برمجة التطبيقات القيمة true.

override fun onAdLoaded(ad: BannerAd) {
  // ...
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible."
  )
}

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  // ...
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.",
      ad.isCollapsible() ? "" : "not "));
}

الوساطة

لا تتوفّر "إعلانات البانر القابلة للتصغير" إلا للطلب الإعلاني على منصات Google. تظهر الإعلانات التي يتم عرضها من خلال الوساطة كإعلانات بانر عادية غير قابلة للتصغير.