Annonces natives

Les annonces natives sont des éléments d'annonce présentés aux utilisateurs via des composants d'interface utilisateur natifs de la plate-forme. Elles s'affichent avec les mêmes classes que vous utilisez déjà dans vos storyboards et peuvent être mises en forme pour correspondre à la conception visuelle de votre application.

Lors du chargement d'une annonce native, votre application reçoit un objet d'annonce contenant ses éléments. L'application (et non le SDK Google Mobile Ads) se charge alors de les afficher.

De manière générale, l'intégration des annonces natives s'effectue en deux étapes : charger une annonce à l'aide du SDK, puis afficher le contenu de l'annonce dans votre application.

Cette page explique comment utiliser le SDK pour charger des annonces natives.

Conseil :Pour en savoir plus sur les annonces natives, consultez notre playbook sur les annonces natives. Des exemples sont disponibles pour Swift et Objective-C. Vous pouvez également consulter des témoignages de clients : étude de cas 1, étude de cas 2.

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.

Le moyen le plus simple de charger des annonces tests consiste à utiliser notre ID de bloc d'annonces test dédié aux annonces natives sur iOS:

ca-app-pub-3940256099942544/3986624511

Il est spécialement configuré pour renvoyer des annonces tests pour chaque requête. Vous pouvez 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 Google Mobile Ads, consultez Annonces tests.

Charger les annonces

Les annonces natives sont chargées avec la classe GADAdLoader, qui envoie des messages à leurs délégués selon le protocole GADAdLoaderDelegate.

Initialiser le chargeur d'annonces

Avant de pouvoir charger une annonce, vous devez initialiser le chargeur d'annonces. Le code suivant montre comment initialiser un GADAdLoader:

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

Vous avez besoin d'un ID de bloc d'annonces (vous pouvez utiliser l'ID de test), de constantes à transmettre dans le tableau adTypes pour spécifier les formats natifs que vous souhaitez demander, et de toutes les options que vous souhaitez définir dans le paramètre options. La liste des valeurs possibles pour le paramètre options est disponible sur la page Définir les options d'annonces natives.

Le tableau adTypes doit contenir cette constante :

• GADAdLoaderAdTypeNative

Implémenter le délégué du chargeur d'annonces

Le délégué du chargeur d'annonces doit mettre en œuvre des protocoles spécifiques à votre type d'annonce. Pour les annonces natives, le protocole GADNativeAdLoaderDelegate inclut un message envoyé au délégué lors du chargement d'une annonce native.

Swift

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

Demander des annonces

Conseil:Vous pouvez utiliser les appels de volume d'annonces pour créer un cache d'annonces préchargées avant de vouloir les diffuser, afin que les annonces puissent être diffusées sans latence lorsque cela est nécessaire. Étant donné que les annonces expirent au bout d'une heure, vous devez vider ce cache et actualiser la page avec de nouvelles annonces toutes les heures.

Une fois votre GADAdLoader initialisé, appelez sa méthode loadRequest: pour demander une annonce:

Swift

adLoader.load(GADRequest())

Objective-C

[self.adLoader loadRequest:[GADRequest request]];

La méthode loadRequest: dans GADAdLoader accepte les mêmes objets GADRequest que les bannières et les interstitiels. Vous pouvez utiliser des objets de requête pour ajouter des informations de ciblage, comme vous le feriez avec d'autres types d'annonces.

Charger plusieurs annonces (facultatif)

Pour charger plusieurs annonces dans une seule requête, définissez l'objet GADMultipleAdsAdLoaderOptions lors de l'initialisation d'un GADAdLoader.

Swift

let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5;
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ multipleAdOptions ])

Objective-C

GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
    [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdsOptions.numberOfAds = 5;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ multipleAdsOptions ]];

Le nombre d'annonces par demande est limité à cinq, et il n'est pas garanti que le SDK renvoie le nombre exact d'annonces demandées.

Les annonces Google renvoyées seront toutes différentes les unes des autres, mais il n'est pas garanti que les annonces de l'inventaire réservé ou celles d'acheteurs tiers soient uniques.

