Bannières

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

Ce guide vous explique comment intégrer des bannièresAdMob dans une application iOS. Outre des extraits de code et des instructions, il contient des informations sur la taille appropriée des bannières et des liens vers des ressources supplémentaires.

Prérequis

Toujours tester avec les annonces tests

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 plus simple est d'utiliser notre ID de bloc d'annonces test dédié pour les bannières iOS : ca-app-pub-3940256099942544/2934735716

Elle a été spécialement configurée pour renvoyer des annonces tests à chaque demande, et vous êtes libre de l'utiliser dans vos propres applications pour coder, tester et déboguer. Veillez simplement à le remplacer par votre propre ID de bloc d'annonces avant de publier votre application.

Pour en savoir plus sur le fonctionnement des annonces de test du SDK Mobile Ads, consultez la page Tester les annonces.

Créez un GADBannerView

Les bannières sont affichées dans des objets GADBannerView. La première étape pour intégrer des bannières consiste donc à inclure un GADBannerView dans votre hiérarchie de vues. Cette opération s'effectue généralement à l'aide du générateur d'interface ou par programmation.

Générateur d'interface

Un GADBannerView peut être ajouté à un storyboard ou à un fichier xib, comme n'importe quelle vue classique. Lorsque vous utilisez cette méthode, veillez à ajouter des contraintes de largeur et de hauteur correspondant à la taille d'annonce que vous souhaitez afficher. Par exemple, pour afficher une bannière (320 x 50), définissez une contrainte de largeur de 320 points et une contrainte de hauteur de 50 points.

Par programmation

Un objet GADBannerView peut également être instancié directement. Voici un exemple de création d'une GADBannerView, alignée au centre central de la zone sûre de l'écran, avec une taille de bannière de 320 x 50:

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: bottomLayoutGuide,
                          attribute: .top,
                          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.bottomLayoutGuide
                               attribute:NSLayoutAttributeTop
                              multiplier:1
                                constant:0],
    [NSLayoutConstraint constraintWithItem:bannerView
                               attribute:NSLayoutAttributeCenterX
                               relatedBy:NSLayoutRelationEqual
                                  toItem:self.view
                               attribute:NSLayoutAttributeCenterX
                              multiplier:1
                                constant:0]
                                ]];
}
  


@end

Dans ce cas, nous ne fournissons pas de contraintes de largeur ou de hauteur, car la taille d'annonce fournie donne à la bannière une taille de contenu intrinsèque permettant de dimensionner la vue.

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 les GADBannerView propriétés

Pour charger et afficher les annonces, GADBannerView nécessite quelques propriétés.

  • 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 GADBannerView.
  • adUnitID : ID du bloc d'annonces à partir duquel GADBannerView 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 que GADBannerView est en place et que ses propriétés sont configurées, il est temps de 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 seule demande d'annonce et contiennent des propriétés telles que des informations de ciblage.

Événements d'annonce

L'utilisation de GADBannerViewDelegate vous permet d'écouter des événements de cycle de vie, par exemple lorsqu'une annonce est fermée ou que l'utilisateur quitte l'application.

Inscription aux événements de bannière

Pour vous inscrire aux événements de bannière, définissez la propriété delegate sur GADBannerView sur un objet qui implémente le protocole GADBannerViewDelegate. Généralement, la classe qui implémente des bannières est aussi utilisée comme 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 dans GADBannerViewDelegate est marquée comme facultative. Vous ne devez donc implémenter que 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 du délégué à l'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.

Swift Objective-C

Cas d'utilisation

Voici quelques exemples d'utilisation de ces méthodes d'événements d'annonces.

Ajouter une bannière à la hiérarchie des vues lorsqu'une annonce est reçue

Vous pouvez retarder l'ajout d'un GADBannerView à la hiérarchie des vues jusqu'à ce qu'une annonce soit reçue. Pour ce faire, écoutez 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;
  }];
}

Suspendre et reprendre l'application

Le protocole GADBannerViewDelegate dispose de méthodes permettant de vous avertir d'événements, par exemple lorsqu'un clic entraîne la présentation ou l'arrêt d'une superposition. Si vous souhaitez savoir si ces événements sont dus à des annonces, inscrivez-vous à ces méthodes GADBannerViewDelegate.

Pour intercepter tous les types de superpositions ou d'appels de navigateur externes, et pas seulement ceux provenant des clics sur les annonces, il est préférable que votre application écoute les méthodes équivalentes sur UIViewController ou UIApplication. Voici un tableau présentant les méthodes iOS équivalentes appelées en même temps que les méthodes GADBannerViewDelegate:

Méthode GADBannerViewDelegate Méthode iOS
bannerViewWillPresentScreen: UIViewController viewWillDisappear:
bannerViewWillDismissScreen: UIViewController viewWillAppear:
bannerViewDidDismissScreen: UIViewController viewDidAppear:

Le tableau ci-dessous répertorie les tailles de bannière standards.

Taille en points (LxH) Description Garantie de disponibilité Constante AdSize
320 x 50 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 de l'IAB en taille réelle Tablets GADAdSizeFullBanner
728 x 90 Classement IAB Tablets 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));

Autres ressources

Exemples sur GitHub

Ateliers vidéo sur le programme Publicité mobile

Témoignages