Как использовать встроенные адаптивные баннеры для прокручиваемых баннеров

Адаптивные баннеры позволяют задать ширину объявления, чтобы определить оптимальный размер для каждого устройства. В отличие от фиксированных адаптивных баннеров, встроенные адаптивные баннеры больше по размеру и высоте и не имеют фиксированной высоты. Встроенные адаптивные баннеры имеют переменную высоту. Такие баннеры могут занимать весь экран или иметь максимальную высоту, которую вы зададите.

В этом руководстве рассказывается, как создавать встроенные адаптивные баннеры и задавать их размер.

На изображении ниже показаны адаптивные встроенные баннеры в прокручиваемом контенте.

Подготовка

Прежде чем продолжить, настройте баннеры.

Чтобы посмотреть пример встроенного адаптивного баннера, скачайте следующее приложение:

• 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. Чтобы получить объект адаптивного встроенного объявления, используйте статический метод класса ad size:

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