Charger une annonce native

Sélectionnez une plate-forme : Android iOS Flutter Unity Android (ancienne version)

Les annonces natives sont des composants d'annonce présentés aux utilisateurs à l'aide de composants d'interface utilisateur natifs pour la plate-forme. Ils sont affichés à l'aide des mêmes classes que celles que vous utilisez déjà dans vos storyboards et peuvent être mis en forme pour correspondre à la conception visuelle de votre application.

Lorsqu'une annonce native est chargée, votre application reçoit un objet d'annonce contenant ses composants. L'application (et non Google Mobile Ads SDK) est alors responsable de leur affichage.

Pour implémenter correctement les annonces natives, vous devez effectuer 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.

Prérequis

Avant de continuer, configurez Google Mobile Ads SDK.

Toujours effectuer des tests 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é pour les annonces natives sur iOS :

/21775744923/example/native

Il a été spécialement configuré pour renvoyer des annonces tests pour chaque demande. 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 les annonces tests Google Mobile Ads SDK, consultez Activer les annonces tests.

Charger des annonces

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

En plus du format natif défini par le système, vous pouvez également créer vos propres formats d'annonces natives personnalisés qui peuvent être utilisés pour les annonces natives vendues directement. Les formats personnalisés d'annonces natives vous permettent de transmettre des données structurées arbitraires à votre application. Ces annonces sont représentées par la classe GADCustomNativeAd.

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 = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  // To receive native ads, the ad loader's delegate must
  // conform to the NativeAdLoaderDelegate protocol.
  adTypes: [.native],
  // Use nil for default options.
  options: nil)
// Set the delegate before making an ad request.
adLoader.delegate = self

Remplacez nativeAdUnitID par l'ID de votre bloc d'annonces.

Objective-C

self.adLoader =
    [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                       // The UIViewController parameter is optional.
                       rootViewController:self
                                  // To receive native ads, the ad loader's delegate must
                                  // conform to the NativeAdLoaderDelegate protocol.
                                  adTypes:@[ GADAdLoaderAdTypeNative ]
                                  // Use nil for default options.
                                  options:nil];
// Set the delegate before making an ad request.
self.adLoader.delegate = self;

Remplacez kNativeAdUnitID par l'ID de votre bloc d'annonces.

Vous aurez 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 des annonces natives.

Le tableau adTypes doit contenir une ou plusieurs des constantes suivantes :

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

Le délégué du chargeur d'annonces doit implémenter des protocoles spécifiques à votre type d'annonce. Pour les annonces natives, le protocole GADNativeAdLoaderDelegate inclut un message envoyé au délégué lorsqu'une annonce native a été chargée.

Swift

func adLoader(_ adLoader: AdLoader, didReceive nativeAd: NativeAd) {