Format natif avancé

Afficher une annonce native

Lorsqu'une annonce native est chargée, le SDK Google Mobile Ads appelle l'écouteur pour le format d'annonce correspondant. Votre application est ensuite chargée d'afficher l'annonce, mais elle n'est pas nécessairement tenue de le faire immédiatement. Pour faciliter l'affichage des formats d'annonces définis par le système, le SDK propose des ressources utiles, comme décrit ci-dessous.

Classe NativeAdView

Pour le format NativeAd, il existe le format NativeAdView . Ce cours est un ViewGroup que les éditeurs doivent utiliser comme racine pour NativeAd. A NativeAdView correspond à une seule annonce native. Chaque vue utilisée pour afficher les composants de cette annonce (le ImageView qui affiche le composant de capture d'écran, par exemple) doit être un enfant de l'objet NativeAdView.

La hiérarchie des vues d'une annonce native qui utilise un LinearLayout pour afficher les vues de ses composants peut se présenter comme suit :

<com.google.android.gms.ads.nativead.NativeAdView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <LinearLayout
    android:orientation="vertical">
        <LinearLayout
        android:orientation="horizontal">
          <ImageView
           android:id="@+id/ad_app_icon" />
          <TextView
            android:id="@+id/ad_headline" />
         </LinearLayout>
         <!--Add remaining assets such as the image and media view.-->
    </LinearLayout>
</com.google.android.gms.ads.nativead.NativeAdView>

Voici un exemple qui crée un NativeAdView et le remplit avec une NativeAd:

Java

AdLoader.Builder builder = new AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Assumes you have a placeholder FrameLayout in your View layout
            // (with ID fl_adplaceholder) where the ad is to be placed.
            FrameLayout frameLayout =
                findViewById(R.id.fl_adplaceholder);
            // Assumes that your ad layout is in a file call native_ad_layout.xml
            // in the res/layout folder
            NativeAdView adView = (NativeAdView) getLayoutInflater()
                .inflate(R.layout.native_ad_layout, null);
            // This method sets the assets into the ad view.
            populateNativeAdView(nativeAd, adView);
            frameLayout.removeAllViews();
            frameLayout.addView(adView);
        }
});

Kotlin

val builder = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
    .forNativeAd { nativeAd ->
        // Assumes you have a placeholder FrameLayout in your View layout
        // (with ID fl_adplaceholder) where the ad is to be placed.
        val frameLayout: FrameLayout = findViewById(R.id.fl_adplaceholder)
        // Assumes that your ad layout is in a file call native_ad_layout.xml
        // in the res/layout folder
        val adView = layoutInflater
                .inflate(R.layout.native_ad_layout, null) as NativeAdView
        // This method sets the assets into the ad view.
        populateNativeAdView(nativeAd, adView)
        frameLayout.removeAllViews()
        frameLayout.addView(adView)
    }

Notez que tous les éléments d'une annonce native donnée doivent être affichés dans la Mise en page NativeAdView. Le SDK Google Mobile Ads tente d'enregistrer un avertissement lorsque des composants d'annonces natives sont affichés en dehors d'une mise en page de vue d'annonce native.

Les classes de visionnage d'annonce fournissent également des méthodes utilisées pour enregistrer la vue utilisée pour pour chaque élément, et une autre pour enregistrer l'objet NativeAd lui-même. Cet enregistrement des vues permet au SDK de gérer automatiquement les tâches par exemple:

  • Enregistrer les clics
  • Enregistrer les impressions lorsque le premier pixel est visible à l'écran
  • Afficher la superposition "Choisir sa pub"

Superposition "Choisir sa pub"

Le SDK ajoute une superposition Choisir sa pub à chaque vue d'annonce. Laissez un espace dans l'angle de votre choix de l'affichage de votre annonce native pour le logo "Choisir sa pub" inséré automatiquement. Il est également important que la superposition "Choisir sa pub" soit facilement visible. Choisissez donc des couleurs et des images d'arrière-plan appropriées. Pour en savoir plus sur l'apparence de la superposition et consultez la section Champ des annonces natives descriptions.

