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 temps. Si vous découvrez la publicité mobile, sachez qu'elle constitue un excellent point de départ. Étude de cas.
Ce guide vous explique comment intégrer des bannièresAdMob dans une application iOS. En plus des extraits de code et des instructions, il inclut des informations sur la façon de dimensionner correctement les bannières et des liens vers des ressources supplémentaires.
Conditions préalables
- Suivez le guide de démarrage.
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é aux bannières iOS :
ca-app-pub-3940256099942544/2934735716
Elle est spécialement configurée pour renvoyer des annonces tests pour chaque demande. Vous pouvez l'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.
Créer un GADBannerView
Les bannières s'affichent dans des objets GADBannerView
. La première étape pour intégrer des bannières consiste donc à inclure un GADBannerView
dans votre hiérarchie des vues. Cette opération est généralement effectuée à l'aide d'Interface Builder ou de manière programmatique.
Interface Builder
Un élément GADBannerView
peut être ajouté à un storyboard ou à un fichier Xib comme n'importe quelle vue standard. Lorsque vous utilisez cette méthode, veillez à ajouter des contraintes de largeur et de hauteur correspondant à la taille de l'annonce que vous souhaitez afficher. Par exemple, pour afficher une bannière (320 x 50), utilisez une contrainte de largeur de 320 points et une contrainte de hauteur de 50 points.
Par programmation
Un GADBannerView
peut également être instancié directement.
Voici un exemple de création d'un élément GADBannerView
aligné au centre inférieur de la zone de sécurité de l'écran, avec une bannière de 320 x 50 pixels:
Swift
import GoogleMobileAds import UIKit class ViewController: UIViewController { var bannerView: GADBannerView! override func viewDidLoad() { super.viewDidLoad() // In this case, we instantiate the banner with desired ad size. bannerView = GADBannerView(adSize: GADAdSizeBanner) addBannerViewToView(bannerView) } func addBannerViewToView(_ bannerView: GADBannerView) { bannerView.translatesAutoresizingMaskIntoConstraints = false view.addSubview(bannerView) view.addConstraints( [NSLayoutConstraint(item: bannerView, attribute: .bottom, relatedBy: .equal, toItem: view.safeAreaLayoutGuide, attribute: .bottom, multiplier: 1, constant: 0), NSLayoutConstraint(item: bannerView, attribute: .centerX, relatedBy: .equal, toItem: view, attribute: .centerX, multiplier: 1, constant: 0) ]) } }
Objective-C
@import GoogleMobileAds; @interface ViewController () @property(nonatomic, strong) GADBannerView *bannerView; @end @implementation ViewController - (void)viewDidLoad { [super viewDidLoad]; // In this case, we instantiate the banner with desired ad size. self.bannerView = [[GADBannerView alloc] initWithAdSize:GADAdSizeBanner]; [self addBannerViewToView:self.bannerView]; } - (void)addBannerViewToView:(UIView *)bannerView { bannerView.translatesAutoresizingMaskIntoConstraints = NO; [self.view addSubview:bannerView]; [self.view addConstraints:@[ [NSLayoutConstraint constraintWithItem:bannerView attribute:NSLayoutAttributeBottom relatedBy:NSLayoutRelationEqual toItem:self.view.safeAreaLayoutGuide attribute:NSLayoutAttributeBottom multiplier:1 constant:0], [NSLayoutConstraint constraintWithItem:bannerView attribute:NSLayoutAttributeCenterX relatedBy:NSLayoutRelationEqual toItem:self.view attribute:NSLayoutAttributeCenterX multiplier:1 constant:0] ]]; } @end
Notez que dans ce cas, nous ne donnons pas de contraintes de largeur ni de hauteur, car la taille d'annonce fournie donnera à la bannière une taille de contenu intrinsèque pour dimensionner l'affichage.
Si vous ne souhaitez pas utiliser une taille standard définie par une constante, vous pouvez définir une taille personnalisée à l'aide de GADAdSizeFromCGSize
.
Pour en savoir plus, consultez la section Taille de la bannière.
Configurer GADBannerView les propriétés
Pour charger et afficher des annonces, GADBannerView
exige que quelques propriétés soient définies.
rootViewController
: ce contrôleur de vue permet de présenter une superposition lorsque l'utilisateur clique sur l'annonce. Il doit normalement être défini sur le contrôleur de vue qui contient l'élémentGADBannerView
.adUnitID
: ID du bloc d'annonces à partir duquel leGADBannerView
doit charger les annonces.
Voici un exemple de code montrant comment définir les deux propriétés requises dans la méthode viewDidLoad
d'un UIViewController:
Swift
override func viewDidLoad() { super.viewDidLoad() ... bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716" bannerView.rootViewController = self }
Objective-C
- (void)viewDidLoad { [super viewDidLoad]; ... self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2934735716"; self.bannerView.rootViewController = self; }
Charger une annonce
Une fois l'GADBannerView
en place et ses propriétés configurées, vous pouvez charger une annonce. Pour ce faire, appelez loadRequest:
sur un objet GADRequest
:
Swift
override func viewDidLoad() { super.viewDidLoad() ... bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716" bannerView.rootViewController = self bannerView.load(GADRequest()) }
Objective-C
- (void)viewDidLoad { [super viewDidLoad]; ... self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2934735716"; self.bannerView.rootViewController = self; [self.bannerView loadRequest:[GADRequest request]]; }
GADRequest les objets représentent une demande d'annonce unique et contiennent des propriétés telles que les informations de ciblage.
Si votre annonce ne se charge pas, vous n'avez pas besoin d'en demander explicitement une autre tant que vous avez configuré l'actualisation de votre bloc d'annonces. Le SDK Google Mobile Ads respecte la fréquence d'actualisation que vous avez spécifiée dans l'AdMob UI. Si vous n'avez pas activé l'actualisation, vous devez émettre une nouvelle requête.
Événements d'annonce
Grâce à GADBannerViewDelegate
, vous pouvez écouter les événements du cycle de vie (par exemple, lorsqu'une annonce est fermée ou lorsque l'utilisateur quitte l'application).
S'inscrire aux événements de bannière
Pour vous inscrire aux événements de bannière, définissez la propriété delegate
de GADBannerView
sur un objet qui implémente le protocole GADBannerViewDelegate
. En règle générale, la classe qui implémente les bannières agit également en tant que classe déléguée, auquel cas la propriété delegate
peut être définie sur self
.
Swift
import GoogleMobileAds import UIKit class ViewController: UIViewController, GADBannerViewDelegate { var bannerView: GADBannerView! override func viewDidLoad() { super.viewDidLoad() ... bannerView.delegate = self } }
Objective-C
@import GoogleMobileAds; @interface ViewController () <GADBannerViewDelegate> @property(nonatomic, strong) GADBannerView *bannerView; @end @implementation ViewController - (void)viewDidLoad { [super viewDidLoad]; ... self.bannerView.delegate = self; }
Implémenter des événements de bannière
Chacune des méthodes de GADBannerViewDelegate
est marquée comme facultative. Il vous suffit donc d'implémenter les méthodes souhaitées. Cet exemple met en œuvre chaque méthode et consigne un message dans la console:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) { print("bannerViewDidReceiveAd") } func bannerView(_ bannerView: GADBannerView, didFailToReceiveAdWithError error: Error) { print("bannerView:didFailToReceiveAdWithError: \(error.localizedDescription)") } func bannerViewDidRecordImpression(_ bannerView: GADBannerView) { print("bannerViewDidRecordImpression") } func bannerViewWillPresentScreen(_ bannerView: GADBannerView) { print("bannerViewWillPresentScreen") } func bannerViewWillDismissScreen(_ bannerView: GADBannerView) { print("bannerViewWillDIsmissScreen") } func bannerViewDidDismissScreen(_ bannerView: GADBannerView) { print("bannerViewDidDismissScreen") }
Objective-C
- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView { NSLog(@"bannerViewDidReceiveAd"); } - (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error { NSLog(@"bannerView:didFailToReceiveAdWithError: %@", [error localizedDescription]); } - (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView { NSLog(@"bannerViewDidRecordImpression"); } - (void)bannerViewWillPresentScreen:(GADBannerView *)bannerView { NSLog(@"bannerViewWillPresentScreen"); } - (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView { NSLog(@"bannerViewWillDismissScreen"); } - (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView { NSLog(@"bannerViewDidDismissScreen"); }
Consultez l'exemple de délégué d'annonce pour une implémentation des méthodes de délégation de bannière dans l'application de démonstration de l'API iOS.
Cas d'utilisation
Voici quelques exemples de cas d'utilisation de ces méthodes d'événement d'annonce.
Ajout d'une bannière à la hiérarchie des vues une fois qu'une annonce a été reçue
Vous pouvez retarder l'ajout d'un GADBannerView
à la hiérarchie des vues jusqu'à la réception d'une annonce. Pour ce faire, vous pouvez écouter l'événement bannerViewDidReceiveAd:
:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) { // Add banner to view and add constraints as above. addBannerViewToView(bannerView) }
Objective-C
- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView { // Add bannerView to view and add constraints as above. [self addBannerViewToView:self.bannerView]; }
Animer une bannière
Vous pouvez également utiliser l'événement bannerViewDidReceiveAd:
pour animer une bannière une fois qu'elle a été renvoyée, comme illustré dans l'exemple suivant:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) { bannerView.alpha = 0 UIView.animate(withDuration: 1, animations: { bannerView.alpha = 1 }) }
Objective-C
- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView { bannerView.alpha = 0; [UIView animateWithDuration:1.0 animations:^{ bannerView.alpha = 1; }]; }
Mettre en pause et réactiver l'application
Le protocole GADBannerViewDelegate
comporte des méthodes permettant de vous avertir en cas d'événements, par exemple lorsqu'un clic entraîne l'affichage ou la fermeture d'une superposition.
Si vous souhaitez savoir si ces événements étaient dus à des annonces, inscrivez-vous à ces méthodes GADBannerViewDelegate
.
Pour détecter tous les types de présentations en superposition ou d'appels de navigateur externe, et pas seulement celles provenant de clics sur une annonce, il est préférable d'écouter les méthodes équivalentes sur UIViewController
ou UIApplication
dans votre application. Voici un tableau présentant les méthodes iOS équivalentes qui sont appelées en même temps que les méthodes GADBannerViewDelegate
:
Méthode GADBannerViewDelégation | Méthode iOS |
---|---|
bannerViewWillPresentScreen: |
viewWillDisappear: de UIViewController |
bannerViewWillDismissScreen: |
viewWillAppear: de UIViewController |
bannerViewDidDismissScreen: |
viewDidAppear: de UIViewController |
Tailles des bannières
Le tableau ci-dessous liste les tailles de bannières standards.
Taille en points (LxH) | Description | Garantie de disponibilité | Constante AdSize |
---|---|---|---|
320x50 | Bannière | Téléphones et tablettes | GADAdSizeBanner |
320 x 100 | Grande bannière | Téléphones et tablettes | GADAdSizeLargeBanner |
300 x 250 | Rectangle moyen IAB | Téléphones et tablettes | GADAdSizeMediumRectangle |
468 x 60 | Bannière grande taille IAB | Tablettes | GADAdSizeFullBanner |
728 x 90 | Classement IAB | Tablettes | GADAdSizeLeaderboard |
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 la taille souhaitée à l'aide de GADAdSizeFromCGSize
, comme indiqué ci-dessous:
Swift
let adSize = GADAdSizeFromCGSize(CGSize(width: 300, height: 50))
Objective-C
GADAdSize size = GADAdSizeFromCGSize(CGSizeMake(300, 50));
Ressources supplémentaires
Exemples sur GitHub
Tutoriels vidéo Mobile Ads pour les Pros
Témoignages
Étapes suivantes
En savoir plus sur la confidentialité des utilisateurs