Annunci interstitial

Seleziona la piattaforma: Android (beta) Nuovo Android iOS Unity Flutter

Gli annunci interstitial sono annunci a schermo intero che coprono l'interfaccia dell'app host. Vengono di solito visualizzati 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ò toccare l'annuncio e continuare fino alla sua 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 live. In caso contrario, il tuo account potrebbe essere sospeso.

Il modo più semplice per caricare gli annunci di prova è utilizzare l'ID dell'unità pubblicitaria di prova dedicata per gli annunci interstitial:

  • /21775744923/example/interstitial

Le unità pubblicitarie di prova sono configurate per restituire annunci di prova per ogni richiesta e puoi utilizzarle liberamente nelle tue app durante la codifica, i test e il debug. Assicurati di sostituirle con gli ID delle tue unità pubblicitarie prima di pubblicare l'app.

Carica un annuncio

L'esempio seguente carica un annuncio interstitial:

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdManagerAdRequest(),
  adLoadCallback: InterstitialAdLoadCallback(
    onAdLoaded: (InterstitialAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _interstitialAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);
interstitial_ad_snippets.dart

Sostituisci _adUnitId con l'ID della tua unità pubblicitaria.

Eventi degli annunci interstitial

Utilizzando FullScreenContentCallback, puoi ascoltare gli eventi del ciclo di vita, ad esempio quando l'annuncio viene mostrato o ignorato. Imposta AdManagerInterstitialAd.fullScreenContentCallback prima di mostrare l'annuncio per ricevere notifiche per questi eventi. Questo esempio implementa ogni metodo:

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);
interstitial_ad_snippets.dart

Mostra un annuncio interstitial

Un AdManagerInterstitialAd viene visualizzato come un Overlay sopra tutti i contenuti dell'app ed è posizionato staticamente; pertanto, non può essere aggiunto a l'albero dei widget Flutter. Puoi scegliere quando mostrare l'annuncio chiamando show().

_interstitialAd?.show();
main.dart

Una volta chiamato show(), un Ad visualizzato in questo modo non può essere ignorato a livello di programmazione e richiede l'input dell'utente. Un AdManagerInterstitialAd può essere mostrato una sola volta. Le chiamate successive a show attiveranno onAdFailedToShowFullScreenContent.

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

Questo è tutto! La tua app è ora pronta per mostrare annunci interstitial.

Passaggi successivi