Interstitial

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 o durante la pausa tra un livello e l'altro di un gioco. Quando l'app mostra un annuncio interstitial, l'utente può scegliere se toccare l'annuncio e continua verso la destinazione oppure chiudila e torna all'app.

Questa guida spiega come integrare gli annunci interstitial in un'app Flutter.

Effettua sempre test con annunci di prova

Durante la creazione e il test delle tue app, assicurati di utilizzare annunci di prova anziché annunci di produzione attivi. In caso contrario, l'account verrà sospeso.

Il modo più semplice per caricare gli annunci di prova è utilizzare il nostro ID unità pubblicitaria di prova dedicato interstitial:

  • /6499/example/interstitial

Le unità pubblicitarie di prova sono configurate in modo da restituire annunci di prova per ogni richiesta. puoi usarle liberamente nelle tue app durante la programmazione, i test e il debug. Assicurati di sostituirli con i tuoi ID unità pubblicitaria prima di pubblicare dell'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

Utilizzando FullScreenContentCallback, puoi ascoltare il ciclo di vita ad esempio quando l'annuncio viene mostrato o ignorato. Imposta AdManagerInterstitialAd.fullScreenContentCallback prima di mostrare l'annuncio da ricevere notifiche per questi eventi. In questo esempio vengono implementati 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');
          },
        ));
  }
}

Mostrare un annuncio interstitial

Un AdManagerInterstitialAd viene visualizzato come Overlay sopra tutti i contenuti dell'app e posizionata in modo statico; perciò non può essere aggiunto nella struttura del widget Flutter. Puoi scegliere quando mostrare l'annuncio chiamando il numero show().

_interstitiaAd.show();

Dopo aver chiamato show(), non è possibile ignorare Ad visualizzato in questo modo in modo programmatico e richiede l'input dell'utente. Un AdManagerInterstitialAd può essere mostrato soltanto una volta sola. Le chiamate successive alla visualizzazione attiveranno onAdFailedToShowFullScreenContent.

Un annuncio deve essere eliminato quando non è più necessario accedervi. La best practice per sapere quando chiamare dispose() è in FullScreenContentCallback.onAdDismissedFullScreenContent e FullScreenContentCallback.onAdFailedToShowFullScreenContent callback.

È tutto. La tua app è ora pronta per mostrare gli annunci interstitial.

Passaggi successivi