Annonces interstitielles

Les annonces interstitielles s'affichent en plein écran et recouvrent l'interface d'une application jusqu'à ce qu'elles soient fermées par l'utilisateur. 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 sur l'annonce et continuer vers 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++.

Conditions préalables

  • Suivez les instructions de la section Premiers pas.
  • (Android uniquement) Bonne connaissance de l'utilisation des références JNI jobject (consultez la section Conseils JNI Android).

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. Celui-ci varie selon la plate-forme de l'appareil:

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

Elles ont été spécialement configurées 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 à remplacer cet ID 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. Demandez à recevoir les rappels.
  3. Affichez l'annonce et gérez les événements de son cycle de vie.

Configurer un InterstitialAd

Comme les annonces interstitielles s'affichent dans des objets InterstitialAd, la première étape pour les intégrer 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 un type AdParent. La vue parent est une référence JNI jobject à 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 objets Future pour surveiller l'état d'avancement des appels de méthode.

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 élément 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 sur 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 s'affiche correctement ou sans succès, et lorsqu'elle est 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 votre FullScreenContentListener, afin que l'annonce interstitielle suivante commence à se charger aussi vite que la précédente est ignorée.

Afficher l'annonce

Les interstitiels doivent s'afficher lors des pauses naturelles dans le flux d'une application. Par exemple, 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 à quel moment une annonce a affiché son contenu en plein écran, l'élément futur 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 une 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 pause dans l'action, il est facile de lui présenter une annonce interstitielle sans perturber son expérience. Réfléchissez aux étapes du workflow de votre application où vous allez diffuser 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 qu'elle suspend également l'utilisation de certaines ressources 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 du FullScreenContentListener installé, qui sera invoqué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 ou la vidéo saccadée ne seront ni lents, ni réactifs.
Prévoyez un temps de chargement adéquat.
Tout comme vous devez vous assurer que vous diffusez des annonces interstitielles au moment opportun, l'utilisateur ne doit pas avoir à attendre que celles-ci se chargent. En chargeant l'annonce à l'avance avant l'intention de la diffuser, vous vous assurez que votre application dispose d'une annonce interstitielle entièrement chargée et prête au moment d'en afficher une.
N'inondez pas les utilisateurs d'annonces.
Si l'augmentation de la fréquence des annonces interstitielles dans votre application peut sembler être un excellent moyen d'augmenter vos revenus, cela peut également avoir un impact négatif sur l'expérience utilisateur et faire baisser les taux de clics. Assurez-vous que les utilisateurs ne sont pas si souvent interrompus qu'ils ne peuvent plus profiter de votre application.
N'utilisez pas l'avenir du chargement pour afficher l'interstitiel.
Cela peut nuire à l'expérience utilisateur. Il est préférable de précharger l'annonce avant de devoir la diffuser.

Ressources supplémentaires

Exemple dans GitHub

Tutoriels vidéo Mobile Ads pour les Pros

Témoignages

Étapes suivantes