استخدام إعلانات البانر القابلة للتصغير

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

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

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

التنفيذ

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

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

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

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

جافا

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);
}

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)
}

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

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

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

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

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

جافا

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

Kotlin

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

الوساطة

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