Styles natifs

Les paramètres de style natif permettent à Google Ad Manager de gérer l'affichage de vos annonces natives en fonction des styles natifs que vous spécifiez dans le produit. Commencez par spécifier la taille et le ciblage. Ajoutez ensuite du code HTML, CSS et JavaScript pour définir des annonces responsives qui s'affichent de manière optimale sur tous les écrans. Vous n'avez pas besoin de procéder au rendu. Ad Manager applique automatiquement le style natif approprié à la destination. Les styles natifs sont implémentés comme les bannières publicitaires, à l'aide d'un GAMBannerView. Ils peuvent être utilisés avec une taille d'annonce fixe déterminée à l'avance ou une taille d'annonce fluide déterminée au moment de l'exécution.

Prérequis

  • SDK Google Mobile Ads 7.14.0 ou version ultérieure

Ce guide suppose que vous connaissez le SDK Google Mobile Ads. Si vous ne l'avez pas déjà fait, consultez notre guide de démarrage.

Taille fixe

Les styles natifs à taille fixe vous permettent de contrôler la largeur et la hauteur de l'annonce native. Pour définir une taille fixe, procédez comme suit:

  1. Créez un élément de campagne dans l'interface utilisateur d'Ad Manager, puis sélectionnez l'une des tailles prédéfinies dans le menu déroulant du champ Size.

  2. Dans Interface Builder, définissez la largeur et la hauteur de GAMBannerView pour qu'elles correspondent à la taille prédéfinie que vous avez sélectionnée à l'étape 1. Vous pouvez consulter la liste des tailles et des constantes GADAdSize correspondantes dans la section Taille de la bannière.

Implémenter des styles natifs avec une taille fixe est aussi simple que de suivre les instructions de la section Votre première demande de bannière. Vous gagnez en flexibilité et en contrôle sur le code HTML, CSS et JavaScript pour donner à votre bannière une apparence native naturelle dans votre application.

Taille "Fluide"

Dans certains cas, une taille fixe peut ne pas être adaptée. Par exemple, vous pouvez souhaiter que la largeur de l'annonce corresponde au contenu de votre application, mais que sa hauteur s'ajuste de manière dynamique pour s'adapter au contenu de l'annonce. Pour gérer ce cas, vous pouvez spécifier Fluid comme taille de l'annonce dans l'interface utilisateur d'Ad Manager, ce qui indique que la taille de l'annonce est déterminée au moment de l'exécution dans l'application. Le SDK fournit une constante GADAdSize spéciale, kGADAdSizeFluid, pour gérer ce cas. La hauteur de la taille d'annonce fluide est déterminée dynamiquement en fonction de la largeur définie par l'éditeur, ce qui permet à GAMBannerView d'ajuster sa hauteur en fonction de celle de la création.

Requête fluide

Contrairement aux autres formats d'annonces, la taille d'annonce kGADAdSizeFluid n'a pas de largeur prédéfinie. Veillez donc à définir explicitement la largeur du cadre de la bannière dans votre code ou dans Interface Builder. Si aucune largeur n'est spécifiée, le SDK définit par défaut la hauteur de la bannière en fonction de la largeur totale de l'appareil.

Si vous effectuez une demande multitaille qui inclut kGADAdSizeFluid, l'annonce renvoyée est toujours placée dans un conteneur fluide et se comporte comme une annonce fluide. Si une création non fluide est renvoyée dans ce conteneur fluide, le SDK centre l'annonce dans le conteneur afin que vous n'ayez pas à modifier la contrainte de largeur chaque fois qu'une nouvelle annonce est renvoyée.

L'implémentation d'une requête fluide à taille unique et multitaille est très similaire. La seule différence est que, pour une requête multitaille, vous devez définir la propriété validAdSizes pour spécifier les tailles d'annonces valides pour la requête d'annonce:

Swift

bannerView.validAdSizes = [nsValue(for: AdSizeFluid), nsValue(for: AdSizeBanner)]

Objective-C

_bannerView.validAdSizes = @[ NSValueFromGADAdSize(kGADAdSizeFluid),
                              NSValueFromGADAdSize(kGADAdSizeBanner) ];

Voici à quoi ressemble l'implémentation complète dans le code:

Swift

var bannerView: AdManagerBannerView!

override func viewDidLoad() {
super.viewDidLoad()
  // Create the GAMBannerView and set its width to a width that makes sense for your
  // app. In this example, the width is set to the width of the UIViewController's
  // root view.
  bannerView = AdManagerBannerView(adSize: AdSizeFluid)
  var frameRect = bannerView.frame
  frameRect.size.width = view.bounds.width
  bannerView.frame = frameRect

  // Uncomment this code for a multisize fluid request.
  // bannerView.validAdSizes = [nsValue(for: AdSizeFluid), nsValue(for: AdSizeBanner)]

  bannerView.adUnitID = "YOUR_AD_UNIT_ID"
  bannerView.rootViewController = self

  // Make the ad request.
  bannerView.load(AdManagerRequest())
}

Objective-C

GAMBannerView *_bannerView;

- (void)viewDidLoad {
  [super viewDidLoad];
  // Create the GAMBannerView and set its width to a width that makes sense for your
  // app. In this example, the width is set to the width of the UIViewController's
  // root view.
  _bannerView = [[GAMBannerView alloc] initWithAdSize:kGADAdSizeFluid];
  CGRect frameRect = _bannerView.frame;
  frameRect.size.width = CGRectGetWidth(self.view.bounds);
  _bannerView.frame = frameRect;

  // Uncomment this code for a multisize fluid request.
  // _bannerView.validAdSizes = @[ NSValueFromGADAdSize(kGADAdSizeFluid),
  //                               NSValueFromGADAdSize(kGADAdSizeBanner) ];

  _bannerView.adUnitID = @"YOUR_AD_UNIT_ID";
  _bannerView.rootViewController = self;

  // Make the ad request.
  [_bannerView loadRequest:[GAMRequest request]];
}

Pour voir un exemple d'implémentation de la taille d'annonce fluide Ad Manager, téléchargez l'application de démonstration de l'API iOS en Swift ou en Objective-C.

Télécharger la démonstration de l'API

Protocole GADAdSizeDelegate

Vous pouvez souhaiter connaître la hauteur d'une bannière avant que sa taille d'annonce ne change. Le rappel adView:willChangeAdSizeTo: informe son délégué avant que la vue de la bannière ne passe au nouveau GADAdSize. Pour être averti avant que la vue de la bannière ne passe à la nouvelle taille d'annonce, votre classe doit respecter le protocole GADAdSizeDelegate.

Voici un exemple d'implémentation du rappel adView:willChangeAdSizeTo: qui montre comment obtenir la nouvelle largeur et la nouvelle hauteur de la bannière:

Swift

// To be notified before the banner's ad size changes, your view controller class must
// conform to the GADAdSizeDelegate protocol.
bannerView.adSizeDelegate = self

// MARK: - GADAdSizeDelegate

func adView(_ bannerView: BannerView, willChangeAdSizeTo adSize: AdSize) {
  let height = adSize.size.height
  let width = adSize.size.width
}

Objective-C

// To be notified before the banner's ad size changes, your view controller class must
// conform to the GADAdSizeDelegate protocol.
_bannerView.adSizeDelegate = self;

#pragma mark - GADAdSizeDelegate

- (void)adView:(GADBannerView *)bannerView willChangeAdSizeTo:(GADAdSize)adSize {
  CGFloat height = adSize.size.height;
  CGFloat width = adSize.size.width;
}