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

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

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

يمكنك وضع إعلانات البانر التكيّفية المضمّنة في المحتوى الذي يمكن تصفّحه بالانتقال للأعلى والأسفل، مثل:

قبل البدء

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

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

بخلاف إعلانات البانر التكيُّفية الثابتة، يتم تحميل إعلانات البانر التكيُّفية المضمّنة باستخدام حجم إعلان بانر تكيُّفي مضمّن. لإنشاء حجم إعلان متكيّف مضمّن، عليك إكمال ما يلي:

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

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

   يوضّح المثال التالي هذه الخطوات:

   Kotlin

   private fun loadAd() {
     // Create an inline adaptive ad size. 320 is a placeholder value.
     // Replace 320 with your banner container width.
     val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)
   
     // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
     val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()
   
     // Step 2 - Load the ad.
     BannerAd.load(
       adRequest,
       object : AdLoadCallback<BannerAd> {
         override fun onAdLoaded(ad: BannerAd) {
           // Assign the loaded ad to the BannerAd object.
           bannerAd = ad
           // Step 3 - Call BannerAd.getView() to get the View and add it
           // to view hierarchy on the UI thread.
           activity?.runOnUiThread {
             binding.bannerViewContainer.addView(ad.getView(requireActivity()))
           }
         }
   
         override fun onAdFailedToLoad(loadAdError: LoadAdError) {
           bannerAd = null
         }
       }
     )
   }
   

   Java

   private void loadAd() {
     // Create an inline adaptive ad size. 320 is a placeholder value.
     // Replace 320 with your banner container width.
     AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);
   
     // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
     BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
         adSize).build();
   
     // Step 2 - Load the ad.
     BannerAd.load(
         adRequest,
         new AdLoadCallback<BannerAd>() {
           @Override
           public void onAdLoaded(@NonNull BannerAd ad) {
             // Assign the loaded ad to the BannerAd object.
             bannerAd = ad;
             // Step 3 - Call BannerAd.getView() to get the View and add it
             // to view hierarchy on the UI thread.
             if (getActivity() != null) {
               getActivity()
                   .runOnUiThread(() ->
                       binding.bannerViewContainer.addView(ad.getView(getActivity())));
             }
           }
   
           @Override
           public void onAdFailedToLoad(@NonNull LoadAdError adError) {
             bannerAd = null;
           }
         });
   }
   

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

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

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

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

   • 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).