Bannières

Les bannières occupent un endroit dans 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 après un certain temps. Si vous débutez dans le domaine de la publicité mobile, sachez qu'il s'agit d'un excellent point de départ. Étude de cas.

Ce guide vous explique comment intégrer des bannières deAdMob dans une application iOS. En plus des extraits de code et des instructions, il fournit des informations sur le dimensionnement correct des bannières ainsi que des liens vers des ressources supplémentaires.

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

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. Cette opération est généralement effectuée avec Interface Builder ou de manière automatisée.

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, lorsque vous affichez 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 GADBannerView, aligné en bas au centre de la zone de sécurité 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: 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 donne à la bannière une taille de contenu intrinsèque pour ajuster 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 GADBannerView les propriétés

Pour charger et afficher les annonces, GADBannerView vous devez définir 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 l'élément GADBannerView.
  • adUnitID : ID du bloc d'annonces à partir duquel le GADBannerView doit charger les annonces.

Voici un exemple de code montrant comment définir les deux propriétés obligatoires 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, 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 pour des éléments tels que les 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 utilisateurAdMob . 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 des événements du cycle de vie, tels que la fermeture d'une annonce ou l'arrêt de l'application.

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'à ce qu'une annonce soit reçue. 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 étaient 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 des annonces, 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 GADBannerViewMetadata Méthode iOS
bannerViewWillPresentScreen: viewWillDisappear: de UIViewController
bannerViewWillDismissScreen: viewWillAppear: de UIViewController
bannerViewDidDismissScreen: viewDidAppear: de UIViewController

Le tableau ci-dessous liste les tailles de bannières 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 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

  • Exemple de bannières : Swift | Goal-C

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

  • Exemple de bannière UITableView sur GitHub : Swift | Goal-C

Tutoriels vidéo Mobile Ads pour les Pros

Témoignages

Étapes suivantes

En savoir plus sur la confidentialité des utilisateurs