Adaptive Inline-Banneranzeigen

Plattform auswählen: Android iOS Flutter Android (Legacy)

Bei adaptiven Bannern können Sie die Breite einer Anzeige angeben, um die optimale Anzeigengröße für jedes Gerät zu bestimmen. Im Gegensatz zu adaptiven Ankerbannern sind adaptive Inline-Banner größer und höher und haben keine festen Höhen. Adaptive Inline-Banner haben eine variable Höhe. Diese Banner können den gesamten Bildschirm oder eine von Ihnen angegebene maximale Höhe ausfüllen.

In diesem Leitfaden wird beschrieben, wie Sie adaptive Inline-Banner erstellen und die Bannergröße festlegen.

Die folgende Abbildung zeigt adaptive Inline-Banner in scrollbaren Inhalten:

Diagramm, das die Unterschiede zwischen adaptiven Bannern und adaptiven Inline-Bannern zeigt

Hinweis

Bevor Sie fortfahren, müssen Sie Banneranzeigen einrichten.

Wenn Sie sich ein vollständiges Beispiel für ein adaptives Inline-Banner ansehen möchten, laden Sie die folgende Beispiel-App herunter:

Adaptive Inline-Banner implementieren

Wenn Sie adaptive Inline-Banner implementieren möchten, legen Sie die Anzeigengröße fest, erstellen eine Anzeigenanfrage und laden die Anzeige.

Wenn Sie die Größe eines adaptiven Inline-Banners festlegen möchten, müssen Sie die Anzeigenbreite bestimmen. Zu den gängigen Ansätzen gehören:

  • Verwendung der gesamten Bildschirmbreite.
  • Die Breite des übergeordneten Layouts, das die Anzeige enthält, wird verwendet.
  • Anpassen der Breite, um die sicheren Bereiche des Geräts zu berücksichtigen.

Verwenden Sie diese berechnete Breite, wenn Sie das Objekt für die Anzeigengröße erstellen.

Im folgenden Beispiel wird die Anzeigengröße festgelegt, eine Anzeigenanfrage erstellt und die Anzeige geladen:

Kotlin

private fun loadInlineAdaptiveBannerAd(adView: AdView, activity: Activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val bannerWidth = 320
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Inline adaptive banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Inline adaptive banner ad failed to load: $adError")
      }
    },
  )
}

Java

private void loadInlineAdaptiveBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  int bannerWidth = 320;
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Inline adaptive banner ad loaded.");
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Inline adaptive banner ad failed to load: " + adError);
        }
      });
}

Ersetzen Sie AD_UNIT_ID durch die ID Ihres Anzeigenblocks.

Legen Sie eine Anzeigengröße fest, die kleiner oder gleich der Bildschirmgröße des Geräts ist. Verwenden Sie die Methode Resources.getDisplayMetrics, um die maximale Bildschirmgröße zu ermitteln. Für die Abmessungen des AdSize-Objekts werden dichteunabhängige Pixel (dp) verwendet. Rechnen Sie die Bildschirmgröße beim Vergleichen von Pixel in dp um. Weitere Informationen zu Größenbeschränkungen finden Sie unter Größenanforderungen für Anzeigenanfragen.

Layout für adaptives Inline-Banner festlegen

Verwenden Sie die folgenden Methoden, um eine adaptive Inline-Banneranzeige für ein bestimmtes Layout vorab zu laden:

Wenn Ihre App das Hoch- und Querformat unterstützt und Sie eine adaptive Banneranzeige im aktuellen Layout vorab laden möchten, verwenden Sie die Methode AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width). Mit dieser Methode wird eine Anzeige im aktuellen Layout geladen.

Höhe adaptiver Inline-Banner begrenzen

Standardmäßig haben adaptive Inline-Banner, die ohne einen maxHeight-Wert erstellt wurden, eine maximale Höhe, die der Gerätehöhe entspricht. Wenn Sie die Höhe des adaptiven Inline-Banners begrenzen möchten, verwenden Sie die Methode AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).