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 et sont 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 au bout d'un certain temps. Pour en savoir plus, consultez la section Présentation des bannières publicitaires.

Ce guide vous explique comment commencer à utiliser les bannières adaptatives ancrées, qui maximisent les performances en optimisant la taille des annonces 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 au format fixe plutôt que les annonces standards. des annonces de taille fixe. Le format est semblable au format standard du secteur de 320 x 50. Une fois que vous avez spécifié la largeur complète disponible, il renvoie une annonce avec une hauteur optimale pour cette largeur. La hauteur optimale ne change pas pour toutes les demandes d'une même et les vues environnantes n'ont pas besoin de bouger lors de l'actualisation de l'annonce.

Prérequis

Effectuez toujours des tests avec des annonces tests

Lorsque vous créez et testez vos applications, veillez à 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 tests dédié pour les bannières iOS :

ca-app-pub-3940256099942544/2435281174

Il a été spécialement configuré pour renvoyer des annonces de test pour chaque requête. Vous pouvez l'utiliser dans vos propres applications lors du codage, des tests et du débogage. Il suffit de créer remplacez-le 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 section Annonces :

Créer un GADBannerView

Les bannières sont affichées dans GADBannerView . Par conséquent, la première étape pour intégrer des bannières consiste à inclure un élément GADBannerView dans la hiérarchie des vues. Cela se fait généralement de manière programmatique ou via Interface Builder.

Par programmation

Un GADBannerView peut également être instancié directement. L'exemple suivant crée un GADBannerView :

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)
    // This example doesn't give width or height constraints, as the provided
    // ad size gives the banner an intrinsic content size to size the view.
    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)
      ])
  }
}

SwiftUI

Pour utiliser un GADBannerView, créez un UIViewRepresentable :

private struct BannerView: UIViewRepresentable {
  let adSize: GADAdSize

  init(_ adSize: GADAdSize) {
    self.adSize = adSize
  }

  func makeUIView(context: Context) -> UIView {
    // Wrap the GADBannerView in a UIView. GADBannerView automatically reloads a new ad when its
    // frame size changes; wrapping in a UIView container insulates the GADBannerView from size
    // changes that impact the view returned from makeUIView.
    let view = UIView()
    view.addSubview(context.coordinator.bannerView)
    return view
  }

  func updateUIView(_ uiView: UIView, context: Context) {
    context.coordinator.bannerView.adSize = adSize
  }

  func makeCoordinator() -> BannerCoordinator {
    return BannerCoordinator(self)
  }

Pour gérer l'initialisation et le comportement de GADBannerView, créez un Coordinator :

class BannerCoordinator: NSObject, GADBannerViewDelegate {

  private(set) lazy var bannerView: GADBannerView = {
    let banner = GADBannerView(adSize: parent.adSize)
    banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
    banner.load(GADRequest())
    banner.delegate = self
    return banner
  }()

  let parent: BannerView

  init(_ parent: BannerView) {
    self.parent = parent
  }

Pour obtenir la largeur de la vue, utilisez GeometryReader. Cette classe calcule la taille d'annonce appropriée pour l'orientation actuelle de l'appareil. frame est défini sur la hauteur calculée à partir de la taille de l'annonce.

var body: some View {
  GeometryReader { geometry in
    let adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(geometry.size.width)

    VStack {
      Spacer()
      BannerView(adSize)
        .frame(height: adSize.size.height)
    }
  }

Objective-C

Notez que dans ce cas, nous n'incluons 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 vue.

@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];
  // This example doesn't give width or height constraints, as the provided
  // ad size gives the banner an intrinsic content size to size the view.
  [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

Interface Builder

Vous pouvez ajouter un GADBannerView à un storyboard ou à un fichier Xib. Lorsque vous utilisez cette , veillez à n'ajouter des contraintes de position que sur la bannière. Par exemple : lors de l'affichage d'une bannière adaptative en bas de l'écran, définissez la valeur de la vue de bannière à la même position que celle du guide de mise en page du bas, puis définissez centerX égale à la centerX de la supervue.

La taille de l'annonce 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 que GADBannerView est en place et que ses propriétés 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())
}

SwiftUI

banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.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]];
}

Les objets GADRequest représentent une seule demande d'annonce et contiennent des propriétés telles que des informations de ciblage.

Si votre annonce ne parvient pas à se charger, vous n'avez pas besoin d'en demander une autre explicitement tant que vous avez configuré votre bloc d'annonces pour qu'il s'actualise. Le SDK Google Mobile Ads respecte le taux d'actualisation que vous avez spécifié dans l'interface utilisateur AdMob. Si vous n'avez pas activé l'actualisation, vous devrez envoyer une nouvelle demande.

Événements d'annonce

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

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

Pour vous inscrire aux événements de bannière, définissez la propriété delegate sur GADBannerView à un objet qui implémente la Protocole GADBannerViewDelegate. En général, la classe qui implémente les bannières publicitaires sert également 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
  }
}

SwiftUI

banner.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. Vous n'avez donc besoin d'implémenter que les méthodes de votre choix. Cet exemple implémente 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 Ad Délégué pour 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'annonces.

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

Vous pouvez différer 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.
  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 seule fois. il est renvoyé, 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 dispose de méthodes pour vous informer des événements, par exemple lorsqu'un clic entraîne l'affichage ou la fermeture d'une superposition. Si vous souhaitez déterminer si ces événements sont dus à des annonces, enregistrez-vous pour ces méthodes GADBannerViewDelegate.

Pour bloquer tous les types de présentations en superposition ou d'appels de navigateurs externes, seulement ceux provenant de clics sur une annonce, il est préférable d'écouter des méthodes équivalentes sur UIViewController ou UIApplication. Voici un tableau qui présente 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

Ressources supplémentaires

Exemples sur GitHub

Étapes suivantes

Bannières réductibles

Les bannières réductibles sont initialement présentées sous la forme en superposition, avec un bouton pour réduire l'annonce. Envisager de l'utiliser pour optimiser vos performances. Pour en savoir plus, consultez la section Annonces 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. des bannières. 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 aux applications qui placent des bannières publicitaires dans du contenu à faire défiler plutôt que les bannières adaptatives ancrées. Voir la section API adaptative intégrée des bannières plus de détails.

Découvrir d'autres sujets