Adaptive Inline-Banner für scrollende Banner verwenden

Bei adaptiven Bannern können Sie die Breite einer Anzeige angeben, um die optimale Anzeigengröße zu ermitteln. Außerdem wird die Leistung maximiert, indem die Anzeigengröße für jedes Gerät optimiert wird. Dieser Ansatz bietet Möglichkeiten für eine verbesserte Leistung.

Im Vergleich zu adaptiven Ankerbannern sind adaptive Inline-Banner größer und höher. Außerdem wird anstelle einer festen Höhe eine variable Höhe verwendet. Adaptive Inline-Banner haben eine variable Höhe und können den gesamten Bildschirm oder eine von Ihnen angegebene maximale Höhe einnehmen.

Sie platzieren adaptive Inline-Banner in scrollbaren Inhalten, z. B.:

Diagramm mit den Unterschieden zwischen adaptiven Bannern und adaptiven Inline-Bannern

Hinweis

Bevor Sie fortfahren, müssen Sie die Anleitung Erste Schritte mit Banneranzeigen durchgearbeitet haben, Banneranzeigen.

Adaptive Inline-Banner implementieren

Das folgende Beispiel veranschaulicht diese Schritte:

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

Beachten Sie bei der Implementierung adaptiver Banner in Ihrer App Folgendes:

  • Die Größen für adaptive Inline-Banner funktionieren am besten, wenn die gesamte verfügbare Breite genutzt wird. In den meisten Fällen entspricht diese Größe der vollen Breite des verwendeten Gerätebildschirms oder der vollen Breite des übergeordneten Inhalts des Banners. Sie müssen die Breite der Ansicht, die in der Anzeige platziert werden soll, die Gerätebreite, die Breite des übergeordneten Inhalts und die entsprechenden sicheren Bereiche kennen.
  • Möglicherweise müssen Sie Werbebuchungen aktualisieren oder neue erstellen, um mit adaptiven Größen zu arbeiten. Weitere Informationen.

Größe adaptiver Inline-Banner ausrichten

Verwenden Sie die folgenden Methoden, um eine adaptive Inline-Banneranzeige für eine bestimmte Ausrichtung vorab zu laden:

Wenn Ihre App sowohl die Hochformat- als auch die Querformatansicht unterstützt und Sie eine adaptive Banneranzeige in der aktuellen Ausrichtung vorab laden möchten, verwenden Sie AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) Mit dieser Methode wird eine Anzeige in der aktuellen Ausrichtung geladen.

Höhe adaptiver Inline-Banner begrenzen

Standardmäßig haben adaptive Inline-Banner, die ohne einen maxHeight-Wert instanziiert werden, einen maxHeight-Wert, der der Gerätehöhe entspricht. Verwenden Sie die AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) Methode, um die Höhe adaptiver Inline Banner zu begrenzen.