Attribution d'annonce

Vous devez afficher une attribution d'annonce pour indiquer que la vue est une publicité. Pour en savoir plus, consultez notre Règlement consignes.

Exemple de code

Pour diffuser une annonce native, procédez comme suit :

  1. Créez une instance de la classe NativeAdView.

  2. Pour chaque composant d'annonce à afficher :

    1. Renseignez la vue d'éléments avec l'élément de l'objet d'annonce.
    2. Enregistrez la vue de l'élément avec la classe NativeAdView.

  3. Enregistrez MediaView si la mise en page de votre annonce native inclut un élément multimédia volumineux.

  4. Enregistrez l'objet d'annonce avec la classe NativeAdView.

Voici un exemple de fonction qui affiche un NativeAd:

Java

private void displayNativeAd(ViewGroup parent, NativeAd ad) {

  // Inflate a layout and add it to the parent ViewGroup.
  LayoutInflater inflater = (LayoutInflater) parent.getContext()
          .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
  NativeAdView adView = (NativeAdView) inflater
          .inflate(R.layout.ad_layout_file, parent);

  // Locate the view that will hold the headline, set its text, and call the
  // NativeAdView's setHeadlineView method to register it.
  TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
  headlineView.setText(ad.getHeadline());
  adView.setHeadlineView(headlineView);

  // Repeat the process for the other assets in the NativeAd
  // using additional view objects (Buttons, ImageViews, etc).

  // If the app is using a MediaView, it should be
  // instantiated and passed to setMediaView. This view is a little different
  // in that the asset is populated automatically, so there's one less step.
  MediaView mediaView = (MediaView) adView.findViewById(R.id.ad_media);
  adView.setMediaView(mediaView);

  // Call the NativeAdView's setNativeAd method to register the
  // NativeAdObject.
  adView.setNativeAd(ad);

  // Ensure that the parent view doesn't already contain an ad view.
  parent.removeAllViews();

  // Place the AdView into the parent.
  parent.addView(adView);
}

Kotlin

fun displayNativeAd(parent: ViewGroup, ad: NativeAd) {

  // Inflate a layout and add it to the parent ViewGroup.
  val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
          as LayoutInflater
  val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView

  // Locate the view that will hold the headline, set its text, and use the
  // NativeAdView's headlineView property to register it.
  val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
  headlineView.text = ad.headline
  adView.headlineView = headlineView

  // Repeat the process for the other assets in the NativeAd using
  // additional view objects (Buttons, ImageViews, etc).

  val mediaView = adView.findViewById<MediaView>(R.id.ad_media)
  adView.mediaView = mediaView

  // Call the NativeAdView's setNativeAd method to register the
  // NativeAdObject.
  adView.setNativeAd(ad)

  // Ensure that the parent view doesn't already contain an ad view.
  parent.removeAllViews()

  // Place the AdView into the parent.
  parent.addView(adView)
}

Voici les tâches à effectuer:

  1. Gonfler la mise en page

    Java

    LayoutInflater inflater = (LayoutInflater) parent.getContext()
        .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
NativeAdView adView = (NativeAdView) inflater
        .inflate(R.layout.ad_layout_file, parent);

    Kotlin

    val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
        as LayoutInflater
val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView

    Ce code gonfle une mise en page XML contenant des vues afin d'afficher une annonce native l'annonce, puis localiser une référence à NativeAdView. Notez que vous pouvez également réutiliser un NativeAdView existant s'il en existe un dans votre fragment ou votre activité ; ou et même créer une instance de manière dynamique sans utiliser de fichier de mise en page.

  2. Remplir et enregistrer les vues des composants

    Cet exemple de code localise la vue utilisée pour afficher le titre et définit son texte à l'aide de l'élément de chaîne fourni par l'objet "annonce", puis l'enregistre avec Objet NativeAdView:

    Java

    TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
