Reklamy z nagrodą to reklamy, z którymi użytkownicy mogą wchodzić w interakcje w zamian za nagrody w aplikacji. Z tego przewodnika dowiesz się, jak zintegrować reklamy z nagrodą z AdMob w aplikacji Flutter.
Zawsze korzystaj z reklam testowych
Podczas tworzenia i testowania aplikacji używaj reklam testowych, a nie produkcyjnych reklam. Jeśli tego nie zrobisz, możemy zawiesić Twoje konto.
Najłatwiejszym sposobem wczytania reklam testowych jest użycie dedykowanego testowego identyfikatora jednostki reklamowej przeznaczonej do reklam z nagrodą:
Android
ca-app-pub-3940256099942544/5224354917
iOS
ca-app-pub-3940256099942544/1712485313
Testowe jednostki reklamowe są skonfigurowane tak, aby zwracać reklamy testowe w przypadku każdego żądania. Możesz ich używać we własnych aplikacjach podczas kodowania, testowania i debugowania. Pamiętaj tylko, aby przed opublikowaniem aplikacji zastąpić je własnymi identyfikatorami jednostek reklamowych.
Wczytywanie reklamy
Ten przykład wczytuje reklamę z nagrodą:
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');
},
));
}
}
Zdarzenia reklamy z nagrodą
FullScreenContentCallback pozwala rejestrować zdarzenia cyklu życia, np. wyświetlenie lub odrzucenie reklamy. Przed wyświetleniem reklamy ustaw RewardedAd.fullScreenContentCallback, aby otrzymywać powiadomienia o tych zdarzeniach. Ten przykład implementuje każdą metodę i rejestruje komunikat w konsoli:
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');
},
));
}
}
Reklama displayowa
RewardedAd wyświetla się jako nakładka na całej zawartości aplikacji i jest statycznie rozmieszczona, więc nie można jej dodać do drzewa widżetów Flutter. Aby wybrać, kiedy wyświetlić reklamę, wywołaj show().
RewardedAd.show() przyjmuje wartość OnUserEarnedRewardCallback, która jest wywoływana, gdy użytkownik zdobędzie nagrodę. Pamiętaj, by zaimplementować tę funkcję i nagrodzić użytkownika za obejrzenie reklamy.
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) {
// Reward the user for watching an ad.
});
Po wywołaniu funkcji show() obiekt Ad wyświetlany w ten sposób nie może zostać usunięty automatycznie i wymaga danych wejściowych użytkownika. Element RewardedAd może zostać wyświetlony
tylko raz. Kolejne wywołania wywołają onAdFailedToShowFullScreenContent.
Reklamę należy wyrzucić, gdy dostęp do niej nie jest już potrzebny. Sprawdzoną metodą określającą, kiedy należy wywoływać funkcję dispose(), jest wywoływanie wywołań zwrotnych FullScreenContentCallback.onAdDismissedFullScreenContent i FullScreenContentCallback.onAdFailedToShowFullScreenContent.
Znakomicie. Możesz już wyświetlać w swojej aplikacji reklamy z nagrodą.