إعلانات البانر القابلة للتصغير هي إعلانات بانر يتم عرضها مبدئيًا على شكل تراكب أكبر، مع زر لتصغيرها إلى حجم البانر المطلوب في الأصل. تهدف إعلانات البانر القابلة للتصغير إلى تحسين أداء الإعلانات الثابتة الأصغر حجمًا. يشرح هذا الدليل كيفية تفعيل إعلانات البانر القابلة للتصغير لمواضع إعلانات البانر الحالية.
المتطلّبات الأساسية
- أكمِل دليل بدء إعلانات البانر.
التنفيذ
احرص على تحديد حجم عرض البانر بالحجم الذي تريد أن يراه المستخدمون في حالة إعلان البانر العادي (المصغَّر). يمكنك إدراج معلمة إضافية في طلب الإعلان مع استخدام 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)
}
سلوك إعادة تحميل الإعلانات
إنّ إعادة تحميل إعلانات البانر القابلة للتصغير إلى الظهور كل 30 إلى 120 ثانية قد يكون متكرّرًا جدًا، ما يؤدي إلى ترك انطباع سيئ لدى المستخدم. بالنسبة إلى التطبيقات التي تضبط ميزة التحديث التلقائي في واجهة ويب AdMob، ننصح بعرض طلب الإعلان الأول فقط كإعلان قابل للتصغير، وعرض إعلانات البانر اللاحقة التي تتم إعادة تحميلها في تلك الشريحة بحجم الطلب الأصلي. ولإجراء ذلك، عليك تمرير المعرّف الفريد العالمي (UUID) باعتباره collapsible_request_id
إلى طلب الإعلان:
Java
extras.putString("collapsible_request_id", UUID.randomUUID().toString());
Kotlin
extras.putString("collapsible_request_id", UUID.randomUUID().toString())
إذا أردت تحميل إعلان بانر آخر قابل للتصغير لاحقًا في الجلسة، يمكنك تحميل إعلان يدويًا من خلال طلب يحتوي على المَعلمة القابلة للتصغير.
التحقّق ممّا إذا كان الإعلان الذي تمّ تحميله قابلاً للتصغير
يمكنك الاتصال بالرقم isCollapsible
للتأكّد مما إذا كان آخر إعلان بانر تم تحميله قابلاً للتصغير.
إذا تعذّر تحميل الطلب وكان إعلان البانر السابق قابلاً للتصغير، تعرض واجهة برمجة التطبيقات القيمة "صحيح".
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 خلال الفترة التجريبية. تظهر الإعلانات التي يتم عرضها من خلال التوسّط على أنّها إعلانات بانر عادية غير قابلة للتصغير.
سلوك عرض الإعلانات
لتحسين أداء إعلانات البانر إلى أقصى حدّ، يمكن للإعلانات التي لا تسمح بعرض إعلانات بانر قابلة للتصغير ذات الحجم الأكبر أن تُرجع بعض طلبات إعلانات البانر القابلة للتصغير، وتُعرَض مباشرةً بحجم البانر العادي.