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 via des composants d'interface utilisateur natifs de la plate-forme. Elles sont affichées à l'aide des mêmes types de vues que ceux que vous utilisez déjà pour créer vos mises en page, et peuvent être mises en forme pour correspondre à la conception visuelle de votre application.

Lorsqu'une annonce native se charge, votre application reçoit un objet d'annonce contenant ses composants. C'est ensuite l'application, et non GMA Next-Gen SDK, qui est chargée de les afficher.

D'une manière générale, l'implémentation des annonces natives se fait 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 guide des annonces natives.

Des exemples sont disponibles pour Java et Kotlin.

Vous pouvez également consulter des témoignages de clients : étude de cas 1, étude de cas 2.

Prérequis

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. À défaut, votre compte risque d'être suspendu.

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

Format d'annonce Exemple d'ID de bloc d'annonces
Natif ca-app-pub-3940256099942544/2247696110
Création vidéo native ca-app-pub-3940256099942544/1044960115

Charger une annonce

Pour charger une annonce native, appelez la méthode NativeAdLoader.load(), qui utilise un NativeAdRequest et un NativeAdLoaderCallback.

import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAd
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdLoader
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdLoaderCallback
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdRequest

class NativeFragment : Fragment() {

  private var nativeAd: NativeAd? = null

  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    loadAd()
  }

  private fun loadAd() {
    // Build an ad request with native ad options to customize the ad.
    val adRequest = NativeAdRequest
      .Builder(AD_UNIT_ID, listOf(NativeAd.NativeAdType.NATIVE))
      .build()

    val adCallback =
      object : NativeAdLoaderCallback {
        override fun onNativeAdLoaded(nativeAd: NativeAd) {
          // Called when a native ad has loaded.
        }
        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Called when a native ad has failed to load.
        }
      }

    // Load the native ad with our request and callback.
    NativeAdLoader.load(adRequest, adCallback)
  }

  companion object {
    // Sample native ad unit ID.
    const val AD_UNIT_ID = "ca-app-pub-3940256099942544/2247696110"
  }
}

Définir le rappel d'événement d'annonce native

Lors du traitement de onNativeAdLoaded, définissez le NativeAd reçu avec un NativeAdEventCallback pour définir les fonctions de réception des événements de cycle de vie des annonces natives :

  nativeAd.adEventCallback =
    object : NativeAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // Native ad showed full screen content.
      }
      override fun onAdDismissedFullScreenContent() {
        // Native ad dismissed full screen content.
      }
      override fun onAdFailedToShowFullScreenContent {
        // Native ad failed to show full screen content.
      }
      override fun onAdImpression() {
        // Native ad recorded an impression.
      }
      override fun onAdClicked() {
        // Native ad recorded a click.
      }
    }

Facultatif : Charger plusieurs annonces

Pour charger plusieurs annonces, appelez load() avec le paramètre facultatif numberOfAds. La valeur maximale que vous pouvez définir est 5, qui représente le nombre d'annonces. Il est possible que GMA Next-Gen SDK ne renvoie pas le nombre exact d'annonces que vous avez demandé.

private fun loadAd() {
  // Build an ad request with native ad options to customize the ad.
  val adRequest = NativeAdRequest
    .Builder(AD_UNIT_ID, listOf(NativeAd.NativeAdType.NATIVE))
    .build()

  val adCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        // Called when a native ad has loaded.
      }
      override fun onAdFailedToLoad(adError: LoadAdError) {
        // Called when a native ad has failed to load.
      }
      override fun onAdLoadingCompleted() {
        // Called when all native ads have loaded.
      }
    }

  // Load the native ad with our request and callback.
  NativeAdLoader.load(adRequest, 3, adCallback)
}

Les annonces renvoyées par GMA Next-Gen SDK sont uniques, même si les annonces de l'inventaire réservé ou des acheteurs tiers ne le sont pas nécessairement.

Si vous utilisez la médiation, n'appelez pas la méthode load(). Les demandes de plusieurs annonces natives ne fonctionnent pas pour les ID de bloc d'annonces configurés pour la médiation.

Bonnes pratiques

Suivez ces règles lorsque vous chargez des annonces.

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

  • Lorsque vous prémettez en cache des annonces, videz votre cache et rechargez-le au bout d'une heure.

  • Limitez la mise en cache des annonces natives au strict nécessaire. Par exemple, lors de la mise en cache préalable, ne mettez en cache que les annonces qui sont immédiatement visibles à l'écran. Les annonces natives ont une empreinte mémoire importante, et la mise en cache d'annonces natives sans les détruire entraîne une utilisation excessive de la mémoire.

  • Détruisez les annonces natives lorsqu'elles ne sont plus utilisées.

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

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

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

Activer l'accélération matérielle

Si l'accélération matérielle est activée de façon globale et que votre application n'adopte pas le comportement attendu, vous pouvez également la contrôler pour chaque activité. Pour activer ou désactiver l'accélération matérielle, utilisez l'attribut android:hardwareAccelerated pour les éléments <application> et <activity> de votre AndroidManifest.xml. L'exemple suivant active l'accélération matérielle sur 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>

Pour en savoir plus sur les options de contrôle de l'accélération matérielle, consultez le guide sur l'accélération matérielle. Notez que les vues d'annonces individuelles ne peuvent pas être activées pour l'accélération matérielle si l'activité est désactivée. L'accélération matérielle doit donc être activée pour l'activité elle-même.

Diffuser votre annonce

Une fois l'annonce chargée, il ne vous reste plus qu'à l'afficher pour vos utilisateurs. Pour en savoir plus, consultez format natif avancé ou Annonces natives plein écran.

Exemple

Téléchargez et exécutez l'exemple d'application qui montre comment utiliser GMA Next-Gen SDK.