Annonces interstitielles


Les annonces interstitielles s'affichent en plein écran et recouvrent l'interface d'une application jusqu'à ce que l'utilisateur les ferme. 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 diffuse une annonce interstitielle, l'utilisateur peut appuyer dessus et accéder à sa destination, ou la fermer et revenir à l'application. Étude de cas.

Ce guide explique comment intégrer des annonces interstitielles dans des applications Android et iOS à l'aide du SDK Google Mobile Ads C++.

Prérequis

  • Suivez les instructions de la section Premiers pas.
  • (Android uniquement) Vous devez savoir utiliser les références jobject JNI (consultez les conseils JNI Android).

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 notre ID de bloc d'annonces de test dédié aux interstitiels, qui varie en fonction de la plate-forme de l'appareil :

  • Android: ca-app-pub-3940256099942544/1033173712
  • iOS: ca-app-pub-3940256099942544/4411468910

Ils ont été spécialement 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 votre propre ID de bloc d'annonces avant de publier votre application.

Pour en savoir plus sur le fonctionnement des annonces tests du SDK Mobile Ads, consultez Annonces tests.

Implémentation

Voici les principales étapes à suivre pour intégrer des annonces interstitielles :

  1. Charger une annonce
  2. Demander à recevoir les rappels
  3. Afficher l'annonce et gérer les événements de son cycle de vie

Configurer un InterstitialAd

Les annonces interstitielles s'affichent dans des objets InterstitialAd. La première étape pour intégrer des annonces interstitielles dans votre application consiste donc à créer et à initialiser un objet InterstitialAd.

  1. Ajoutez l'en-tête suivant au code C++ de votre application : 

     #include "firebase/gma/interstial_ad.h"

  2. Déclarez et instanciez un objet InterstitialAd : 

     firebase::gma::InterstitialAd* interstitial_ad;
 interstitial_ad = new firebase::gma::InterstitialAd();

  3. Initialisez l'instance InterstitialAd à l'aide de votre vue parent, castée en type AdParent. La vue parent est une référence jobject JNI à une Activity Android ou un pointeur vers un UIView iOS.

    // my_ad_parent is a jobject reference to an Android Activity or
// a pointer to an iOS UIView.
firebase::gma::AdParent ad_parent =
  static_cast<firebase::gma::AdParent>(my_ad_parent);
firebase::Future<void> result = interstitial_ad->Initialize(ad_parent);

  4. Au lieu de conserver l'avenir en tant que variable, vous pouvez vérifier régulièrement l'état de l'opération d'initialisation en appelant InitializeLastResult() sur l'objet InterstitialAd. Cela peut être utile pour suivre le processus d'initialisation dans votre boucle de jeu globale.

    // Monitor the status of the future in your game loop:
firebase::Future<void> result = interstitial_ad->InitializeLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  // Initialization completed.
  if(future.error() == firebase::gma::kAdErrorCodeNone) {
    // Initialization successful.
  } else {
    // An error has occurred.
  }
} else {
  // Initialization on-going.
}

Pour en savoir plus sur l'utilisation de firebase::Future, consultez Utiliser des futures pour surveiller l'état d'achèvement des appels de méthode calls.

Charger une annonce

Le chargement d'une annonce s'effectue à l'aide de la méthode LoadAd() sur l'objet InterstitialAd. La méthode de chargement nécessite que vous ayez initialisé l'objet InterstitialAd, que vous disposiez de votre ID de bloc d'annonces et d'un objet AdRequest. Un firebase::Future est renvoyé. Vous pouvez l'utiliser pour surveiller l'état et le résultat de l'opération de chargement.

Le code suivant montre comment charger une annonce une fois que InterstitialAd a été initialisé :

firebase::