Configurer des bannières publicitaires

Sélectionnez la plate-forme : Android (bêta) Android iOS Unity Flutter

Ce guide explique comment charger une bannière adaptative ancrée dans une application iOS.

Prérequis

Avant de continuer, configurez Google Mobile Ads SDK.

Toujours effectuer des tests avec des annonces test

Lorsque vous créez et testez vos applications, veillez à utiliser des annonces test plutôt que des annonces réelles. À défaut, votre compte risque d'être suspendu.

Le moyen le plus simple de charger des annonces test consiste à utiliser notre ID de bloc d'annonces test dédié pour les bannières iOS :

ca-app-pub-3940256099942544/2435281174

Il a été spécialement configuré pour renvoyer des annonces test pour chaque demande. Vous pouvez l'utiliser librement dans vos propres applications lors de la programmation, 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 test Google Mobile Ads SDK, consultez Annonces test.

Créer un GADBannerView

Les bannières s'affichent dans des GADBannerView objets. La première étape de l'intégration des bannières consiste donc à inclure un GADBannerView dans votre hiérarchie de vues. Cela se fait généralement par programmation ou via Interface Builder.

Par programmation

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

// Initialize the banner view.
bannerView = BannerView()
bannerView.delegate = self

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 = largeAnchoredAdaptiveBanner(width: 375)
  BannerViewContainer(adSize)
    .frame(width: adSize.size.width, height: adSize.size.height)
}
BannerContentView.swift

// Initialize the banner view.
GADBannerView *bannerView = [[GADBannerView alloc] init];
bannerView.delegate = self;
UIView *view = self.view;

bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[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 activateConstraints:@[
  // Align the banner's bottom edge with the safe area's bottom edge
  [bannerView.bottomAnchor
      constraintEqualToAnchor:view.safeAreaLayoutGuide.bottomAnchor],
  // Center the banner horizontally in the view
  [bannerView.centerXAnchor constraintEqualToAnchor:view.centerXAnchor],
]];

self.bannerView = bannerView;
BannerSnippets.m

Interface Builder

Vous pouvez ajouter un GADBannerView à un storyboard ou à un fichier 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érieur, et définissez la centerX contrainte sur le centerX de la supervue.

Définir la taille de l'annonce

L'exemple suivant obtient une grande taille de bannière adaptative ancrée :

// Request a large anchored adaptive banner with a width of 375.
bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
BannerSnippets.swift

// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);
BannerSnippets.m

Charger une annonce

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

func loadBannerAd(bannerView: BannerView) {
  // Request a large anchored adaptive banner with a width of 375.
  bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
  bannerView.load(Request())
}
BannerSnippets.swift

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

// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);

[self.bannerView loadRequest:[GADRequest request]];
BannerSnippets.m

Les objets GADRequest 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. Google Mobile Ads SDK respecte toute fréquence d'actualisation que vous avez spécifiée dans l'interface utilisateur AdMob. 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 Utiliser l'actualisation automatique pour les bannières.

Gérer les changements d'orientation

Lorsque l'orientation de l'écran de votre application change, par exemple du portrait mode paysage, la largeur disponible pour la bannière change souvent également. Pour vous assurer d'afficher une annonce de taille appropriée pour la nouvelle mise en page, demandez une nouvelle bannière. Si la largeur de votre bannière est statique ou si les contraintes de mise en page peuvent gérer le redimensionnement, ignorez cette étape.

override func viewWillTransition(
  to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator
) {
  coordinator.animate(alongsideTransition: { _ in
    // Load a new ad for the new orientation.
  })
}
BannerSnippets.swift

- (void)viewWillTransitionToSize:(CGSize)size
       withTransitionCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator {
  [coordinator animateAlongsideTransition:^(id<UIViewControllerTransitionCoordinatorContext> context) {
    // Load a new ad for the new orientation.
  } completion:nil];
}
BannerSnippets.m

É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ères, définissez la delegate propriété sur GADBannerView sur un objet qui implémente le GADBannerViewDelegate protocole. En règle générale, la classe qui implémente les bannières sert également de classe déléguée. Dans ce cas, la propriété delegate peut être définie sur self.

bannerView.delegate = self
BannerSnippets.swift

banner.delegate = context.coordinator
BannerContentView.swift

bannerView.delegate = self;
BannerSnippets.m

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 enregistre un message dans la console :

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print("Banner ad loaded.")
}

func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
  print("Banner ad failed to load: \(error.localizedDescription)")
}

func bannerViewDidRecordImpression(_ bannerView: BannerView) {
  print("Banner ad recorded an impression.")
}

func bannerViewDidRecordClick(_ bannerView: BannerView) {
  print("Banner ad recorded a click.")
}

func bannerViewWillPresentScreen(_ bannerView: BannerView) {
  print("Banner ad will present screen.")
}

func bannerViewWillDismissScreen(_ bannerView: BannerView) {
  print("Banner ad will dismiss screen.")
}

func bannerViewDidDismissScreen(_ bannerView: BannerView) {
  print("Banner ad did dismiss screen.")
}
BannerSnippets.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");
}
BannerSnippets.m

Pour obtenir une implémentation des méthodes déléguées de bannière, consultez l'exemple de délégué d'annonce 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 de vues une fois l'annonce reçue

Vous pouvez retarder l'ajout d'un GADBannerView à la hiérarchie de vues jusqu'à ce qu'une annonce soit reçue. Pour ce faire, écoutez l'événement bannerViewDidReceiveAd: :

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

- (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 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:(GADBannerView *)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 permettant de vous informer des événements, par exemple lorsqu'un clic entraîne la présentation ou la fermeture d'une superposition. Si vous souhaitez savoir si ces événements sont dus à des annonces, inscrivez-vous à ces méthodes GADBannerViewDelegate.

Pour intercepter tous les types de présentations de superposition ou d'appels de navigateur externes, 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. Le tableau suivant présente les méthodes iOS équivalentes qui sont appelées en même temps que les méthodes GADBannerViewDelegate :

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 réduire la taille de l'annonce. 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 larges 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 placent des bannières dans du contenu à faire défiler. Pour en savoir plus, consultez Bannières adaptatives intégrées .

Découvrir d'autres sujets

• Confidentialité des données des utilisateurs