Annonces interstitielles

Sélectionnez une plate-forme : Android (bêta) Nouveau Android iOS Unity Flutter

Les annonces interstitielles s'affichent en plein écran, recouvrant l'interface de l'application hôte. Elles sont généralement diffusées lors de points de transition naturels, par exemple entre deux activités ou pendant la pause entre les niveaux du jeu. Lorsqu'une application affiche une annonce interstitielle, l'utilisateur peut appuyer dessus et accéder à sa destination, ou la fermer et revenir à l'application.

Ce guide explique comment intégrer des annonces interstitielles dans une application Flutter.

Toujours tester avec des annonces tests

Lorsque vous créez et testez vos applications, assurez-vous d'utiliser des annonces tests plutôt que des annonces de production. À défaut, votre compte risque d'être suspendu.

Le moyen le plus simple de charger des annonces tests consiste à utiliser l'ID de bloc d'annonces tests dédié aux interstitiels :

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Les blocs d'annonces tests sont configurés pour renvoyer des annonces tests pour chaque requête. Vous pouvez les utiliser librement dans vos propres applications lors du codage, des tests et du débogage. Veillez simplement à les remplacer par vos propres ID de bloc d'annonces avant de publier votre application.

Charger une annonce

L'exemple suivant charge une annonce interstitielle :

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  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

Remplacez _adUnitId par votre propre ID de bloc d'annonces.

Événements d'annonces interstitielles

Grâce à FullScreenContentCallback, vous pouvez écouter les événements de cycle de vie, par exemple lorsque l'annonce est affichée ou ignorée. Définissez InterstitialAd.fullScreenContentCallback avant d'afficher l'annonce pour recevoir des notifications concernant ces événements. Cet exemple implémente chaque méthode :

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

Afficher une annonce interstitielle

Un InterstitialAd s'affiche sous forme d'Overlay au-dessus de tout le contenu de l'application et est placé de manière statique. Il ne peut donc pas être ajouté à l'arborescence des widgets Flutter. Vous pouvez choisir quand afficher l'annonce en appelant show().

_interstitialAd?.show();
main.dart

Une fois show() appelé, une Ad affichée de cette manière ne peut pas être ignorée par programmation et nécessite une intervention de l'utilisateur. Une InterstitialAd ne peut être affichée qu'une seule fois. Les appels suivants à show déclencheront onAdFailedToShowFullScreenContent.

Une annonce doit être supprimée lorsque vous n'en avez plus besoin. La bonne pratique consiste à appeler dispose() dans les rappels FullScreenContentCallback.onAdDismissedFullScreenContent et FullScreenContentCallback.onAdFailedToShowFullScreenContent.

Et voilà ! Votre application est maintenant prête à afficher des annonces interstitielles.

Étapes suivantes

Exemple complet sur GitHub

Interstitiel