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 do Ad Manager a um app do Flutter.
Sempre teste 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:
/21775744923/example/rewarded
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 = '/21775744923/example/rewarded'; /// Loads a rewarded ad. void loadAd() { RewardedAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), 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
Com o uso de FullScreenContentCallback
, é possível detectar eventos de ciclo de vida,
como quando o anúncio é mostrado ou dispensado. Defina
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 = '/21775744923/example/rewarded'; /// Loads a rewarded ad. void loadAd() { RewardedAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), 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
é mostrado como uma sobreposição em cima de todo o conteúdo do app e é
colocado de forma estática. 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. Implemente essa opção e recompense o usuário por
assistir um anúncio.
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) { // Reward the user for watching an ad. });
Depois que show()
é chamado, um Ad
exibido dessa maneira não pode ser removido
por programação e requer a entrada do usuário. Só é possível mostrar uma RewardedAd
uma vez. As chamadas seguintes acionarão onAdFailedToShowFullScreenContent
.
Um anúncio precisa 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 mostrar anúncios premiados.