Bannières

Les bannières sont diffusées dans 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 n'avez jamais utilisé la publicité mobile, elles sont un excellent point de départ. Étude de cas.

Ce guide vous explique comment intégrer des bannières AdMob dans une application iOS. En plus des extraits de code et des instructions, il inclut des informations sur la taille correcte des bannières et des liens vers des ressources supplémentaires.

Prerequisites

• Importez le SDK Google Mobile Ads soit seul, soit dans le cadre de Firebase.

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é pour les bannières iOS : ca-app-pub-3940256099942544/2934735716

Elle a été spécialement configurée pour renvoyer des annonces tests lors de chaque demande. Vous pouvez l'utiliser dans vos propres applications à des fins de codage, de test et de débogage. Assurez-vous de 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 la page Tester les annonces.

Créer un GADBannerView

Les bannières sont affichées dans des objets GADBannerView. Par conséquent, la première étape de l'intégration de bannières consiste à inclure GADBannerView dans votre hiérarchie de vue. Ce processus est généralement effectué à l'aide du générateur d'interface ou de manière automatisée.

Générateur d'interface

Un GADBannerView peut être ajouté à un storyboard ou à un fichier xib comme n'importe quelle vue classique. Si 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, lors de l'affichage d'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 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

Notez que dans ce cas, nous ne donnons pas de contraintes de largeur ou de hauteur, car la taille d'annonce fournie permet d'attribuer une taille de contenu intrinsèque à la bannière.

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 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. Normalement, il doit être défini sur le contrôleur de vue qui contient GADBannerView.
• adUnitID : identifiant du bloc d'annonces à partir duquel GADBannerView doit charger les annonces.

Voici un exemple de code qui montre 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;
}

Remarque:Les ID de blocs d'annonces sont créés dans l'UI AdMob et représentent un emplacement dans votre application où des annonces sont diffusées. Par exemple, si vous diffusez des bannières dans deux contrôleurs de vue, vous pouvez créer un bloc d'annonces pour chacun d'eux.

Charger une annonce

Une fois que la propriété 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 pour des informations de ciblage, par exemple.

Remarque : Si le chargement de votre annonce échoue, vous n'avez pas besoin d'en demander un autre explicitement, à condition que vous ayez configuré l'actualisation du bloc d'annonces. Le SDK Google Mobile Ads respecte la fréquence d'actualisation spécifiée dans l'interface utilisateur.AdMob Si vous n'avez pas activé l'actualisation, vous devez émettre une nouvelle requête.

Événements publicitaires

Grâce à GADBannerViewDelegate, vous pouvez écouter des événements de cycle de vie, par exemple lorsqu'une annonce est fermée ou lorsque l'utilisateur quitte l'application.

S'inscrire à des événements bannière

Pour enregistrer des événements de bannière, définissez la propriété delegate sur GADBannerView sur un objet qui implémente le protocole GADBannerViewDelegate. En général, la classe qui implémente des bannières est également définie en tant que classe de délégué, 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;
}

Intégrer des événements de type bannière

Chacune des méthodes dans GADBannerViewDelegate est marquée comme facultative. Vous n'avez donc besoin que 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'annonces 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 pour ces méthodes d'événements d'annonce.

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

Vous pouvez retarder l'ajout d'une 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;
  }];
}

Mettre en pause et réactiver l'application

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

Pour intercepter tous les types de présentations en superposition ou d'appels de navigateur externes, et pas seulement ceux provenant des clics sur les annonces, il est préférable d'utiliser les méthodes équivalentes sur UIViewController ou UIApplication pour votre application. Voici un tableau affichant 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:	UIViewControllerviewWillDisappear:
bannerViewWillDismissScreen:	UIViewControllerviewWillAppear:
bannerViewDidDismissScreen:	UIViewControllerviewDidAppear:

Tailles des bannières

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 IAB en taille réelle	Tablets	GADAdSizeFullBanner
728 x 90	Classement de l'IAB	Tablets	GADAdSizeLeaderboard
Largeur fournie x Hauteur adaptative	Bannière adaptative	Téléphones et tablettes	N/A

Tailles d'annonce 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

• Exemple de bannière : Swift | Objective-C

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

• Exemple de valeur UITableView sur GitHub : Swift | Objective-C

Tutoriels vidéo sur les annonces mobiles garage

• Bannière
• Bonnes pratiques concernant les bannières

Témoignages

• Exemple de cas d'utilisation