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

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

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

يغطّي هذا الدليل إنشاء "إعلانات بانر تكيُّفية مضمّنة" وتحديد حجم البانر.

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

قبل البدء

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

لعرض مثال كامل على "إعلان بانر تكيُّفي مضمّن"، نزِّل نموذج التطبيق التالي:

• Java
• Kotlin

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

لتنفيذ إعلانات البانر التكيُّفية المضمّنة، عليك ضبط حجم الإعلان وإنشاء طلب عرض الإعلان وتحميل الإعلان.

لتحديد حجم "إعلان بانر تكيُّفي مضمّن"، حدِّد عرض الإعلان. تشمل الطرق الشائعة ما يلي:

• استخدام عرض ملء الشاشة
• استخدام عرض تصميم العنصر الرئيسي الذي يحتوي على الإعلان
• تعديل العرض لمراعاة المناطق الآمنة للجهاز

عند إنشاء عنصر حجم الإعلان، استخدِم هذا العرض المحسوب.

أكمِل الخطوات التالية:

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

   Java

   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

   Java

   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 ارتفاعًا أقصى يساوي ارتفاع الجهاز. للحدّ من ارتفاع "إعلان البانر التكيُّفي المضمّن" ، استخدِم الطريقة AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).