Interstitial-Anzeigen

Plattform auswählen: Android Neu Android iOS Unity Flutter

Interstitial-Anzeigen sind Vollbildanzeigen, die die Benutzeroberfläche der Host-App abdecken. Sie werden in der Regel an natürlichen Übergangspunkten innerhalb einer App angezeigt, beispielsweise zwischen Aktivitäten oder in den Pausen zwischen den Levels eines Spiels. Wenn eine App eine Interstitial-Anzeige einblendet, kann der Nutzer entweder auf die Anzeige tippen und zur Zielseite weitergeleitet werden oder die Anzeige schließen und zur App zurückkehren.

In dieser Anleitung wird beschrieben, wie Sie Interstitial-Anzeigen in eine Flutter-App einbinden.

Immer mit Testanzeigen testen

Verwenden Sie beim Erstellen und Testen Ihrer Apps Testanzeigen anstelle von aktiven Anzeigen. Andernfalls kann es zur Sperrung Ihres Kontos kommen.

Testanzeigen lassen sich am einfachsten mit unserer speziellen Test-Anzeigenblock-ID für Interstitials laden:

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Die Testanzeigenblöcke sind so konfiguriert, dass bei jeder Anfrage Testanzeigen zurückgegeben werden. Sie können sie beim Programmieren, Testen und Debuggen in Ihren eigenen Apps verwenden. Ersetzen Sie sie jedoch vor der Veröffentlichung Ihrer App durch Ihre eigenen Anzeigenblock-IDs.

Anzeige laden

Im folgenden Beispiel wird eine Interstitial-Anzeige geladen:

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  adLoadCallback: InterstitialAdLoadCallback(
    onAdLoaded: (InterstitialAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _interstitialAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);

Ersetzen Sie _adUnitId durch Ihre eigene Anzeigenblock-ID.

Interstitial-Anzeigenereignisse

Mit FullScreenContentCallback können Sie auf Lebenszyklusereignisse wie das Einblenden oder Schließen der Anzeige warten. Legen Sie InterstitialAd.fullScreenContentCallback fest, bevor Sie die Anzeige einblenden, um Benachrichtigungen zu diesen Ereignissen zu erhalten. In diesem Beispiel wird jede Methode implementiert:

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);

Interstitial-Anzeige einblenden

Ein InterstitialAd wird als Overlay über allen App-Inhalten angezeigt und ist statisch platziert. Sie kann also nicht dem Flutter-Widget-Baum hinzugefügt werden. Sie können festlegen, wann die Anzeige eingeblendet werden soll, indem Sie show() aufrufen.

_interstitialAd?.show();

Sobald show() aufgerufen wird, kann eine so angezeigte Ad nicht programmatisch geschlossen werden. Dazu ist eine Nutzereingabe erforderlich. Eine InterstitialAd kann nur einmal angezeigt werden. Bei nachfolgenden Aufrufen von „show“ wird onAdFailedToShowFullScreenContent ausgelöst.

Eine Anzeige muss verworfen werden, wenn der Zugriff darauf nicht mehr erforderlich ist. Die Best Practice für den Aufruf von dispose() besteht in den Callbacks FullScreenContentCallback.onAdDismissedFullScreenContent und FullScreenContentCallback.onAdFailedToShowFullScreenContent.

Jetzt weißt du Bescheid. In Ihrer App können jetzt Interstitial-Anzeigen ausgeliefert werden.

Nächste Schritte

Vollständiges Beispiel auf GitHub

Interstitial