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

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

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

التنفيذ

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

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

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

إذا كان الإعلان المحمَّل هو بانر قابل للطي، يعرض البانر التراكب قابل للطي على الفور بعد وضعه في التسلسل الهرمي للعرض.

Java

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // 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");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // 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 adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

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

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

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

التحقّق مما إذا كان الإعلان المحمَّل قابلاً للطي

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

Java

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

الوساطة

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