Anzeigen mit Prämie sind Anzeigen, mit denen Nutzer interagieren können, um In-App-Prämien zu erhalten. In diesem Leitfaden erfahren Sie, wie Sie Anzeigen mit Prämie von AdMob in eine Flutter-App einbinden.
Immer mit Testanzeigen testen
Verwenden Sie beim Erstellen und Testen Ihrer Apps Testanzeigen statt Live-Produktionsanzeigen. Sollten Sie dies nicht tun, kann Ihr Konto gesperrt werden.
Testanzeigen lassen sich am einfachsten mit der entsprechenden Anzeigenblock-ID für Anzeigen mit Prämie laden:
Android
ca-app-pub-3940256099942544/5224354917
iOS
ca-app-pub-3940256099942544/1712485313
Die Testanzeigenblöcke sind so konfiguriert, dass für jede Anfrage Testanzeigen zurückgegeben werden. Sie können sie beim Codieren, Testen und Debuggen in Ihren eigenen Apps verwenden. Ersetzen Sie sie einfach durch Ihre eigenen Anzeigenblock-IDs, bevor Sie Ihre App veröffentlichen.
Anzeige laden
Im folgenden Beispiel wird eine Anzeige mit Prämie geladen:
class RewardedExampleState extends State<RewardedExample> {
RewardedAd? _rewardedAd;
// TODO: replace this test ad unit with your own ad unit.
final adUnitId = Platform.isAndroid
? 'ca-app-pub-3940256099942544/5224354917'
: 'ca-app-pub-3940256099942544/1712485313';
/// Loads a rewarded ad.
void loadAd() {
RewardedAd.load(
adUnitId: adUnitId,
request: const AdRequest(),
adLoadCallback: RewardedAdLoadCallback(
// Called when an ad is successfully received.
onAdLoaded: (ad) {
debugPrint('$ad loaded.');
// Keep a reference to the ad so you can show it later.
_rewardedAd = ad;
},
// Called when an ad request failed.
onAdFailedToLoad: (LoadAdError error) {
debugPrint('RewardedAd failed to load: $error');
},
));
}
}
Ereignisse für Anzeigen mit Prämie
Mithilfe von FullScreenContentCallback können Sie Lebenszyklusereignisse überwachen, z. B. wenn sie ausgeliefert oder verworfen werden. Legen Sie RewardedAd.fullScreenContentCallback fest, bevor die Anzeige für Benachrichtigungen zu diesen Ereignissen ausgeliefert wird. In diesem Beispiel wird jede Methode implementiert und eine Nachricht in der Konsole protokolliert:
class RewardedExampleState extends State<RewardedExample> {
RewardedAd? _rewardedAd;
// TODO: replace this test ad unit with your own ad unit.
final adUnitId = Platform.isAndroid
? 'ca-app-pub-3940256099942544/5224354917'
: 'ca-app-pub-3940256099942544/1712485313';
/// Loads a rewarded ad.
void loadAd() {
RewardedAd.load(
adUnitId: adUnitId,
request: const AdRequest(),
adLoadCallback: RewardedAdLoadCallback(
// 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.
_rewardedAd = ad;
},
// Called when an ad request failed.
onAdFailedToLoad: (LoadAdError error) {
debugPrint('RewardedAd failed to load: $error');
},
));
}
}
Displayanzeige
Eine RewardedAd wird als Overlay über dem gesamten App-Inhalt angezeigt und statisch platziert. Daher kann sie dem Flutter-Widgetbaum nicht hinzugefügt werden. Sie können durch Aufrufen von show() festlegen, wann die Anzeige ausgeliefert werden soll.
RewardedAd.show() verwendet einen OnUserEarnedRewardCallback, der aufgerufen wird, wenn der Nutzer eine Prämie erhält. Implementieren Sie dies und belohnen Sie den Nutzer für das Ansehen einer Anzeige.
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) {
// Reward the user for watching an ad.
});
Nachdem show() aufgerufen wurde, kann eine auf diese Weise angezeigte Ad nicht programmatisch entfernt werden und erfordert eine Nutzereingabe. Eine RewardedAd kann nur einmal angezeigt werden. Bei nachfolgenden Aufrufen wird onAdFailedToShowFullScreenContent ausgelöst.
Eine Anzeige muss entsorgt werden, wenn kein Zugriff mehr darauf erforderlich ist. Die Best Practice für den Aufruf von dispose() ist in den Callbacks FullScreenContentCallback.onAdDismissedFullScreenContent und FullScreenContentCallback.onAdFailedToShowFullScreenContent.
Fertig! In Ihrer App können jetzt Anzeigen mit Prämie ausgeliefert werden.