استخدام إعلانات البانر التكيّفية المضمّنة لإعلانات البانر القابلة للتمرير

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

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

يمكنك وضع "إعلانات البانر التكيُّفية" المضمّنة في المحتوى القابل للتمرير، على سبيل المثال:

قبل البدء

قبل المتابعة، تأكَّد من إكمال دليل البدء، إعلانات البانر.

تنفيذ "إعلانات البانر التكيُّفية" المضمّنة

لإنشاء حجم "إعلان بانر تكيُّفي" مضمّن، يُرجى إكمال ما يلي:

1. يمكنك الحصول على عرض الجهاز المستخدَم، أو ضبط عرض مخصّص إذا كنت لا تريد استخدام العرض الكامل للشاشة.

   Kotlin

   private val adWidth: Int
     get() {
       val displayMetrics = resources.displayMetrics
       val adWidthPixels =
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
           val windowMetrics: WindowMetrics = this.windowManager.currentWindowMetrics
           windowMetrics.bounds.width()
         } else {
           displayMetrics.widthPixels
         }
       val density = displayMetrics.density
       return (adWidthPixels / density).toInt()
     }
   MainActivity.kt

   جافا

   public int getAdWidth() {
     DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
     int adWidthPixels = displayMetrics.widthPixels;
   
     if (VERSION.SDK_INT >= VERSION_CODES.R) {
       WindowMetrics windowMetrics = this.getWindowManager().getCurrentWindowMetrics();
       adWidthPixels = windowMetrics.getBounds().width();
     }
   
     float density = displayMetrics.density;
     return (int) (adWidthPixels / density);
   }
   MainActivity.java

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

   Kotlin

   val adView = AdView(this@MainActivity)
   adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, adWidth))
   MainActivity.kt

   جافا

   final AdView adView = new AdView(MainActivity.this);
   adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, getAdWidth()));
   MainActivity.java

عند تنفيذ "إعلانات البانر التكيُّفية" في تطبيقك، يُرجى مراعاة النقاط التالية:

• تعمل أحجام "إعلانات البانر التكيُّفية" المضمّنة بشكل أفضل عند استخدام عرض المساحة المتاحة بأكمله. في معظم الحالات، يكون هذا الحجم هو العرض الكامل لشاشة الجهاز المستخدَم أو العرض الكامل لمحتوى "إعلان البانر" الرئيسي. يجب أن تعرف عرض المساحة التي سيظهر فيها الإعلان وعرض الجهاز وعرض المحتوى الرئيسي والمساحات المخصّصة للأقسام المهمة.

• قد تحتاج إلى تعديل البنود الإعلانية أو إنشاء بنود إعلانية جديدة لاستخدام الأحجام التكيُّفية. مزيد من المعلومات.

تحديد اتجاه حجم "إعلان البانر التكيُّفي" المضمّن

لتحميل "إعلان بانر تكيُّفي" مضمّن مسبقًا لاتجاه معيّن، استخدِم الطريقتَين التاليتَين:

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

إذا كان تطبيقك يتيح عرض الشاشة في الوضعَين العمودي والأفقي، وأردت تحميل "إعلان بانر تكيُّفي" مسبقًا في الاتجاه الحالي، استخدِم AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) تعرض هذه الطريقة إعلانًا في الاتجاه الحالي.

الحدّ من ارتفاع "إعلان البانر التكيُّفي" المضمّن

تكون "إعلانات البانر التكيُّفية" المضمّنة التي يتم إنشاء مثيل لها بدون قيمة maxHeight لها maxHeight مساوٍ لارتفاع الجهاز. للحدّ من ارتفاع "إعلان البانر التكيُّفي" المضمّن، استخدِم الطريقة AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).

مراجع إضافية

أمثلة على GitHub

نزِّل التطبيق النموذجي للاطّلاع على "إعلانات البانر التكيُّفية" المضمّنة أثناء عرضها.

Java Kotlin