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 maksymalizują 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 banery adaptacyjne w tekście są większe, wyższe i używają zmiennych wysokości zamiast stałych. Banery adaptacyjne w tekście mają zmienną wysokość i mogą zajmować cały ekran lub maksymalną wysokość, którą określisz.

Banery adaptacyjne w tekście 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 banerów adaptacyjnych w tekście

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 banerów adaptacyjnych w tekście najlepiej sprawdzają się, gdy używasz pełnej dostępnej szerokości. W większości przypadków jest to pełna szerokość ekranu używanego urządzenia lub pełna szerokość treści nadrzędnej banera. Musisz znać szerokość widoku, który ma być umieszczony w reklamie, szerokość urządzenia, szerokość treści nadrzędnej i odpowiednie bezpieczne obszary.

• Aby korzystać z rozmiarów adaptacyjnych, może być konieczne zaktualizowanie lub utworzenie nowych elementów zamówienia. Więcej informacji.

Orientowanie rozmiaru banera adaptacyjnego w tekście

Aby wstępnie wczytać adaptacyjny baner reklamowy w tekście 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ć baner reklamowy adaptacyjny w bieżącej orientacji, użyj AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) Ta metoda wczytuje reklamę w bieżącej orientacji.

Ograniczanie wysokości banera adaptacyjnego w tekście

Domyślnie banery adaptacyjne w tekście, które są tworzone bez wartości maxHeight, mają wartość maxHeight równą wysokości urządzenia. Aby ograniczyć wysokość banera adaptacyjnego w tekście, użyj metody AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).

Dodatkowe materiały

Przykłady w GitHubie

Pobierz przykładową aplikację, aby zobaczyć, jak działają banery adaptacyjne w tekście.

Java Kotlin