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 Présentation des bannières.

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 des annonces à format fixe, contrairement aux annonces à taille fixe habituelles. Le format est semblable à celui des bannières standards 320 x 50. Une fois que vous avez spécifié la largeur totale disponible, une annonce est renvoyée avec la hauteur optimale pour cette largeur. La hauteur optimale ne change pas pour 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

• Suivez le guide de démarrage.

Toujours effectuer des tests 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 tester le chargement des annonces consiste à utiliser notre ID de bloc d'annonces de test dédié pour les bannières iOS :

/21775744923/example/adaptive-banner

Il a été spécialement configuré pour renvoyer des annonces tests pour chaque demande. Vous pouvez l'utiliser librement 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 publicitaires sont affichées dans des objets GAMBannerView. La première étape pour intégrer des bannières publicitaires consiste donc à inclure un GAMBannerView dans votre hiérarchie de vues. Cette opération est généralement effectuée de manière programmatique ou via Interface Builder.

Par programmation

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

// Initialize the BannerView.
bannerView = BannerView()

bannerView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(bannerView)

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
NSLayoutConstraint.activate([
  // Align the banner's bottom edge with the safe area's bottom edge
  bannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
  // Center the banner horizontally in the view
  bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
])
BannerSnippets.swift

private struct BannerViewContainer: UIViewRepresentable {
  typealias UIViewType = BannerView
  let adSize: AdSize

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

  func makeUIView(context: Context) -> BannerView {
    let banner = BannerView(adSize: adSize)
    banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
    banner.load(Request())
    banner.delegate = context.coordinator
    return banner
  }

  func updateUIView(_ uiView: BannerView, context: Context) {}

