Annonces interstitielles

Les annonces interstitielles s'affichent en plein écran et recouvrent l'interface d'une application jusqu'à ce que l'utilisateur la ferme. Elles sont généralement affichées à des points de transition naturels dans le flux d'une application, par exemple entre des 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. Étude de cas

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

Prérequis

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 les annonces tests consiste à utiliser notre ID de bloc d'annonces test dédié aux interstitiels. Celui-ci varie selon la plate-forme:

  • 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 dans vos propres applications lors du codage, des tests et du débogage. Veillez simplement à le 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. Chargez une annonce.
  2. Demandez à recevoir les rappels.
  3. Affichez l'annonce et gérez les événements de cycle de vie associés.

Configurer une InterstitialAd

Les annonces interstitielles étant affichées dans des objets InterstitialAd, la première étape pour intégrer des annonces interstitielles dans votre application consiste à 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 la conversion de la vue parent en type AdParent. La vue parent est une référence JNI jobject à un 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 Surveiller l'état d'avancement des appels de méthode à l'aide des objets Future.

Charger une annonce

Pour charger une annonce, vous devez utiliser la méthode LoadAd() sur l'objet InterstitialAd. Pour utiliser la méthode de chargement, vous devez avoir initialisé l'objet InterstitialAd et disposer de l'ID de votre 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 bien été initialisé:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);

S'inscrire aux rappels

Vous devez étendre la classe FullScreenContentListener afin de recevoir des notifications concernant la présentation des annonces interstitielles et les événements de cycle de vie. Votre sous-classe FullScreenContentListener personnalisée peut être enregistrée via la méthode InterstitialAd::SetFullScreenContentListener(). Elle recevra des rappels lorsque l'annonce se présentera avec succès ou sans succès, ainsi que lorsqu'elle sera ignorée.

Le code suivant montre comment étendre la classe et l'attribuer à l'annonce:

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* full_screen_content_listener =
    new ExampleFullScreenContentListener();
  interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);

InterstitialAd est un objet à usage unique. Cela signifie qu'une fois qu'une annonce interstitielle a été diffusée, elle ne peut plus être diffusée. Une bonne pratique consiste à charger une autre annonce interstitielle dans la méthode OnAdDismissedFullScreenContent() de l'élément FullScreenContentListener, afin que l'annonce interstitielle suivante commence à se charger dès que la précédente est ignorée.

Afficher l'annonce

Les interstitiels doivent être affichés lors de pauses naturelles dans le flux d'une application. Entre deux niveaux de jeu, ou après que l'utilisateur a terminé une tâche, Bien que FullScreenContentListener puisse être utilisé pour déterminer quand une annonce a affiché son contenu en plein écran, l'avenir renvoyé par Show() indiquera également que l'annonce a bien été diffusée.

  firebase::Future<void> result = interstitial_ad->Show();

Bonnes pratiques

Déterminez si les annonces interstitielles sont le bon type d'annonce pour votre application.
Les annonces interstitielles sont plus efficaces dans les applications qui présentent des points de transition naturels. La conclusion d'une tâche dans l'application, comme le partage d'une image ou la fin d'un niveau de jeu, crée un tel point. Étant donné que l'utilisateur s'attend à une interruption de l'action, il est facile de lui présenter une annonce interstitielle sans perturber son expérience. Réfléchissez à à quels stades du workflow de votre application vous diffuserez des annonces interstitielles, et à la manière dont l'utilisateur est susceptible de réagir.
N'oubliez pas de mettre en veille l'action lors de l'affichage d'une annonce interstitielle.
Il existe plusieurs types d'annonces interstitielles: textuelles, illustrées, vidéo, etc. Lorsque votre application affiche une annonce interstitielle, vous devez vous assurer que l'utilisation de certaines ressources est également suspendue pour que l'annonce puisse en profiter. Par exemple, lorsque vous effectuez l'appel pour afficher une annonce interstitielle, veillez à mettre en pause toute sortie audio produite par votre application. Vous pouvez reprendre la lecture des sons dans la méthode OnAdDismissedFullScreenContent de l'élément FullScreenContentListener installé, qui sera appelée lorsque l'utilisateur aura fini d'interagir avec l'annonce. En outre, envisagez d'interrompre temporairement les tâches de calcul intenses (telles qu'une boucle de jeu) pendant l'affichage de l'annonce. Ainsi, les graphismes ne sont pas lents, ne répondent pas ou les vidéos sont saccadées.
Prévoyez un temps de chargement adéquat.
Tout comme il est important de vous assurer que vous diffusez des annonces interstitielles au moment opportun, il est également important que l'utilisateur n'ait pas à attendre que leur chargement soit terminé. En chargeant l'annonce à l'avance, vous avez l'assurance que votre application dispose d'une annonce interstitielle entièrement chargée le moment venu.
N'inondez pas l'utilisateur d'annonces.
L'augmentation de la fréquence des annonces interstitielles dans votre application peut sembler être un excellent moyen d'augmenter vos revenus, mais cela peut également avoir un impact négatif sur l'expérience utilisateur et réduire les taux de clics. Assurez-vous que les utilisateurs ne soient pas interrompus trop souvent au point qu'ils ne puissent plus profiter de votre application.
N'utilisez pas l'état de chargement terminé pour afficher l'interstitiel.
Cela peut nuire à l'expérience utilisateur. Préchargez plutôt l'annonce avant de devoir la diffuser.

Ressources supplémentaires

Exemple dans GitHub

Tutoriels vidéo "The Mobile Ads Garage"

Témoignages

Étapes suivantes