Minimierbare Banneranzeigen werden zuerst als größeres Overlay mit einer Schaltfläche angezeigt, über die sie auf die ursprünglich angeforderte Bannergröße minimiert werden können. Sie sollen die Leistung von verankerten Anzeigen verbessern, die ansonsten kleiner sind. In dieser Anleitung erfahren Sie, wie Sie minimierbare Banner anzeigen für vorhandene Banner-Placements aktivieren.
Vorbereitung
- Führen Sie die Schritte in der Anleitung Erste Schritte mit Banneranzeigen aus.
Implementierung
Achten Sie darauf, dass die Banneransicht mit der Größe definiert ist, die Nutzer
im normalen (minimierten) Bannerstatus sehen sollen. Fügen Sie der Anzeigenanfrage einen Parameter für Extras mit collapsible als Schlüssel und dem Placement der Anzeige als Wert hinzu.
Das minimierbare Placement definiert, wie die maximierte Region an der Banner anzeige verankert wird.
Placement Wert
|
Verhalten | Vorgesehener Anwendungsfall |
|---|---|---|
top |
Die Oberseite der maximierten Anzeige wird an der Oberseite der minimierten Anzeige ausgerichtet. | Die Anzeige wird oben auf dem Bildschirm platziert. |
bottom |
Die Unterseite der maximierten Anzeige wird an der Unterseite der minimierten Anzeige ausgerichtet. | Die Anzeige wird unten auf dem Bildschirm platziert. |
Wenn die geladene Anzeige ein minimierbarer Banner ist, wird das minimierbare Overlay sofort angezeigt, sobald es in die Ansichtshierarchie platziert wird.
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 beim Aktualisieren von Anzeigen
Wenn in Apps die automatische Aktualisierung für Banneranzeigen in der AdMob-Weboberfläche konfiguriert ist und eine minimierbare Banneranzeige für einen Banner-Slot angefordert wird, wird das Format bei nachfolgenden Aktualisierungen der Anzeige nicht mehr berücksichtigt. Das liegt daran, dass die Anzeige eines minimierbaren Banners bei jeder Aktualisierung die Nutzerfreundlichkeit beeinträchtigen kann.
Wenn Sie später eine weitere minimierbare Banneranzeige laden möchten, können Sie eine Anzeige manuell mit einer Anfrage laden, die den Parameter für minimierbare Banner enthält.
Prüfen, ob eine geladene Anzeige minimierbar ist
Nicht minimierbare Banneranzeigen können für Anfragen für minimierbare Banner
zurückgegeben werden, um die Leistung zu maximieren. Rufen Sie isCollapsible auf, um zu prüfen, ob der zuletzt
geladene Banner minimierbar ist. Wenn die Anfrage nicht geladen werden kann und der vorherige
Banner minimierbar ist, gibt die API den Wert true zurück.
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 angezeigt.