Bannières

Les bannières occupent un emplacement dans une mise en page d'application, en haut ou en bas de l'écran de l'appareil. Ils restent à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement après un certain temps. Si vous faites vos premiers pas dans la publicité mobile, c'est un bon point de départ. Étude de cas

Prérequis

Toujours tester les annonces

Lorsque vous créez et testez vos applications, veillez à utiliser des annonces de test plutôt que des annonces de production. À défaut, votre compte risque d'être suspendu.

Pour charger les annonces tests, le moyen le plus simple consiste à utiliser notre ID de bloc d'annonces test, qui varie en fonction de la plate-forme de l'appareil:

  • Android : ca-app-pub-3940256099942544/6300978111
  • iOS : ca-app-pub-3940256099942544/2934735716

Ces ID de bloc d'annonces ont été spécialement configurés pour renvoyer des annonces tests à chaque requête. Vous êtes libre de les utiliser dans vos propres applications lors du codage, des tests et du débogage. Veillez à 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 Tester les annonces.

Implémentation

Configurer un AdView

Les bannières sont affichées dans des objets AdView. La première étape pour intégrer des bannières consiste donc à créer et à positionner un élément AdView.

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

     #include "firebase/gma/ad_view.h"

  2. Déclarez et instanciez un objet AdView:

      firebase::gma::AdView* ad_view;
  ad_view = new firebase::gma::AdView();

  3. Créez un AdSize et initialisez le visionnage de l'annonce à l'aide de la vue parent AdParent. La vue parent est une référence JNI jobject à un Activity Android ou un pointeur vers un UIView iOS casté sur un type AdParent:

     // 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(my_ad_parent);
 firebase::Future result =
   ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);

  4. Au lieu de conserver le futur 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 AdView. 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 = ad_view->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.
  }

  5. Pour en savoir plus sur l'utilisation de firebase::Future, utilisez Futures pour surveiller l'état d'avancement des appels de méthode.

Définir la position de l'annonce

Vous pouvez définir la position de AdView à tout moment après son initialisation:

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

Charger une annonce

Vous pouvez charger une annonce une fois que AdView a été initialisé:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);

Les objets AdRequest représentent une seule demande d'annonce et contiennent des propriétés pour les informations telles que le ciblage.

Afficher l'annonce

Enfin, affichez l'annonce à l'écran en appelant Show(). Cette méthode peut être appelée à tout moment après l'initialisation de l'annonce:

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

Événements d'annonce

Le SDK C++ Google Mobile Ads fournit une classe AdListener que vous pouvez étendre et transmettre à AdView::SetListener() afin d'être averti des modifications de l'état de la vue de l'annonce.

L'extension des méthodes dans AdListener est facultative. Vous ne devez donc implémenter que les méthodes souhaitées. Vous trouverez ci-dessous un exemple d'implémentation d'une classe qui étend toutes les classes de méthodes AdListener:

class ExampleAdListener
    : public firebase::gma::AdListener {
 public:
  ExampleAdListener() {}
  void OnAdClicked() override {
    // This method is invoked when the user clicks the ad.
  }

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

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

  void OnAdOpened() override {
    // This method is invoked when an ad opens an overlay that covers the screen.
  }
};

ExampleAdListener* ad_listener = new ExampleAdListener();
ad_view->SetAdListener(ad_listener);

Le tableau ci-dessous liste les tailles de bannière standards.

Taille en points (LxH) Description Garantie de disponibilité constante firebase::gma::AdSize
320 x 50 Bannière Téléphones et tablettes kBanner
320 x 100 Grande bannière Téléphones et tablettes kLargeBanner
300 x 250 Rectangle moyen IAB Téléphones et tablettes kMediumRectangle
468 x 60 Bannière standard de l'IAB Tablettes kFullBanner
728 x 90 Classement IAB Tablettes kLeaderboard
Largeur fournie x Hauteur adaptative Bannière adaptative Téléphones et tablettes N/A

Tailles d'annonces personnalisées

Pour définir une taille de bannière personnalisée, définissez les dimensions souhaitées à l'aide du constructeur firebase::gma::AdSize avec les paramètres de largeur et de hauteur, comme indiqué ci-dessous:

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

Ressources supplémentaires

Exemple dans GitHub

Témoignages