Minimierbare Banneranzeigen

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

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

• Lesen Sie den Startleitfaden für Banneranzeigen.

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:

Kotlin

private fun loadCollapsibleBannerAd(adView: AdView, activity: Activity) {
  val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360)

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

  val adRequest =
    BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.i(
          TAG,
          "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
        )
      }


      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

Java

private void loadCollapsibleBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  AdSize adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360);

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

  BannerAdRequest adRequest =
      new BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          Log.i(
              TAG,
              String.format(
                  "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
        }


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

Ersetzen Sie AD_UNIT_ID durch die ID Ihres Anzeigenblocks.

Verhalten bei der Anzeigenaktualisierung

Wenn für Apps die automatische Aktualisierung von Banneranzeigen in der AdMob-Weboberfläche konfiguriert ist, wird bei nachfolgenden Aktualisierungen der Anzeige das Format nicht mehr berücksichtigt, wenn eine minimierbare Banneranzeige für eine Bannerfläche angefordert wird. 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

Nicht minimierbare Banneranzeigen können für Anfragen für minimierbare Banner 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:

Kotlin

override fun onAdLoaded(ad: BannerAd) {
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
  )
}
BannerSnippets.kt

Java

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  Log.i(
      TAG,
      String.format(
          "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
}
BannerSnippets.java

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.