Interstitial-Anzeigen sind Vollbildanzeigen, die die Benutzeroberfläche ihrer Host-App überlagern. 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 in einer App eine Interstitial-Anzeige eingeblendet wird, kann der Nutzer entweder auf die Anzeige tippen und zum Ziel weitergeleitet werden oder sie schließen und zur App zurückkehren.
In diesem Leitfaden wird erläutert, 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 Produktionsanzeigen. Andernfalls kann Ihr Konto gesperrt werden.
Am einfachsten lassen sich Testanzeigen laden, wenn Sie die spezielle Test-Anzeigenblock-ID für Interstitials verwenden:
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 einfach vor dem Veröffentlichen Ihrer App durch Ihre Anzeigenblock-IDs.
Anzeige laden
Im folgenden Beispiel wird eine Interstitial-Anzeige geladen:
class InterstitialExampleState extends State<InterstitialExample> { InterstitialAd? _interstitialAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = Platform.isAndroid ? 'ca-app-pub-3940256099942544/1033173712' : 'ca-app-pub-3940256099942544/4411468910'; /// Loads an interstitial ad. void loadAd() { InterstitialAd.load( adUnitId: adUnitId, request: const AdRequest(), adLoadCallback: InterstitialAdLoadCallback( // Called when an ad is successfully received. onAdLoaded: (ad) { debugPrint('$ad loaded.'); // Keep a reference to the ad so you can show it later. _interstitialAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('InterstitialAd failed to load: $error'); }, )); } }
Ereignisse für Interstitial-Anzeigen
Mit FullScreenContentCallback
können Sie auf Lebenszyklusereignisse achten, z. B. wenn die Anzeige ausgeliefert oder geschlossen wird. Legen Sie InterstitialAd.fullScreenContentCallback
fest, bevor die Anzeige ausgeliefert wird, um Benachrichtigungen für diese Ereignisse zu erhalten. In diesem Beispiel werden alle Methoden implementiert:
class InterstitialExampleState extends State<InterstitialExample> { InterstitialAd? _interstitialAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = Platform.isAndroid ? 'ca-app-pub-3940256099942544/1033173712' : 'ca-app-pub-3940256099942544/4411468910'; /// Loads an interstitial ad. void loadAd() { InterstitialAd.load( adUnitId: adUnitId, request: const AdRequest(), adLoadCallback: InterstitialAdLoadCallback( // Called when an ad is successfully received. onAdLoaded: (ad) { ad.fullScreenContentCallback = FullScreenContentCallback( // Called when the ad showed the full screen content. onAdShowedFullScreenContent: (ad) {}, // Called when an impression occurs on the ad. onAdImpression: (ad) {}, // Called when the ad failed to show full screen content. onAdFailedToShowFullScreenContent: (ad, err) { // Dispose the ad here to free resources. ad.dispose(); }, // Called when the ad dismissed full screen content. onAdDismissedFullScreenContent: (ad) { // Dispose the ad here to free resources. ad.dispose(); }, // Called when a click is recorded for an ad. onAdClicked: (ad) {}); debugPrint('$ad loaded.'); // Keep a reference to the ad so you can show it later. _interstitialAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('InterstitialAd failed to load: $error'); }, )); } }
Interstitial-Anzeige ausliefern
Ein InterstitialAd
wird als Overlay
über allen App-Inhalten angezeigt und statisch platziert. Es kann daher nicht dem Flutter-Widget-Baum hinzugefügt werden. Durch Aufrufen von show()
können Sie festlegen, wann die Anzeige ausgeliefert werden soll.
_interstitiaAd.show();
Nachdem show()
aufgerufen wurde, kann ein auf diese Weise angezeigtes Ad
nicht mehr programmatisch geschlossen werden und erfordert eine Nutzereingabe. Ein InterstitialAd
kann nur einmal angezeigt werden. Nachfolgende Aufrufe, die angezeigt werden sollen, lösen onAdFailedToShowFullScreenContent
aus.
Eine Anzeige muss gelöscht werden, wenn der Zugriff darauf nicht mehr erforderlich ist. Am besten wird dispose()
in den FullScreenContentCallback.onAdDismissedFullScreenContent
- und FullScreenContentCallback.onAdFailedToShowFullScreenContent
-Callbacks aufgerufen.
Fertig! In Ihrer App können jetzt Interstitial-Anzeigen ausgeliefert werden.
Nächste Schritte
- Weitere Informationen finden Sie in den Best Practices für Interstitials und im Leitfaden für Interstitial-Anzeigen.
- Fallstudie zu Interstitial-Anzeigen
- Falls noch nicht geschehen, erstellen Sie in der AdMob-Benutzeroberfläche einen eigenen Anzeigenblock für Interstitial-Anzeigen.