Annonces natives

Les annonces natives sont des éléments d'annonce qui sont présentés aux utilisateurs via des composants d'interface utilisateur qui sont natifs sur la plate-forme. Elles s'affichent avec les mêmes types de vues que que vous créez déjà vos mises en page, et vous pouvez les mettre en forme pour s'adapter la conception visuelle de l'application.

Lors du chargement d'une annonce native, votre application reçoit un objet d'annonce contenant ses éléments, et l'application, au lieu du SDK Google Mobile Ads, chargée de les afficher.

De manière générale, la mise en œuvre d'annonces natives s'effectue en deux étapes: Chargement d'une annonce à l'aide du SDK, puis affichage du contenu de l'annonce dans votre application.

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

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é. Pour les annonces natives sur Android:

/21775744923/example/native

Il a été spécialement configuré pour afficher des annonces tests pour chaque demande. et l'utiliser dans vos propres applications lors du codage, des tests et du débogage. Assurez-vous simplement que remplacez-le 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 Tester les annonces

Charger les annonces

Les annonces natives sont chargées la classe AdLoader, qui possède sa propre Builder pour le personnaliser lors de la création. En ajoutant des écouteurs à AdLoader lors de sa création, l'application spécifie les types d'annonces natives qu'elle est prête à diffuser recevoir. Le AdLoader ne demande alors que ces types.

Créer un adLoader

Le code suivant montre comment créer une AdLoader capable de charger des éléments natifs annonces:

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(new NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build();

val adLoader = AdLoader.Builder(this, "/21775744923/example/native}")
    .forNativeAd { ad : NativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure.
        }
    })
    .withNativeAdOptions(NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build()

La forNativeAd() est chargée de préparer AdLoader pour le format NativeAd. Lorsqu'une annonce a bien été chargée, l'objet onNativeAdLoaded() de l'objet écouteur est appelée.

Configurer un objet AdListener avec AdLoader (facultatif)

Lors de la création de l'AdLoader, la withAdListener définit une AdListener pour Loader. La méthode utilise un AdListener comme paramètre unique, qui reçoit rappels à partir de AdLoader lorsque des événements de cycle de vie d'annonce ont lieu:

.withAdListener(new AdListener() {
    // AdListener callbacks can be overridden here.
})

.withAdListener(object : AdListener() {
    // AdListener callbacks can be overridden here.
})

Demander des annonces

Une fois que vous avez terminé de créer une AdLoader, vous pouvez l'utiliser pour demander des annonces. Utilisez la méthode loadAd(), qui accepte une AdManagerAdRequest comme premier paramètre. C'est la même chose AdManagerAdRequest utilisée par les bannières et les interstitiels, Vous pouvez aussi utiliser les méthodes de la classe AdManagerAdRequest pour ajoutez des informations de ciblage, tout comme que pour d'autres formats d'annonces.

loadAd()

Cette méthode envoie une demande pour une seule annonce.

adLoader.loadAd(new AdManagerAdRequest.Builder().build());

adLoader.loadAd(AdManagerAdRequest.Builder().build())

Rappels

Après un appel à loadAd(), un seul rappel est effectué au niveau précédemment défini. méthodes d'écouteur pour diffuser l'objet d'annonce native ou signaler une erreur.

Libérer les ressources

Veillez à utiliser la méthode destroy() sur les annonces natives chargées. Cette date de sortie utilise des ressources et empêche les fuites de mémoire.

Assurez-vous que toutes les références NativeAd sont détruites dans le onDestroy().

Dans votre rappel onNativeAdLoaded, veillez à détruire tous les éléments existants des annonces natives qui seront déréférencées.

Une autre vérification de clé consiste à déterminer si l'activité est détruite et, le cas échéant, à appeler destroy() sur l'annonce renvoyée et affiche immédiatement le résultat suivant:

final AdLoader adLoader = new AdLoader.Builder(this, "/21775744923/example/native")
        .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed()` is a method on Activity.
        if (isDestroyed()) {
            nativeAd.destroy();
            return;
        }
        ...
    }
}).build();

lateinit var adLoader: AdLoader
...
adLoader = AdLoader.Builder(this, "/21775744923/example/native")
    .forNativeAd { nativeAd ->
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed` is a method on Activity.
        if (isDestroyed) {
            nativeAd.destroy()
            return@forNativeAd
        }
        ...
    }.build()

Bonnes pratiques

Suivez ces règles lors du chargement des annonces.

• Les applications qui utilisent des annonces natives dans une liste doivent effectuer une mise en cache préalable de la liste d'annonces.

• Lorsque vous mettez en cache des annonces, effacez votre cache et actualisez la page au bout d'une heure.

• N'appelez pas loadAd() sur un AdLoader avant le premier le chargement de la requête est terminé.

Accélération matérielle pour les annonces vidéo

Pour que vos annonces vidéo s'affichent correctement dans les visionnages d'annonces natives, matérielle accélération doit être activée.

L'accélération matérielle est activée par défaut, mais certaines applications peuvent choisir de le désactiver. Si votre application est concernée, nous vous recommandons d'activer le matériel l'accélération pour les classes d'activité qui utilisent des annonces.

Activer l'accélération matérielle

Si votre application ne se comporte pas correctement avec l'accélération matérielle activée de façon globale, mais vous pouvez aussi le contrôler pour des activités spécifiques. Pour activer ou désactiver l'accélération matérielle, utiliser l'attribut android:hardwareAccelerated pour le <application> et <activity> dans votre AndroidManifest.xml. L'exemple suivant active le matériel pour l'ensemble de l'application, mais la désactive pour une activité:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

Reportez-vous à la métrique Accélération matérielle guide des en savoir plus sur les options de contrôle de l'accélération matérielle. Remarque que les visionnages d'annonces individuels ne peuvent pas être activés pour l'accélération matérielle L'activité est désactivée. L'activité elle-même doit donc disposer de l'accélération matérielle. est activé.

Afficher votre annonce

Une fois l'annonce chargée, il ne vous reste plus qu'à la présenter à vos utilisateurs. Accédez à notre atelier natif avancé guide pour savoir comment procéder.