Les bannières sont des annonces rectangulaires qui occupent une partie de la mise en page d'une application. Ils restent à l'écran lorsque les utilisateurs interagissent avec l'application, ancrée au niveau de en haut ou en bas de l'écran, ou intégrées au contenu lorsque l'utilisateur fait défiler la page. Bannière les annonces peuvent s'actualiser automatiquement après un certain temps. Consultez la page Présentation des bannières. pour en savoir plus.
Ce guide vous explique comment utiliser les bannières adaptatives ancrées annonces, qui maximise les performances en optimisant la taille des annonces pour chaque appareil une largeur 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 à la norme du secteur 320 x 50. Une fois vous spécifiez toute la largeur disponible, l'annonce affiche pour cette largeur. La hauteur optimale ne change pas d'une requête à l'autre le même appareil, et les vues environnantes n'ont pas besoin de bouger lorsque l'annonce s'actualise.
Prérequis
- Suivez le guide de démarrage.
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 iOS. bannières:
ca-app-pub-3940256099942544/2435281174
Il a été spécialement configuré pour renvoyer des annonces tests pour chaque demande. de 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.
Voici un exemple de création d'un GADBannerView
,
aligné en bas et au centre de la zone de sûreté de l'écran:
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) 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]; // 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]; [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 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.
Interface Builder
Un GADBannerView
peut être ajouté à un storyboard ou à un xib
. Lorsque vous utilisez cette méthode, veillez à n'ajouter des contraintes de position
la bannière. Par exemple, lorsque vous affichez une bannière adaptative en bas d'une
écran, placez le bas de la bannière sur la même largeur que la partie supérieure
dans le Guide de mise en page, puis définissez le centre X sur le centre X de la supervue.
La taille 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
GADRequest
objet:
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()) }
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 demande d'annonce unique. 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, car si votre bloc d'annonces est actualisée. le SDK Google Mobile Ads respecte la fréquence d'actualisation spécifiée dans UI. Si vous n'avez pas activé l'actualisation, vous devrez envoyer une nouvelle demande.
Événements d'annonces
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 règle générale, la classe qui implémente les bannières
agit également en tant que classe déléguée. Dans ce cas, la propriété delegate
peut
doit ê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. Vous devez donc
vous n'avez qu'à implémenter les méthodes souhaitées. Cet exemple met en œuvre 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.
Cas d'utilisation
Voici quelques exemples d'utilisation de ces méthodes d'événements d'annonce.
Ajouter une bannière à la hiérarchie des vues une fois l'annonce reçue
Il peut être judicieux de retarder l'ajout d'un GADBannerView
à
la hiérarchie des vues jusqu'à la réception de l'annonce. Vous pouvez le faire
en écoutant
Pour 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 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
comporte des méthodes pour vous avertir d'événements, tels que
comme 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, s'inscrire
GADBannerViewDelegate
.
Pour bloquer tous les types de présentations en superposition ou d'appels de navigateurs externes,
seulement ceux provenant des clics sur les annonces, votre application
des méthodes équivalentes sur UIViewController
ou UIApplication
. Voici un tableau
affichant les méthodes iOS équivalentes qui sont appelées en même temps que
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
- Exemple de bannière adaptative ancrée: Swift | Objective-C
- Démonstration des fonctionnalités avancées: Swift | Objective-C
É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 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. Nous recommandons d'utiliser des bannières adaptatives intégrées plutôt que des bannières adaptatives ancrées pour Applications qui diffusent des bannières dans du contenu à faire défiler Voir la section API adaptative intégrée des bannières plus de détails.