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

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

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

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

التنفيذ

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

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

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

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

Java

private void loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

CollapsibleBannerFragment.java

Kotlin

private fun loadCollapsibleBanner() {
  // 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")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

CollapsibleBannerFragment.kt

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

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

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

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

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

Java

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}
CollapsibleBannerFragment.java

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}
CollapsibleBannerFragment.kt

الوساطة

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