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

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

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

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

التنفيذ

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

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

قيمة Placement	السلوك	حالة الاستخدام المقصودة
top	تتم محاذاة أعلى الإعلان الموسّع مع أعلى الإعلان المصغّر.	يتم وضع الإعلان في أعلى الشاشة.
bottom	تتم محاذاة أسفل الإعلان الموسّع مع أسفل الإعلان المصغّر.	يتم وضع الإعلان في أسفل الشاشة.

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

Kotlin

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) {
        // ...
      }
    },
  )
}

Java

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.

Kotlin

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

Java

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

الوساطة

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