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

Wybierz platformę: Android Nowy Android iOS Flutter

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

Diagram pokazujący różnice między banerami adaptacyjnymi a wbudowanymi banerami adaptacyjnymi

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()
  }

    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);
}

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

    Java

    final AdView adView = new AdView(MainActivity.this);
adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, getAdWidth()));

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:

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