  func makeCoordinator() -> BannerCoordinator {
    return BannerCoordinator(self)
  }
BannerContentView.swift

var body: some View {
  Spacer()
  // Request an anchored adaptive banner with a width of 375.
  let adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
  BannerViewContainer(adSize)
    .frame(width: adSize.size.width, height: adSize.size.height)
}
BannerContentView.swift

// Initialize the GADBannerView.
self.bannerView = [[GADBannerView alloc] init];

self.bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[self.view addSubview:self.bannerView];

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
[NSLayoutConstraint activateConstraints:@[
    // Align the banner's bottom edge with the safe area's bottom edge
    [self.bannerView.bottomAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.bottomAnchor],
    // Center the banner horizontally in the view
    [self.bannerView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
]];
BannerSnippets.m

Interface Builder

Vous pouvez ajouter un GAMBannerView à un fichier storyboard ou 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 le haut du guide de mise en page inférieure et définissez la contrainte centerX sur le centerX de la supervue.

Définir la taille de l'annonce

Définissez la structure GADSize sur un type de bannière adaptative ancrée avec une largeur spécifiée :

// Request an anchored adaptive banner with a width of 375.
bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
ViewController.swift

// Request an anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(375);
ViewController.m

Charger une annonce

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

bannerView.load(AdManagerRequest())
ViewController.swift

banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
BannerContentView.swift

[self.bannerView loadRequest:[GAMRequest request]];
ViewController.m

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

Actualiser une annonce

Si vous avez configuré votre bloc d'annonces pour qu'il s'actualise, vous n'avez pas besoin de demander une autre annonce lorsque l'annonce ne se charge pas. Le SDK Google Mobile Ads respecte toute fréquence d'actualisation que vous avez spécifiée dans l'interface utilisateur Ad Manager. Si vous n'avez pas activé l'actualisation, envoyez une nouvelle demande. Pour en savoir plus sur l'actualisation des blocs d'annonces, par exemple sur la définition d'une fréquence d'actualisation, consultez Fréquence d'actualisation des annonces dans les applications mobiles.

Événements d'annonce

En utilisant 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 à des événements de bannières

Pour vous inscrire aux événements d'annonces bannière, définissez la propriété delegate sur GAMBannerView sur un objet qui implémente le 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.

bannerView.delegate = self
ViewController.swift

banner.delegate = context.coordinator
BannerContentView.swift

self.bannerView.delegate = self;
ViewController.m

Implémenter des événements de bannière

Chacune des méthodes de GADBannerViewDelegate est marquée comme facultative. Vous n'avez donc qu'à implémenter celles que vous souhaitez. Cet exemple implémente chaque méthode et consigne un message dans la console :

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print(#function)
}

func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
  print(#function + ": " + error.localizedDescription)
}

func bannerViewDidRecordClick(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewDidRecordImpression(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewWillPresentScreen(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewWillDismissScreen(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewDidDismissScreen(_ bannerView: BannerView) {
  print(#function)
}
ViewController.swift

- (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");
}
ViewController.m

Consultez l'exemple de délégué d'annonce pour découvrir une implémentation des méthodes de délégué 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 publicitaires.

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

Vous pouvez retarder l'ajout d'un GAMBannerView à la hiérarchie de vues jusqu'à la réception d'une annonce. Pour ce faire, écoutez l'événement bannerViewDidReceiveAd: :

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  // Add banner to view and add constraints.
  addBannerViewToView(bannerView)
}

- (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 publicitaire une fois qu'elle est renvoyée, comme illustré dans l'exemple suivant :

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  bannerView.alpha = 0
  UIView.animate(withDuration: 1, animations: {
    bannerView.alpha = 1
  })
}

- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
  bannerView.alpha = 0;
  [UIView animateWithDuration:1.0 animations:^{
    bannerView.alpha = 1;
  }];
}

Mettre en pause et reprendre l'application

Le protocole GADBannerViewDelegate comporte des méthodes pour vous informer des événements, par exemple lorsqu'un clic entraîne l'affichage ou la fermeture d'un overlay. Si vous souhaitez 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'invocations de navigateur externe, et pas seulement ceux qui proviennent de clics sur des annonces, il est préférable que votre application écoute les méthodes équivalentes sur UIViewController ou UIApplication. Voici un tableau indiquant les méthodes iOS équivalentes qui sont appelées en même temps que les méthodes GADBannerViewDelegate :

Comptabilisation manuelle des impressions

Vous pouvez envoyer manuellement des pings d'impression à Ad Manager si vous avez des conditions spéciales pour l'enregistrement d'une impression. Pour ce faire, commencez par activer un GAMBannerView pour les impressions manuelles avant de charger une annonce :

bannerView.enableManualImpressions = true

self.bannerView.enableManualImpressions = YES;

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

bannerView.recordImpression()

[self.bannerView recordImpression];

Événements d'application

Les événements d'application vous permettent de créer des annonces qui peuvent envoyer des messages au code de leur 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 l'appel de bannerViewDidReceiveAd: de l'objet GADBannerViewDelegate.

// 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: AdManagerBannerView,
    didReceiveAppEvent name: String, withInfo info: String?)

// 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;

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

import GoogleMobileAds

class ViewController: UIViewController, AppEventDelegate {}

@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 de demander une annonce.

bannerView.appEventDelegate = self

self.bannerView.appEventDelegate = self;

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

func bannerView(_ banner: AdManagerBannerView, 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
    }
  }
}

- (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];
    }
  }
}

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énements d'application Ad Manager pour découvrir comment implémenter des événements d'application dans l'application de démonstration de l'API iOS.

Swift Objective-C

Ressources supplémentaires

Exemples sur GitHub

• Exemple de bannières adaptatives ancrées : Swift | SwiftUI | 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 s'affichent initialement sous la forme d'une superposition plus grande, avec un bouton permettant de les réduire. Envisagez de 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 hautes que les bannières adaptatives ancrées. Elles ont une hauteur variable et peuvent atteindre la hauteur de 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 diffusent des bannières dans du contenu à faire défiler. Pour en savoir plus, consultez Bannières adaptatives intégrées.

Découvrir d'autres thèmes

• Confidentialité des données des utilisateurs