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 mostrar um anúncio intersticial, o usuário terá a opção de tocar nele e continuar até o destino ou fechar e retornar ao app.
Este guia explica como integrar anúncios intersticiais em um app Flutter.
Sempre teste 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:
/21775744923/example/interstitial
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. 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> { AdManagerInterstitialAd? _interstitialAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/interstitial'; /// Loads an interstitial ad. void loadAd() { AdManagerInterstitialAd.load( adUnitId: adUnitId, request: const AdManagerAdRequest(), adLoadCallback: AdManagerInterstitialAdLoadCallback( // 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('AdManagerInterstitialAd failed to load: $error'); }, )); } }
Eventos de anúncio intersticial
Com o uso de FullScreenContentCallback
, é possível detectar eventos de ciclo de vida,
como quando o anúncio é mostrado ou dispensado. Definir
AdManagerInterstitialAd.fullScreenContentCallback
antes de mostrar o anúncio para receber
notificações desses eventos. Este exemplo implementa cada método:
class InterstitialExampleState extends State<InterstitialExample> { AdManagerInterstitialAd? _interstitialAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/interstitial'; /// Loads an interstitial ad. void loadAd() { AdManagerInterstitialAd.load( adUnitId: adUnitId, request: const AdManagerAdRequest(), adLoadCallback: AdManagerInterstitialAdLoadCallback( // 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('AdManagerInterstitialAd failed to load: $error'); }, )); } }
Exibir um anúncio intersticial
Um AdManagerInterstitialAd
é exibido como um Overlay
.
sobre todo o conteúdo do app e é posicionada estaticamente; Assim, ele não pode ser adicionado
a árvore de widgets do Flutter. É possível escolher quando mostrar o anúncio chamando show()
.
_interstitiaAd.show();
Depois que show()
é chamado, um Ad
exibido dessa forma não pode ser dispensado
de forma programática e exige entrada do usuário. Um AdManagerInterstitialAd
só pode ser mostrado
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 chamar dispose()
está nos
callbacks FullScreenContentCallback.onAdDismissedFullScreenContent
e
FullScreenContentCallback.onAdFailedToShowFullScreenContent
.
Pronto! Agora o app está pronto para mostrar anúncios intersticiais.