Minimierbare Banner verwenden

Minimierbare Banneranzeigen sind Banneranzeigen, die zuerst als größeres Overlay mit einer Schaltfläche angezeigt werden, über die sie auf die ursprünglich angeforderte Bannergröße minimiert werden können. Minimierbare Banneranzeigen sollen die Leistung von Ankeranzeigen verbessern, die ansonsten kleiner sind. In diesem Leitfaden erfahren Sie, wie Sie minimierbare Banneranzeigen für vorhandene Banner-Placements aktivieren.

Vorbereitung

Implementierung

Achten Sie darauf, dass die Banneransicht mit der Größe definiert ist, die Nutzer im herkömmlichen (minimierten) Bannerstatus sehen sollen. Fügen Sie der Anzeigenanfrage einen Extras-Parameter mit collapsible als Schlüssel und dem Placement der Anzeige als Wert hinzu.

Das minimierbare Placement definiert, wie der maximierte Bereich an der Banneranzeige verankert wird.

Placement Wert Verhalten Vorgesehener Anwendungsfall
top Der obere Rand der maximierten Anzeige wird am oberen Rand der minimierten Anzeige ausgerichtet. Die Anzeige wird oben auf dem Bildschirm platziert.
bottom Der untere Rand der maximierten Anzeige wird am unteren Rand der minimierten Anzeige ausgerichtet. Die Anzeige wird unten auf dem Bildschirm platziert.

Wenn die geladene Anzeige ein minimierbares Banner ist, wird das minimierbare Overlay sofort angezeigt, sobald es in der Ansichtshierarchie platziert wurde:

Java

private void loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

Kotlin

private fun loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

Verhalten bei der Anzeigenaktualisierung

Wenn Sie in der AdMob-Weboberfläche die automatische Aktualisierung für Banneranzeigen in Apps konfigurieren, wird bei nachfolgenden Aktualisierungen der Anzeige das Format nicht mehr berücksichtigt, sobald eine minimierbare Banneranzeige für eine Bannerfläche angefordert wurde. Wenn bei jeder Aktualisierung ein minimierbares Banner eingeblendet wird, kann sich das negativ auf die Nutzerfreundlichkeit auswirken.

Wenn Sie später in der Sitzung eine weitere minimierbare Banneranzeige laden möchten, können Sie eine Anzeige manuell mit einer Anfrage laden, die den Parameter für das minimierbare Banner enthält.

Prüfen, ob eine geladene Anzeige minimiert werden kann

Bei Anfragen für minimierbare Banner können nicht minimierbare Banneranzeigen zurückgegeben werden, um die Leistung zu maximieren. Wenn die Anfrage nicht geladen werden kann und das vorherige Banner minimierbar ist, gibt die API den Wert true zurück. Mit der Methode isCollapsible können Sie prüfen, ob das zuletzt geladene Banner minimierbar ist:

Java

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}

Vermittlung

Minimierbare Banneranzeigen sind nur für die Google-Nachfrage verfügbar. Anzeigen, die über die Vermittlung ausgeliefert werden, werden als normale, nicht minimierbare Banneranzeigen ausgeliefert.