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

• 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.

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

void _loadAd() async {
  // Replace these test ad units with your own ad units.
  final String adUnitId = Platform.isAndroid
    ? 'ca-app-pub-3940256099942544/2014213617'
    : 'ca-app-pub-3940256099942544/8388050270';

  // Get the size before loading the ad.
  final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
      MediaQuery.sizeOf(context).width.truncate());

  if (size == null) {
    // Unable to get the size.
    return;
  }

  // Create an extra parameter that aligns the bottom of the expanded ad to the
  // bottom of the banner ad.
  const adRequest = AdRequest(extras: {
    "collapsible": "bottom",
  });

  BannerAd(
      adUnitId: adUnitId,
      request: adRequest,
      size: size,
      listener: const BannerAdListener()
  ).load();
}

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. Das liegt daran, dass das Einblenden eines minimierbaren Banners bei jeder Aktualisierung die Nutzerfreundlichkeit beeinträchtigen kann.

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:

BannerAd(
  // ...
  listener: BannerAdListener(
    onAdLoaded: (ad) {
      final bannerAd = ad as BannerAd;
      final isCollapsible = bannerAd.isCollapsible;
      print('The last loaded banner is ${isCollapsible ? "" : "not"} collapsible.');
    },
  ),
).load();

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.