Adaptive Inline-Banner für scrollende Banner verwenden

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 ermitteln. Im Gegensatz zu verankerten adaptiven Bannern sind adaptive Inline-Banner größer und höher und haben keine feste Höhe. Die Höhe adaptiver Inline-Banner ist variabel. Diese Banner können den gesamten Bildschirm oder eine von Ihnen angegebene maximale Höhe einnehmen.

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

Das folgende Bild zeigt adaptive Inline-Banner in scrollbaren Inhalten:

Hinweis

Bevor Sie fortfahren, müssen Sie Banneranzeigen einrichten.

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

• Java
• Kotlin

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.

Um die Größe eines adaptiven Inline-Banners festzulegen, bestimmen Sie die Anzeigenbreite. Dabei gibt es verschiedene Möglichkeiten:

• Die gesamte Bildschirmbreite verwenden
• Die Breite des übergeordneten Layouts verwenden, das die Anzeige enthält
• Die Breite an die sicheren Bereiche des Geräts anpassen

Verwenden Sie diese berechnete Breite, wenn Sie das Anzeigengrößenobjekt erstellen.

Gehen Sie folgendermaßen vor:

1. Ermitteln Sie die Breite Ihres Geräts oder legen Sie eine Breite fest:

   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. Verwenden Sie eine statische Methode für die Anzeigengrößenklasse, um ein adaptives Inline-Anzeigengrößenobjekt zu erhalten:

   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

Legen Sie eine Anzeigengröße fest, die kleiner oder gleich der Bildschirmgröße des Geräts ist. Verwenden Sie die Resources.getDisplayMetrics Methode, um die maximale Bildschirmgröße zu ermitteln. Die Abmessungen des AdSize-Objekts werden in dichteunabhängigen Pixeln (dp) angegeben. Wenn Sie die Bildschirmgröße vergleichen, müssen Sie sie von Pixeln in dp umrechnen. Weitere Informationen zu Größenbeschränkungen finden Sie unter Probleme mit nicht ausgelieferten Impressionen in Ad Manager beheben.

**Wichtig**: Sie können Ad Manager-Reservierungsanzeigengrößen in derselben Anzeigen fläche wie Anzeigen mit adaptiver Bannergröße ausliefern.

Wenn Sie Werbebuchungen aktualisieren oder erstellen müssen, um adaptive Banner zu verwenden, lesen Sie den Hilfeartikel Werbebuchungen für adaptive Banner einrichten.

Layout für adaptive Inline-Banner festlegen

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

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

Wenn Ihre App sowohl das Hoch- als auch das Querformat unterstützt und Sie eine adaptive Banneranzeige im aktuellen Layout vorladen möchten, verwenden Sie die AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) Methode. 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 Höhe des Geräts entspricht. Verwenden Sie die AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) Methode, um die Höhe adaptiver Inline Banner zu begrenzen.