Os anúncios intersticiais são anúncios de tela cheia que cobrem a interface do app host. Normalmente, eles são exibidos em pontos de transição naturais no fluxo de um app, como entre atividades ou durante a pausa entre os níveis de um jogo. Quando um app mostra um anúncio intersticial, o usuário pode tocar no anúncio e continuar para o destino ou fechá-lo e retornar ao app.
Este guia explica como integrar anúncios intersticiais a um app do Flutter.
Sempre faça testes com anúncios de teste
Ao criar e testar seus apps, use anúncios de teste em vez de publicidade de produção ativa. 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 intersticiais:
Android
ca-app-pub-3940256099942544/1033173712
iOS
ca-app-pub-3940256099942544/4411468910
Os blocos de teste são configurados para retornar anúncios de teste para cada solicitação, e você pode usá-los nos seus próprios apps durante a programação, o teste e a depuração. Substitua-os pelos seus próprios IDs de bloco de anúncios antes de publicar o app.
Carregar um anúncio
O exemplo a seguir carrega um anúncio intersticial:
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'); }, )); } }
Eventos de anúncios intersticiais
Com o uso de FullScreenContentCallback
, é possível detectar eventos de ciclo de vida, como quando o anúncio é mostrado ou dispensado. Defina
InterstitialAd.fullScreenContentCallback
antes de mostrar o anúncio para receber
notificações desses eventos. Este exemplo implementa cada método:
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'); }, )); } }
Mostrar um anúncio intersticial
Um InterstitialAd
é exibido como um Overlay
acima 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()
.
_interstitiaAd.show();
Depois que show()
é chamado, um Ad
exibido dessa maneira não pode ser dispensado
de forma programática e exige entrada do usuário. Um InterstitialAd
só pode ser mostrado
uma vez. As chamadas seguintes para mostrar vão acionar onAdFailedToShowFullScreenContent
.
Um anúncio precisa ser descartado quando o acesso a ele não for mais necessário. A prática recomendada
para chamar dispose()
está nos
callbacks FullScreenContentCallback.onAdDismissedFullScreenContent
e
FullScreenContentCallback.onAdFailedToShowFullScreenContent
.
Pronto! Agora o app está pronto para mostrar anúncios intersticiais.
Próximas etapas
- Consulte as práticas recomendadas para intersticiais e as orientações sobre anúncios intersticiais.
- Confira um estudo de caso de anúncios intersticiais.
- Crie seu próprio bloco de anúncios intersticial na interface da AdMob, caso ainda não tenha feito isso.