Gli interstitial sono annunci a schermo intero che coprono l'interfaccia dell'app host. In genere, vengono mostrati in punti di transizione naturali nel flusso di un'app, ad esempio tra un'attività e l'altra durante la pausa tra i livelli di un gioco. Quando un'app mostra un annuncio interstitial, l'utente può scegliere se toccarlo e passare alla pagina di destinazione oppure chiuderlo e tornare all'app.
Questa guida spiega come integrare gli annunci interstitial in un'app Flutter.
Effettua 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 verrà sospeso.
Il modo più semplice per caricare annunci di prova è utilizzare il nostro ID unità pubblicitaria di prova dedicato per gli interstitial:
Android
ca-app-pub-3940256099942544/1033173712
iOS
ca-app-pub-3940256099942544/4411468910
Le unità pubblicitarie di prova sono configurate in modo da restituire annunci di prova per ogni richiesta e puoi utilizzarle nelle tue app durante la programmazione, i test e il debug. Assicurati solo 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> { 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'); }, )); } }
Eventi annuncio interstitial
Utilizzando FullScreenContentCallback
, puoi ascoltare gli eventi del ciclo di vita, ad esempio quando l'annuncio viene mostrato o ignorato. Imposta InterstitialAd.fullScreenContentCallback
prima di mostrare l'annuncio per ricevere notifiche per questi eventi. In questo esempio vengono implementati ciascun metodo:
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'); }, )); } }
Mostrare un annuncio interstitial
Un InterstitialAd
viene visualizzato come un Overlay
sopra tutti i contenuti dell'app e viene posizionato in modo statico; pertanto, non può essere aggiunto
alla struttura del widget Flutter. Puoi scegliere quando mostrare l'annuncio chiamando il numero show()
.
_interstitiaAd.show();
Dopo aver chiamato show()
, un elemento Ad
visualizzato in questo modo non può essere ignorato in modo programmatico e richiede l'input dell'utente. Un InterstitialAd
può essere mostrato
solo una volta. Le chiamate successive alla visualizzazione attiveranno onAdFailedToShowFullScreenContent
.
Un annuncio deve essere eliminato quando non è più necessario accedervi. La best practice
su quando chiamare dispose()
è nei
callback FullScreenContentCallback.onAdDismissedFullScreenContent
e
FullScreenContentCallback.onAdFailedToShowFullScreenContent
.
È tutto. L'app è ora pronta per mostrare gli annunci interstitial.
Passaggi successivi
- Consulta le best practice interstitial e le indicazioni sugli annunci interstitial.
- Consulta un case study sugli annunci interstitial.
- Se non l'hai già fatto, crea la tua unità pubblicitaria interstitial nell'interfaccia utente di AdMob.