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 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 au format fixe plutôt que des annonces de taille fixe standards. Le format est semblable à la norme du secteur : 320 x 50. Une fois vous spécifiez toute la largeur disponible, l'annonce renvoie une hauteur optimale pour cette largeur. La hauteur optimale ne change pas entre les requêtes provenant du même appareil, et les vues environnantes n'ont pas besoin de bouger lorsque l'annonce est actualisée.
Prérequis
- Suivez le guide de démarrage.
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 test dédié pour iOS. bannières:
/21775744923/example/adaptive-banner
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. 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 une GAMBannerView
Les bannières sont affichées dans des objets GAMBannerView
. La première étape de l'intégration des bannières consiste donc à inclure un GAMBannerView
dans la hiérarchie des vues. Cela se fait généralement de
manière programmatique ou
via Interface Builder.
Par programmation
Un GAMBannerView
peut également être instancié directement.
L'exemple suivant crée un GAMBannerView
:
Swift
import GoogleMobileAds
import UIKit
class ViewController: UIViewController {
var bannerView: GAMBannerView!
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 = GAMBannerView(adSize: adaptiveSize)
addBannerViewToView(bannerView)
}
func addBannerViewToView(_ bannerView: GAMBannerView) {
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 GAMBannerView
, 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 GAMBannerView
, 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 ne spécifions pas de contraintes de largeur ni de hauteur, car la taille de l'annonce fournie donnera à la bannière une taille de contenu intrinsèque pour dimensionner la vue.
@import GoogleMobileAds;
@interface ViewController ()
@property(nonatomic, strong) GAMBannerView *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 = [[GAMBannerView 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 GAMBannerView
à un storyboard ou à un fichier Xib. Lorsque vous utilisez cette
, veillez à n'ajouter des contraintes de position que 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 du bas et définissez la contrainte centerX
sur le centerX
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 GAMBannerView
est en place et que ses propriétés
vous pouvez charger une annonce. Pour ce faire, appelez loadRequest:
sur un
GAMRequest
objet:
Swift
override func viewDidLoad() {
super.viewDidLoad()
// Set the ad unit ID and view controller that contains the GAMBannerView.
bannerView.adUnitID = "/21775744923/example/adaptive-banner"
bannerView.rootViewController = self
bannerView.load(GAMRequest())
}
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 GAMBannerView.
self.bannerView.adUnitID = @"/21775744923/example/adaptive-banner";
self.bannerView.rootViewController = self;
[self.bannerView loadRequest:[GAMRequest request]];
}
Les objets GAMRequest 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 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 d'Ad Manager. Si vous n'avez pas activé l'actualisation, vous devrez envoyer une nouvelle demande.
Événements d'annonce
Grâce à GADBannerViewDelegate
, vous pouvez écouter des événements de cycle de vie, par exemple lorsqu'une annonce est fermée ou que l'utilisateur quitte l'application.
Enregistrer des événements de bannière
Pour vous inscrire aux événements d'annonces en 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 annonces bannières 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: GAMBannerView!
override func viewDidLoad() {
super.viewDidLoad()
// ...
bannerView.delegate = self
}
}
SwiftUI
banner.delegate = self
Objective-C
@import GoogleMobileAds;
@interface ViewController () <GADBannerViewDelegate>
@property(nonatomic, strong) GAMBannerView *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 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 qu'une annonce est reçue
Vous pouvez différer l'ajout d'un GAMBannerView
à la hiérarchie des vues jusqu'à ce qu'une annonce soit reçue. Vous pouvez le faire
en écoutant
Pour l'événement bannerViewDidReceiveAd:
:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
// Add banner to view and add constraints.
addBannerViewToView(bannerView)
}
Objective-C
- (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 :
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
bannerView.alpha = 0
UIView.animate(withDuration: 1, animations: {
bannerView.alpha = 1
})
}
Objective-C
- (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
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 intercepter tous les types de présentations en 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
. 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 |
Comptabilisation manuelle des impressions
Vous pouvez envoyer manuellement des pings
d'impression à Ad Manager si vous avez
les conditions d'enregistrement d'une impression. Pour ce faire, activez d'abord un GAMBannerView
pour les impressions manuelles avant de charger une annonce :
Swift
bannerView.enableManualImpressions = true
Objective-C
self.bannerView.enableManualImpressions = YES;
Lorsque vous déterminez qu'une annonce a bien été renvoyée et qu'elle apparaît à l'écran, vous pouvez déclencher une impression manuellement:
Swift
bannerView.recordImpression()
Objective-C
[self.bannerView recordImpression];
Événements d'application
Les événements d'application vous permettent de créer des annonces pouvant envoyer des messages au code de votre application. La l'application peut alors 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 que
Le bannerViewDidReceiveAd:
de l'objet GADBannerViewDelegate
est appelé.
Swift
// 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: GAMBannerView,
didReceiveAppEvent name: String, withInfo info: String?)
Objective-C
// 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 :
Swift
import GoogleMobileAds
class ViewController: UIViewController, GADAppEventDelegate {}
Objective-C
@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 créer
la demande d'annonce.
Swift
bannerView.appEventDelegate = self
Objective-C
self.bannerView.appEventDelegate = self;
Voici un exemple montrant comment modifier la couleur d'arrière-plan de votre application en en spécifiant la couleur via un événement d'application:
Swift
func bannerView(_ banner: GAMBannerView, 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
}
}
}
Objective-C
- (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 Ad Manager d'événements d'application pour découvrir comment les événements d'application sont implémentés dans Application de démonstration de l'API iOS.
Ressources supplémentaires
Exemples sur GitHub
- Exemple de bannière adaptative ancrée: 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 initialement présentées sous la forme en superposition, avec un bouton pour réduire 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. 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 Pour en savoir plus, consultez Bannières adaptatives intégrées.