Gli annunci interstitial sono annunci a schermo intero che coprono l'interfaccia dell'app host. In genere vengono visualizzati in punti di transizione naturali nel flusso di un'app, ad esempio tra un'attività e l'altra o durante la pausa tra i livelli di un gioco. Quando un'app mostra un annuncio interstitial, l'utente può scegliere se toccarlo e proseguire verso la destinazione oppure chiuderlo e tornare all'app.
Questa guida spiega come integrare gli annunci interstitial in un'app Flutter.
Esegui sempre test con annunci di prova
Quando crei e testi le tue app, assicurati di utilizzare annunci di prova anziché annunci di produzione pubblicati. In caso contrario, l'account potrebbe essere sospeso.
Il modo più semplice per caricare gli annunci di prova è utilizzare il nostro ID unità pubblicitaria di prova dedicata per gli annunci interstitial:
/6499/example/interstitial
Le unità pubblicitarie di test sono configurate in modo da restituire annunci di prova per ogni richiesta e puoi utilizzarle liberamente nelle tue app durante la programmazione, i test e il debug. Assicurati di sostituirli con i tuoi ID unità pubblicitaria prima di pubblicare l'app.
Carica un annuncio
Nell'esempio seguente viene caricato un annuncio interstitial:
class InterstitialExampleState extends State<InterstitialExample> { AdManagerInterstitialAd? _interstitialAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/6499/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'); }, )); } }
Eventi annuncio interstitial
Tramite FullScreenContentCallback
, puoi esaminare gli eventi del ciclo di vita, ad esempio i momenti in cui l'annuncio viene mostrato o ignorato. Imposta AdManagerInterstitialAd.fullScreenContentCallback
prima di mostrare l'annuncio per ricevere notifiche per questi eventi. Questo esempio implementa ciascun metodo:
class InterstitialExampleState extends State<InterstitialExample> { AdManagerInterstitialAd? _interstitialAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/6499/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'); }, )); } }
Visualizzare un annuncio interstitial
Un elemento AdManagerInterstitialAd
viene visualizzato come Overlay
sopra tutti i contenuti dell'app e viene posizionato in modo statico; pertanto, non può essere aggiunto
all'albero del widget Flutter. Puoi scegliere quando mostrare l'annuncio chiamando il numero show()
.
_interstitiaAd.show();
Una volta chiamata show()
, una Ad
visualizzata in questo modo non può essere ignorata
in modo programmatico e richiede l'input dell'utente. AdManagerInterstitialAd
può essere mostrato
una sola volta. Le chiamate successive da mostrare attiveranno onAdFailedToShowFullScreenContent
.
Un annuncio deve essere eliminato quando non è più necessario accedervi. La best practice
per quando chiamare dispose()
si trova nei callback
FullScreenContentCallback.onAdDismissedFullScreenContent
e
FullScreenContentCallback.onAdFailedToShowFullScreenContent
.
È tutto. La tua app è ora pronta per mostrare annunci interstitial.
Passaggi successivi
- Consulta le best practice sugli annunci interstitial e le indicazioni sugli annunci interstitial.
- Consulta il case study sugli annunci interstitial.