Używanie wbudowanych banerów adaptacyjnych w przypadku banerów przewijanych

Banery adaptacyjne pozwalają określić szerokość reklamy, aby wyznaczyć jej optymalny rozmiar. Banery adaptacyjne zwiększają też skuteczność, optymalizując rozmiar reklamy na każdym urządzeniu. Dzięki temu można zwiększyć skuteczność.

W porównaniu z zakotwiczonymi banerami adaptacyjnymi wbudowane banery adaptacyjne są większe, wyższe i używają zmiennych zamiast stałych wysokości. Wbudowane banery adaptacyjne mają zmienną wysokość i mogą zajmować cały ekran lub maksymalną wysokość, którą określisz.

Wbudowane banery adaptacyjne umieszczasz w treściach, które można przewijać, np.:

Zanim zaczniesz

Zanim przejdziesz dalej, zapoznaj się z przewodnikiem dla początkujących, Reklamy banerowe.

Implementowanie wbudowanych banerów adaptacyjnych

Aby utworzyć rozmiar reklamy adaptacyjnej w tekście:

1. Pobierz szerokość używanego urządzenia lub ustaw własną szerokość, jeśli nie chcesz używać pełnej szerokości ekranu.

   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. Aby uzyskać obiekt rozmiaru reklamy adaptacyjnej w tekście dla wybranej orientacji, użyj metody statycznej w klasie rozmiaru reklamy:

   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

Podczas implementowania banerów adaptacyjnych w aplikacji pamiętaj o tych kwestiach:

• Rozmiary wbudowanych banerów adaptacyjnych najlepiej sprawdzają się, gdy używana jest pełna dostępna szerokość. W większości przypadków jest to pełna szerokość ekranu używanego urządzenia lub pełna szerokość treści nadrzędnych banera. Musisz znać szerokość widoku, który ma się wyświetlać w reklamie, szerokość urządzenia, szerokość treści nadrzędnych i odpowiednie bezpieczne obszary.

Orientowanie rozmiaru wbudowanego banera adaptacyjnego

Aby wstępnie wczytać wbudowany baner adaptacyjny w określonej orientacji, użyj tych metod:

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

Jeśli Twoja aplikacja obsługuje widoki w orientacji pionowej i poziomej oraz chcesz wstępnie wczytać reklamę banera adaptacyjnego w bieżącej orientacji, użyj AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) Ta metoda wczytuje reklamę w bieżącej orientacji.

Ograniczanie wysokości wbudowanego banera adaptacyjnego

Domyślnie wbudowane banery adaptacyjne utworzone bez wartości maxHeight mają wartość maxHeight równą wysokości urządzenia. Aby ograniczyć wysokość wbudowanego banera adaptacyjnego, użyj AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) metody.

Dodatkowe materiały

Przykłady w GitHub

Pobierz przykładową aplikację, aby zobaczyć, jak działają wbudowane banery adaptacyjne.

Java Kotlin