Annonces interstitielles


Les annonces interstitielles s'affichent en plein écran et recouvrent l'interface d'une application jusqu'à fermé par l'utilisateur. Elles s'affichent généralement à des points de transition naturels le flux d'une application, par exemple entre des activités ou pendant une pause entre différents niveaux dans un jeu. Lorsqu'une application diffuse une annonce interstitielle, l'utilisateur a le choix soit appuyer sur l'annonce et accéder à sa destination, soit 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 C++ Google Mobile Ads.

Prérequis

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é interstitiels, qui varient 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 demande. vous êtes libre de l’utiliser dans vos propres applications lors du codage, des tests et du débogage. Veillez simplement à le remplacer par l'ID de votre propre bloc d'annonces avant de publier votre l'application.

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

Implémentation

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

  1. Chargez une annonce.
  2. Demandez à recevoir des rappels.
  3. afficher l'annonce et gérer les événements de son cycle de vie ;

Configurer un InterstitialAd

Les annonces interstitielles sont affichées dans des objets InterstitialAd. La première étape pour intégrer des annonces interstitielles dans votre application. 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 votre vue parente sur un Type AdParent. La vue parent est une référence jobject JNI à un objet Android Activity 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 le futur comme variable, vous pouvez périodiquement vérifiez 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 globale de jeu.

    // 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 de la méthode les appels.

Charger une annonce

Pour charger une annonce, vous devez utiliser la méthode LoadAd() au niveau de la InterstitialAd. La méthode de chargement nécessite que vous ayez initialisé InterstitialAd, et que vous disposez de votre ID de bloc d'annonces et d'un élément AdRequest . Un firebase::Future est renvoyé. Vous pouvez l'utiliser pour surveiller l'état. et le résultat du chargement.

Le code suivant montre comment charger une annonce une fois que l'InterstitialAd a été correctement 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 pour recevoir des rappels

Vous devez étendre la classe FullScreenContentListener afin de recevoir des notifications en cas de présentation des annonces interstitielles et d'événements de cycle de vie. Votre La sous-classe FullScreenContentListener peut être enregistrée via la InterstitialAd::SetFullScreenContentListener(). Il recevra des rappels lorsque la présentation de l'annonce a réussi ou échoué, ainsi que lorsque il est ignoré.

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'un interstitiel l'annonce ne peut pas être diffusée de nouveau. Une bonne pratique consiste à charger une autre une annonce interstitielle dans la méthode OnAdDismissedFullScreenContent() de votre FullScreenContentListener pour que l'interstitiel suivant commence à se charger comme dès que la précédente est ignorée.

Afficher l'annonce

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

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

Bonnes pratiques

Déterminez si les annonces interstitielles sont adaptées à votre application.
Les annonces interstitielles sont plus efficaces dans les applications avec des points de transition naturels. La conclusion d'une tâche dans une application, comme partager une image ou terminer un jeu crée un tel point. Comme l'utilisateur s'attend à une pause dans le l'utilisateur peut facilement diffuser une annonce interstitielle expérience. Veillez à déterminer à quels moments du flux de travail de votre application vous allez les annonces display interstitielles et la façon dont l'utilisateur est susceptible d'y répondre.
N'oubliez pas de mettre en veille l'action lorsque vous diffusez une annonce interstitielle.
Il existe plusieurs types d'annonces interstitielles: textuelles, illustrées, des vidéos, etc. Il est important de vous assurer que lorsque votre application affiche un l'utilisation de certaines ressources pour permettre à l'annonce pour en tirer parti. Par exemple, lorsque vous effectuez l'appel pour afficher une interstitielle, veillez à mettre en pause toute sortie audio produite par votre application. Vous pouvez reprendre la lecture des sons avec la méthode OnAdDismissedFullScreenContent de votre FullScreenContentListener installée, qui sera appelée lorsque l'utilisateur a fini d'interagir avec l'annonce. Vous pouvez aussi envisager d'interrompre temporairement Toute tâche de calcul intense (une boucle de jeu, par exemple) pendant la diffusion de l'annonce affiché. Ainsi, l'utilisateur ne subira pas de ralentissements les graphismes qui 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 le bon moment, il est également important de s'assurer que l'utilisateur n'a pas à attendre pour qu'ils puissent être chargés. Pour vous assurer que le chargement de l'annonce avant sa diffusion est prévu, que votre application dispose d'une annonce interstitielle entièrement chargée, prête au moment pour en afficher un.
N'inondez pas les utilisateurs d'annonces.
Même si augmenter la fréquence des annonces interstitielles dans votre application peut sembler est un excellent moyen d'augmenter vos revenus, mais il peut aussi nuire à l'expérience utilisateur et de réduire les taux de clics. Assurez-vous que les utilisateurs interrompu et il ne pourra plus profiter de votre application.
Pour afficher l'interstitiel, n'utilisez pas le terme "achèvement du chargement" à l'avenir.
Cela peut nuire à l'expérience utilisateur. Préchargez plutôt l'annonce avant vous devez la montrer.

Ressources supplémentaires

Exemple dans GitHub

Tutoriels vidéo "The Mobile Ads Garage"

Témoignages

Étapes suivantes