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

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

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

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

التنفيذ

تأكَّد من تحديد عرض البانر بالحجم الذي تريد أن يراه المستخدمون في حالة البانر العادي (المصغَّر). أدرِج مَعلمة 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 خلال الفترة التجريبية. تظهر الإعلانات التي يتم عرضها من خلال التوسّط كإعلانات بانر عادية غير قابلة للطي.