Os anúncios premiados são aqueles com que os usuários podem interagir em troca da para recompensas no app. Este guia mostra como integrar anúncios premiados da AdMob a um app Flutter.
Sempre faça testes com anúncios de teste
Ao criar e testar seus apps, use anúncios de teste em vez de anúncios de produção ativos. Sua conta poderá ser suspensa se isso não for feito.
A maneira mais fácil de carregar anúncios de teste é usar nosso ID de bloco de anúncios de teste dedicado para anúncios premiados:
Android
ca-app-pub-3940256099942544/5224354917
iOS
ca-app-pub-3940256099942544/1712485313
Os blocos de anúncios de teste são configurados para retornar anúncios de teste para cada solicitação, e você pode usá-las nos seus próprios apps durante a programação, o teste e a depuração. Basta substituí-los pelos seus próprios IDs de bloco de anúncios antes de publicar seu app.
Carregar um anúncio
O exemplo a seguir carrega um anúncio premiado:
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'); }, )); } }
Eventos de anúncios premiados
Usando FullScreenContentCallback
, é possível detectar ciclos de vida
eventos, como quando o anúncio é mostrado ou dispensado. Definir
RewardedAd.fullScreenContentCallback
antes de mostrar o anúncio para receber
notificações desses eventos. Este exemplo implementa cada método e registra uma
para o console:
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'); }, )); } }
Anúncio de display
Um RewardedAd
é exibido como uma sobreposição sobre todo o conteúdo do app e é
colocado estaticamente, portanto, ele não pode ser adicionado à árvore de widgets do Flutter. Você pode
escolher quando mostrar o anúncio chamando show()
.
RewardedAd.show()
usa um OnUserEarnedRewardCallback
, que é invocado quando
o usuário ganha uma recompensa. Certifique-se de implementar isso e recompense o usuário por
assistir a um anúncio.
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) { // Reward the user for watching an ad. });
Depois que show()
é chamado, um Ad
mostrado dessa forma não pode ser removido
de forma programática e exige entrada do usuário. Só é possível mostrar uma RewardedAd
uma vez. As chamadas seguintes acionarão onAdFailedToShowFullScreenContent
.
Um anúncio deverá ser descartado quando o acesso a ele não for mais necessário. A prática recomendada
para quando chamar dispose()
está no
FullScreenContentCallback.onAdDismissedFullScreenContent
e
Callbacks FullScreenContentCallback.onAdFailedToShowFullScreenContent
.
Pronto! Seu app está pronto para exibir anúncios premiados.