Les annonces interstitielles s'affichent en plein écran et recouvrent l'interface de l'application hôte. Elles sont généralement diffusées à des points de transition naturels dans une application, par exemple entre deux activités ou pendant la pause entre les niveaux d'un jeu. Lorsqu'une application affiche une annonce interstitielle, l'utilisateur peut appuyer dessus et continuer vers 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, veillez à 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 notre ID de bloc d'annonces test dédié pour les 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 demande. Vous pouvez les utiliser 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:
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');
},
));
}
}
Événements d'annonces interstitielles
Grâce à FullScreenContentCallback, vous pouvez écouter les événements de cycle de vie, tels que le moment où l'annonce est diffusée ou ignorée. Définissez InterstitialAd.fullScreenContentCallback avant de diffuser l'annonce pour recevoir des notifications pour ces événements. L'exemple suivant implémente chaque méthode:
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');
},
));
}
}
Afficher une annonce interstitielle
Un InterstitialAd s'affiche sous la forme d'un 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 de widgets Flutter. Pour choisir à quel moment diffuser l'annonce, appelez show().
_interstitiaAd.show();
Une fois show() appelé, un Ad affiché de cette manière ne peut pas être ignoré par programmation et nécessite une entrée utilisateur. Un élément InterstitialAd ne peut être affiché qu'une seule fois. Les appels suivants à afficher déclencheront onAdFailedToShowFullScreenContent.
Une annonce doit être supprimée lorsque l'accès n'est plus nécessaire. Nous vous recommandons d'appeler dispose() dans les rappels FullScreenContentCallback.onAdDismissedFullScreenContent et FullScreenContentCallback.onAdFailedToShowFullScreenContent.
Et voilà ! Votre application est maintenant prête à diffuser des annonces interstitielles.
Étapes suivantes
- Consultez les bonnes pratiques relatives aux interstitiels et les conseils concernant les annonces interstitielles.
- Pour en savoir plus, consultez cette étude de cas sur les annonces interstitielles.
- Si vous ne l'avez pas déjà fait, créez votre propre bloc d'annonces interstitielles dans l'interface utilisateur d'AdMob.