headlineView.setText(ad.getHeadline());
adView.setHeadlineView(headlineView);

    Kotlin

    val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
headlineView.text = ad.headline
adView.headlineView = headlineView

    Ce processus de localisation de la vue, de définition de sa valeur et de son enregistrement auprès de la classe de vue d'annonce doit être répété pour chacun des composants fournis par l'objet d'annonce native que l'application affichera.

  3. Gérer les clics

    N'implémentez pas de gestionnaires de clics personnalisés sur les vues au-dessus ou dans la vue d'annonce native. Les clics sur les composants de vue d'annonce sont gérés par le SDK tant que vous remplissez et enregistrez correctement les vues d'éléments, comme indiqué dans la section précédente.

    Pour écouter les clics, implémentez le rappel de clic du SDK Google Mobile Ads:

    Java

    AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110")
    // ...
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging.
        }
        @Override
        public void onAdClicked() {
            // Log the click event or other custom behavior.
        }
    })
    .build();

    Kotlin

    val adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
    // ...
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure.
        }
        override fun onAdClicked() {
            // Log the click event or other custom behavior.
        }
    })
    .build()

  4. Enregistrer MediaView

    Vous devez utiliser la MediaView au lieu de l'élément ImageView si vous souhaitez inclure un élément image principal dans la mise en page de votre annonce native annonce.

    MediaView est un View spécial conçu pour afficher l'asset multimédia principal, une vidéo ou une image.

    MediaView peut être défini dans une mise en page XML ou construit de manière dynamique. Il doit être placé dans la hiérarchie des vues d'un NativeAdView, comme n'importe quelle autre vue d'éléments. Les applications qui utilisent un MediaView doivent l'enregistrer auprès de NativeAdView:

    Java

     // Populate and register the media asset view.
 nativeAdView.setMediaView(nativeAdBinding.adMedia);

    Kotlin

     // Populate and register the media asset view.
 nativeAdView.mediaView = nativeAdBinding.adMedia

    ImageScaleType

    La classe MediaView possède une propriété ImageScaleType lors de l'affichage d'images. Si vous souhaitez modifier la mise à l'échelle d'une image dans le MediaView, définissez le ImageView.ScaleType correspondant à l'aide de la méthode setImageScaleType() du MediaView :

    Java

    mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);

    Kotlin

    mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP

    MediaContent

    La classe MediaContent contient les données liées au contenu multimédia de l'objet annonce native, qui s'affiche à l'aide de la classe MediaView. Lorsque la propriété mediaContent MediaView est définie avec une instance MediaContent :

    • Si un asset vidéo est disponible, il est mis en mémoire tampon et sa lecture commence MediaView Pour savoir si un élément vidéo est disponible, vérifiez hasVideoContent().

    • Si l'annonce ne contient aucun asset vidéo, l'asset mainImage est téléchargé et placé dans MediaView à la place.

    Par défaut, mainImage est le premier composant Image téléchargé. Si setReturnUrlsForImageAssets(true) est utilisé, mainImage est null et vous devez définir la propriété mainImage sur l'image téléchargée manuellement. Notez que cette image n'est utilisée que lorsqu'aucun élément vidéo n'est disponible.

  5. Enregistrer l'objet d'annonce native

    Cette dernière étape enregistre l'objet d'annonce native auprès de la vue responsable de pour l'afficher.

    Java

    adView.setNativeAd(ad);

    Kotlin

    adView.setNativeAd(ad)

Supprimer l'annonce

Une fois que vous avez fini de diffuser votre annonce native, vous devez la détruire pour qu'elle est correctement récupérée.

Java

nativeAd.destroy();

Kotlin

nativeAd.destroy()

Exemples sur GitHub

Exemple d'implémentation complète d'annonces natives :

Java Kotlin

Étapes suivantes

Explorez les sujets suivants: