Les bannières occupent un emplacement dans la mise en page d'une application, en haut ou en bas de l'écran de l'appareil. Elles restent à l'écran pendant que les utilisateurs interagissent avec l'application, et peuvent s'actualiser automatiquement après un certain délai. Si vous débutez dans la publicité mobile, ils constituent un excellent point de départ. Étude de cas :
Prérequis
- Suivez la procédure Commencer.
- (Android uniquement) Vous devez savoir utiliser les références JNI
jobject
(consultez 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 test dédié (qui varient en fonction de la plate-forme) :
- 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 afficher des annonces tests pour chaque Vous êtes libre de l'utiliser dans vos propres applications pour coder, tester le débogage. Veillez simplement à le remplacer par votre propre ID de bloc d'annonces avant 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
intégrer des bannières consiste à créer et à positionner un AdView
.
Ajoutez l'en-tête suivant au code C++ de votre application:
#include "firebase/gma/ad_view.h"
Déclarez et instanciez un objet
AdView
:firebase::gma::AdView* ad_view; ad_view = new firebase::gma::AdView();
Créer un
AdSize
et initialiser le visionnage de l'annonce à l'aide du parentAdParent
vue. La vue parent est une référencejobject
JNI à unActivity
Android ou un pointeur vers unUIView
iOS casté vers un typeAdParent
:// 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
result = ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner); Au lieu de conserver l'avenir comme variable, vous pouvez régulièrement l'état de l'opération d'initialisation en appelant
InitializeLastResult()
sur l'objetAdView
. 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 = 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. }
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.
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 demande d'annonce unique et contiennent les propriétés de
des informations telles que le ciblage.
Afficher l'annonce
Enfin, affichez l'annonce à l'écran en appelant Show()
. Cette méthode peut être
invoquée à tout moment après l'initialisation de l'annonce:
firebase::Future<void> result = ad_view->Show();
Événements d'annonces
Le SDK C++ Google Mobile Ads fournit une classe AdListener
que vous pouvez étendre
et transmettez à AdView::SetListener()
pour être informé des modifications apportées à l'annonce.
l'état de la vue.
L'extension des méthodes dans AdListener
est facultative. Il vous suffit donc d'implémenter la
et méthodes de votre choix. Vous trouverez ci-dessous un exemple d'implémentation d'une classe qui étend tous
de la classe 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);
Tailles des bannières
Le tableau ci-dessous répertorie les tailles de bannière standard.
Taille en points (LxH) | Description | 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 | IAB Rectangle moyen | Téléphones et tablettes | kMediumRectangle |
468 x 60 | Bannière IAB en taille réelle | Tablettes | kFullBanner |
728 x 90 | Leaderboard 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 des
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
- Affichez le code source de notre exemple d'application de démarrage rapide dans GitHub.