Bannières adaptatives intégrées

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

Les bannières adaptatives vous permettent de spécifier la largeur d'une annonce pour déterminer sa taille optimale. Les bannières adaptatives maximisent également les performances en optimisant la taille des annonces pour chaque appareil. Cette approche permet d'améliorer les performances.

Par rapport aux bannières adaptatives ancrées, les bannières adaptatives intégrées sont plus grandes, plus larges et utilisent des hauteurs variables plutôt que fixes. Les bannières adaptatives intégrées ont une hauteur variable. Elles peuvent occuper tout l'écran ou une hauteur maximale que vous spécifiez.

Vous pouvez placer des bannières adaptatives intégrées dans du contenu à faire défiler, par exemple :

Diagramme montrant les différences entre les bannières adaptatives et les bannières adaptatives intégrées

Avant de commencer

Avant de continuer, assurez-vous de disposer des éléments suivants :

Implémenter des bannières adaptatives

Contrairement aux bannières ancrées adaptatives, les bannières adaptatives intégrées se chargent à l'aide d'une taille de bannière adaptative intégrée. Pour créer un format d'annonce adaptative intégrée, procédez comme suit :

  1. Obtenez la largeur de l'appareil utilisé ou définissez votre propre largeur si vous ne souhaitez pas utiliser toute la largeur de l'écran.

    Swift 

    let totalWidth = view.bounds.width
// Make sure the ad fits inside the readable area.
let insets = view.safeAreaInsets
let adWidth = totalWidth - insets.left - insets.right
    AdManagerBannerSnippets.swift

    Objective-C 

    CGFloat totalWidth = CGRectGetWidth(view.bounds);
// Make sure the ad fits inside the readable area.
UIEdgeInsets insets = view.safeAreaInsets;
CGFloat adWidth = totalWidth - insets.left - insets.right;
    AdManagerBannerSnippets.m

  2. Pour obtenir un objet de taille d'annonce adaptative intégrée pour l'orientation choisie, utilisez une méthode statique sur la classe de taille d'annonce :

    Swift 

    let adSize = currentOrientationInlineAdaptiveBanner(width: adWidth)
bannerView.adSize = adSize

// For Ad Manager, the `adSize` property is used for the adaptive banner ad
// size. The `validAdSizes` property is used as normal for the supported
// reservation sizes for the ad placement.
let validAdSize = currentOrientationAnchoredAdaptiveBanner(width: adWidth)
bannerView.validAdSizes = [nsValue(for: validAdSize)]
    AdManagerBannerSnippets.swift

    Objective-C 

    GADAdSize adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(adWidth);
bannerView.adSize = adSize;

// For Ad Manager, the `adSize` property is used for the adaptive banner ad
// size. The `validAdSizes` property is used as normal for the supported
// reservation sizes for the ad placement.
GADAdSize validAdSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(adWidth);
bannerView.validAdSizes = @[ NSValueFromGADAdSize(validAdSize) ];
    AdManagerBannerSnippets.m

Lorsque vous implémentez des bannières adaptatives dans votre application, tenez compte des points suivants :

  • Les bannières adaptatives intégrées sont plus efficaces lorsqu'elles utilisent toute la largeur disponible. Dans la plupart des cas, cette taille correspond à la largeur totale de l'écran de l'appareil utilisé ou à la largeur totale du contenu parent de la bannière. Vous devez connaître la largeur de la vue à insérer dans l'annonce, la largeur de l'appareil, la largeur du contenu parent et les zones de sécurité applicables.
  • Vous devrez peut-être mettre à jour ou créer des éléments de campagne pour utiliser les tailles adaptatives. En savoir plus

Orientation de la taille de la bannière adaptative intégrée

Pour précharger une bannière adaptative intégrée pour une orientation spécifique, utilisez les méthodes suivantes :

Si votre application est compatible avec les vues Portrait et Paysage, et que vous souhaitez précharger une bannière adaptative dans l'orientation actuelle, utilisez GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(CGFloat width). Cette méthode charge une annonce dans l'orientation actuelle.

Limiter la hauteur des bannières adaptatives intégrées

Par défaut, les bannières adaptatives intégrées instanciées sans valeur maxHeight ont une valeur maxHeight égale à la hauteur de l'appareil. Pour limiter la hauteur de la bannière adaptive intégrée, utilisez la méthode GADInlineAdaptiveBannerAdSizeWithWidthAndMaxHeight(CGFloat width, CGFloat maxHeight).

Ressources supplémentaires

Exemples sur GitHub

Téléchargez l'exemple d'application pour voir les bannières adaptatives intégrées en action.

Swift Objective-C