Bannières

Les bannières sont des annonces rectangulaires qui occupent une partie de la mise en page d'une application. Elles restent à l'écran lorsque les utilisateurs interagissent avec l'application, soit ancrées en haut ou en bas de l'écran, soit intégrées au contenu lorsque l'utilisateur fait défiler la page. Les bannières peuvent s'actualiser automatiquement au bout d'un certain temps. Pour en savoir plus, consultez Présentation des bannières.

Ce guide explique comment faire vos premiers pas avec les bannières adaptatives ancrées, qui maximisent les performances en optimisant la taille d'annonce pour chaque appareil à l'aide de la largeur d'annonce que vous spécifiez.

Bannière adaptative ancrée

Les bannières adaptatives ancrées sont des annonces dont le format est fixe plutôt que les annonces standards de taille fixe. Le format est semblable au standard industriel 320 x 50. Une fois que vous avez spécifié la largeur maximale disponible, vous obtiendrez une annonce avec une hauteur optimale pour cette largeur. La hauteur optimale ne change pas selon les requêtes provenant du même appareil, et les vues environnantes n'ont pas besoin de se déplacer lorsque l'annonce est actualisée.

Prérequis

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 les annonces tests consiste à utiliser notre ID de bloc d'annonces test dédié aux bannières iOS : ca-app-pub-3940256099942544/2435281174

Il est spécialement configuré pour renvoyer des annonces tests pour chaque requête. Vous pouvez l'utiliser dans vos propres applications lors du codage, des tests et du débogage. 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 tests du SDK Mobile Ads, consultez Annonces tests.

Créer un GADBannerView

Les bannières étant affichées dans des objets GADBannerView, la première étape pour intégrer des bannières consiste à inclure un GADBannerView dans votre hiérarchie des vues. Cela se fait généralement par programmation ou via Interface Builder.

Par programmation

Un GADBannerView peut également être instancié directement. Voici un exemple de création d'un GADBannerView, aligné en bas au centre de la zone de sécurité de l'écran:

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  var bannerView: GADBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    
    let viewWidth = view.frame.inset(by: view.safeAreaInsets).width

    // Here the current interface orientation is used. Use
    // GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth or
    // GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth if you prefer to load an ad of a
    // particular orientation,
    let adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
    bannerView = GADBannerView(adSize: adaptiveSize)

    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];
  
  // Here safe area is taken into account, hence the view frame is used after the
  // view has been laid out.
  CGRect frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets);
  CGFloat viewWidth = frame.size.width;

  // Here the current interface orientation is used. If the ad is being preloaded
  // for a future orientation change or different orientation, the function for the
  // relevant orientation should be used.
  GADAdSize adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
  // In this case, we instantiate the banner with desired ad size.
  self.bannerView = [[GADBannerView alloc] initWithAdSize:adaptiveSize];

  [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 donne à la bannière une taille de contenu intrinsèque pour ajuster la vue.

Interface Builder

Un GADBannerView peut être ajouté à un storyboard ou à un fichier Xib. Lorsque vous utilisez cette méthode, veillez à n'ajouter que des contraintes de position sur la bannière. Par exemple, lorsque vous affichez une bannière adaptative en bas de l'écran, définissez le bas de la vue de la bannière sur la partie supérieure du guide de mise en page inférieur, et le centre X sur l'axe X au centre de la vue Super View.

La taille d'annonce de la bannière est toujours définie par programmation:

Swift

  bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)

Objective-C

  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

Charger une annonce

Une fois que GADBannerView est en place et que ses propriétés sont configurées, vous pouvez charger une annonce. Pour ce faire, appelez loadRequest: sur un objet GADRequest:

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  ...
  
  //  Set the ad unit ID and view controller that contains the GADBannerView.
  bannerView.adUnitID = "ca-app-pub-3940256099942544/2435281174"
  bannerView.rootViewController = self

  bannerView.load(GADRequest())
}

Objective-C

-   (void)viewDidLoad {
  [super viewDidLoad];
  ...
  
  //  Set the ad unit ID and view controller that contains the GADBannerView.
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2435281174";
  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 AdMobl'interface utilisateur. Si vous n'avez pas activé l'actualisation, vous devrez émettre une nouvelle demande.

Événements d'annonce

Grâce à GADBannerViewDelegate, vous pouvez écouter des événements de cycle de vie, tels que la fermeture d'une annonce ou l'arrêt de l'utilisateur.

Inscription 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 fait également office de classe déléguée. Dans ce 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 enregistre 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.

Swift Objective-C

Cas d'utilisation

Voici quelques exemples de cas d'utilisation de ces méthodes d'événement d'annonce.

Ajouter une bannière à la hiérarchie des vues une fois qu'une annonce a été reçue

Vous pouvez ajouter 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;
  }];
}

Suspendre et réactiver l'application

Le protocole GADBannerViewDelegate comporte des méthodes permettant de signaler des événements, par exemple lorsqu'un clic entraîne l'affichage ou la fermeture d'une superposition. Pour savoir si ces événements sont dus à des annonces, inscrivez-vous à ces méthodes GADBannerViewDelegate.

Pour identifier tous les types de présentations en superposition ou d'appels de navigateur externe, et pas seulement ceux qui proviennent des clics sur une annonce, 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 qui sont appelées en même temps que les méthodes GADBannerViewDelegate:

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

Ressources supplémentaires

Exemples sur GitHub

Étapes suivantes

Bannières réductibles

Les bannières réductibles sont des bannières qui sont initialement présentées sous la forme d'une plus grande superposition, avec un bouton permettant de réduire l'annonce. Pensez à l'utiliser pour optimiser davantage vos performances. Pour en savoir plus, consultez l'article sur les bannières réductibles.

Bannières adaptatives intégrées

Les bannières adaptatives intégrées sont plus grandes et plus grandes que les bannières adaptatives ancrées. Ils sont de hauteur variable et peuvent être aussi grands que l’écran de l’appareil. Les bannières adaptatives intégrées sont recommandées par rapport aux bannières adaptatives ancrées pour les applications qui placent des bannières dans du contenu à faire défiler. Pour en savoir plus, consultez la section Bannières adaptatives intégrées.

Découvrir d'autres sujets