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, ancrées en haut ou en bas de l'écran, ou intégrées au contenu lorsque l'utilisateur fait défiler la page. Les bannières peuvent s'actualiser automatiquement après un certain temps. Pour en savoir plus, consultez la page Présentation des bannières.

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

Bannière adaptative ancrée

Les bannières adaptatives ancrées sont des annonces au format fixe plutôt que les annonces standards de taille fixe. Le format est semblable à la norme du secteur 320 x 50. Une fois que vous avez spécifié la largeur maximale disponible, vous obtenez une annonce dont la hauteur est optimale pour cette largeur. La hauteur optimale ne change pas entre les requêtes provenant d'un même appareil, et les vues environnantes n'ont pas besoin de bouger lors de l'actualisation de l'annonce.

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 en ligne. À 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 : /6499/example/adaptive-banner

Cet outil a été spécialement configuré pour renvoyer des annonces tests pour chaque requête. Vous êtes libre de 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 GAMBannerView

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

Par programmation

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

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  var bannerView: GAMBannerView!

  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 = GAMBannerView(adSize: adaptiveSize)

    addBannerViewToView(bannerView)
  }

  func addBannerViewToView(_ bannerView: GAMBannerView) {
    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) GAMBannerView *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 = [[GAMBannerView 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 n'imposons 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.

Interface Builder

Conseil :Pour implémenter des bannières à l'aide de SwiftUI, consultez Bannières.

Un GAMBannerView peut être ajouté à un storyboard ou à un fichier Xib. Lorsque vous utilisez cette méthode, veillez à n'ajouter des contraintes de position que 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 bannière sur la même valeur que le haut du guide de mise en page en bas, et le centre X sur le centre de la supervue.

La taille de la bannière est toujours définie de manière programmatique:

Swift

  bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)

Objective-C

  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

Charger une annonce

Une fois l'GAMBannerView en place et ses propriétés configurées, il est temps de charger une annonce. Pour ce faire, appelez loadRequest: sur un objet GAMRequest:

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  ...
  
  //  Set the ad unit ID and view controller that contains the GAMBannerView.
  bannerView.adUnitID = "/6499/example/adaptive-banner"
  bannerView.rootViewController = self

  bannerView.load(GAMRequest())
}

Objective-C

-   (void)viewDidLoad {
  [super viewDidLoad];
  ...
  
  //  Set the ad unit ID and view controller that contains the GAMBannerView.
  self.bannerView.adUnitID = @"/6499/example/adaptive-banner";
  self.bannerView.rootViewController = self;

  [self.bannerView loadRequest:[GAMRequest request]];
}

Les objets GAMRequest représentent une demande d'annonce unique et contiennent des propriétés pour des éléments tels que des informations de ciblage.

Si votre annonce ne se charge pas, vous n'avez pas besoin d'en demander une autre de façon explicite 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'interface utilisateur d'Ad Manager. Si vous n'avez pas activé l'actualisation, vous devrez envoyer une nouvelle demande.

Conseil:Vous pouvez utiliser les appels de volume d'annonces pour créer un cache d'annonces préchargées avant de les diffuser, de sorte que les annonces puissent s'afficher sans latence en cas de besoin. Les annonces expirent au bout d'une heure. Vous devez donc vider ce cache et actualiser la page avec de nouvelles annonces toutes les heures.

Événements d'annonces

Grâce à GADBannerViewDelegate, vous pouvez écouter les événements de cycle de vie, comme la fermeture d'une annonce ou la fermeture de l'application par l'utilisateur.

S'inscrire aux événements de bannière

Pour vous inscrire aux événements de bannières, définissez la propriété delegate sur GAMBannerView 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. Dans ce cas, la propriété delegate peut être définie sur self.

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADBannerViewDelegate {

  var bannerView: GAMBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    ...
    bannerView.delegate = self
  }
}

Objective-C

@import GoogleMobileAds;

@interface ViewController () <GADBannerViewDelegate>

@property(nonatomic, strong) GAMBannerView *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 Ad Délégué pour découvrir une implémentation de 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'annonce.

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

Vous pouvez retarder l'ajout d'un GAMBannerView à la hiérarchie des vues jusqu'à ce qu'une annonce ait été 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:(GAMBannerView *)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 est 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:(GAMBannerView *)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 pour vous avertir 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 détecter tous les types de présentations en superposition ou d'appels de navigateurs externes, pas seulement ceux provenant de 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 GADBannerViewDelegate	Méthode iOS
bannerViewWillPresentScreen:	viewWillDisappear: de UIViewController
bannerViewWillDismissScreen:	viewWillAppear: de UIViewController
bannerViewDidDismissScreen:	viewDidAppear: de UIViewController

Comptabilisation manuelle des impressions