N'utilisez pas la classe GADMultipleAdsAdLoaderOptions si vous utilisez la médiation, car les demandes de plusieurs annonces natives ne fonctionnent actuellement pas pour les ID de bloc d'annonces configurés pour la médiation.

Déterminer quand le chargement est terminé

Une fois qu'une application a appelé loadRequest:, elle peut obtenir les résultats de la requête à l'aide d'appels pour:

• adLoader:didFailToReceiveAdWithError: dans GADAdLoaderDelegate
• adLoader:didReceiveNativeAd: dans GADNativeAdLoaderDelegate

Une demande d'annonce unique donne lieu à un appel à l'une de ces méthodes.

Une demande de plusieurs annonces entraînera au moins un rappel vers les méthodes ci-dessus, sans dépasser le nombre maximal d'annonces demandées.

De plus, GADAdLoaderDelegate propose le rappel adLoaderDidFinishLoading. Cette méthode déléguée indique qu'un chargeur d'annonces a fini de charger les annonces, et qu'aucune autre annonce ou erreur n'est signalée pour la requête. L'exemple ci-dessous explique comment l'utiliser lors du chargement de plusieurs annonces natives en même temps:

Swift

class ViewController: UIViewController, GADNativeAdLoaderDelegate {

  var adLoader: GADAdLoader!

  override func viewDidLoad() {
    super.viewDidLoad()

    let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
    multipleAdOptions.numberOfAds = 5;
    adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
        rootViewController: self,
        adTypes: [ .native ],
        options: [ multipleAdOptions ])

    adLoader.delegate = self
    adLoader.load(GADRequest())
  }

  func adLoader(_ adLoader: GADAdLoader,
       didReceive nativeAd: GADNativeAd) {
    // A native ad has loaded, and can be displayed.
  }

  func adLoaderDidFinishLoading(_ adLoader: GADAdLoader) {
    // The adLoader has finished loading ads, and a new request can be sent.
  }

}

Objective-C

@interface ViewController () <GADNativeAdLoaderDelegate, GADVideoControllerDelegate>
@property(nonatomic, strong) GADAdLoader *adLoader;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
      [[GADMultipleAdsAdLoaderOptions alloc] init];
  multipleAdsOptions.numberOfAds = 5;
  self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
      rootViewController:rootViewController
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ multipleAdsOptions ]];

  self.adLoader.delegate = self;
  [self.adLoader loadRequest:[GADRequest request]];
}

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // A native ad has loaded, and can be displayed.
}

- (void)adLoaderDidFinishLoading:(GADAdLoader *) adLoader {
  // The adLoader has finished loading ads, and a new request can be sent.
}

@end

Traiter les requêtes ayant échoué

Les protocoles ci-dessus étendent le protocole GADAdLoaderDelegate, qui définit un message envoyé lorsque les annonces ne se chargent pas.

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

Avertissement :Nous vous déconseillons vivement d'essayer de charger une nouvelle annonce à partir de la méthode déléguée adLoader:didFailToReceiveAdWithError:. Si vous devez charger une annonce à partir de adLoader:didFailToReceiveAdWithError:, limitez les tentatives de chargement d'annonces pour éviter les échecs continus de demandes d'annonces dans des situations telles qu'une connectivité réseau limitée.

Recevoir des notifications en cas d'événements d'annonces natives

Pour être averti des événements liés aux interactions avec les annonces natives, définissez la propriété déléguée de l'annonce native:

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

Ensuite, implémentez GADNativeAdDelegate pour recevoir les appels de délégué suivants:

Swift

func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Objective-C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Bonnes pratiques

Suivez ces règles lorsque vous chargez des annonces.

• Les applications qui utilisent des annonces natives dans une liste doivent mettre cette liste en cache.

• Lors de la mise en cache préalable d'annonces, videz le cache et actualisez la page au bout d'une heure.

• N'appelez pas à nouveau loadRequest: sur un GADAdLoader tant que le chargement de la requête précédente n'est pas terminé, comme indiqué par adLoaderDidFinishLoading:.

Diffuser votre annonce

Une fois l'annonce chargée, il ne vous reste plus qu'à la présenter aux internautes. Pour savoir comment procéder, consultez notre guide sur le format natif avancé.