Important :La comptabilisation manuelle des impressions n'est compatible qu'avec les campagnes vendues directement et les campagnes d'auto-promotion (c'est-à-dire les créations dont le trafficking est effectué directement dans Ad Manager). Vous ne devez pas l'utiliser pour les annonces de remplissage ou les annonces de réseaux tiers. Pour en savoir plus, consultez cet article du Centre d'aide.

Vous pouvez envoyer manuellement des pings d'impression à Ad Manager si vous avez des conditions particulières concernant l'enregistrement d'une impression. Pour ce faire, activez d'abord un GAMBannerView pour les impressions manuelles avant de charger une annonce:

Swift

bannerView.enableManualImpressions = true

Objective-C

self.bannerView.enableManualImpressions = YES;

Lorsque vous déterminez qu'une annonce a bien été renvoyée et qu'elle s'affiche à l'écran, vous pouvez déclencher une impression manuellement:

Swift

bannerView.recordImpression()

Objective-C

[self.bannerView recordImpression];

Remarque :Les impressions sont automatiquement déclenchées lorsque le rappel bannerViewDidReceiveAd: est appelé. Vous ne devez envisager d'utiliser cette fonctionnalité que si vous souhaitez enregistrer des impressions à un autre moment.

Événements d'application

Les événements d'application vous permettent de créer des annonces qui peuvent envoyer des messages au code de l'application. L'application peut ensuite effectuer des actions en fonction de ces messages.

Vous pouvez écouter les événements d'application spécifiques à Ad Manager à l'aide de GADAppEventDelegate. Ces événements peuvent se produire à tout moment au cours du cycle de vie de l'annonce, même avant que le bannerViewDidReceiveAd: de l'objet GADBannerViewDelegate ne soit appelé.

Swift

// Implement your app event within this method. The delegate will be
// notified when the SDK receives an app event message from the ad.

// Called when the banner receives an app event.
optional public func bannerView(_ banner: GAMBannerView,
    didReceiveAppEvent name: String, withInfo info: String?)

Objective-C

// Implement your app event within this method. The delegate will be
// notified when the SDK receives an app event message from the ad.

@optional
// Called when the banner receives an app event.
-   (void)bannerView:(GAMBannerView *)banner
    didReceiveAppEvent:(NSString *)name
              withInfo:(NSString *)info;

Vos méthodes d'événement d'application peuvent être implémentées dans un contrôleur de vue:

Swift

import GoogleMobileAds

class ViewController: UIViewController, GADAppEventDelegate {
}

Objective-C

@import GoogleMobileAds;

@interface ViewController : UIViewController <GADAppEventDelegate> {
}

@end

N'oubliez pas de définir le délégué à l'aide de la propriété appEventDelegate avant d'effectuer la demande d'annonce.

Swift

bannerView.appEventDelegate = self

Objective-C

self.bannerView.appEventDelegate = self;

Voici un exemple montrant comment modifier la couleur d'arrière-plan de votre application en la spécifiant via un événement d'application:

Swift

func bannerView(_ banner: GAMBannerView, didReceiveAppEvent name: String,
    withInfo info: String?) {
  if name == "color" {
    guard let info = info else { return }
    switch info {
    case "green":
      // Set background color to green.
      view.backgroundColor = UIColor.green
    case "blue":
      // Set background color to blue.
      view.backgroundColor = UIColor.blue
    default:
      // Set background color to black.
      view.backgroundColor = UIColor.black
    }
  }
}

Objective-C

-   (void)bannerView:(GAMBannerView *)banner
    didReceiveAppEvent:(NSString *)name
              withInfo:(NSString *)info {
  if ([name isEqual:@"color"]) {
    if ([info isEqual:@"green"]) {
      // Set background color to green.
      self.view.backgroundColor = [UIColor greenColor];
    } else if ([info isEqual:@"blue"]) {
      // Set background color to blue.
      self.view.backgroundColor = [UIColor blueColor];
    } else
      // Set background color to black.
      self.view.backgroundColor = [UIColor blackColor];
    }
  }
}

Et voici la création correspondante qui envoie des messages d'événement d'application de couleur à appEventDelegate:

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

Consultez l'exemple d'événement d'application Ad Manager pour découvrir une implémentation des événements d'application dans l'application de démonstration de l'API iOS.

Swift Objective-C

Autres ressources

Exemples sur GitHub

• Exemple de bannière adaptative ancrée : Swift | Objective-C

• Démonstration des fonctionnalités avancées : Swift | Objective-C

É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 superposition plus grande, avec un bouton permettant de réduire l'annonce. Pensez à l'utiliser pour optimiser davantage vos performances. Pour en savoir plus, consultez 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 hauts que l'écran de l'appareil. Les bannières adaptatives intégrées sont recommandées plutôt que les bannières adaptatives ancrées pour les applications qui affichent 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

• Confidentialité des utilisateurs