Formats d'annonces natives personnalisés de type display et Open Measurement

Ce guide explique comment intégrer des formats d'annonces natives personnalisés avec Open Measurement.

Prérequis

Avant de continuer, procédez comme suit :

• Lisez Open Measurement avec le SDK Mobile Ads.
• Intégrez des formats d'annonces natives personnalisés.
• Configurez un fournisseur de mesure de la visibilité et attribuez-le à votre élément de campagne.
• Saisissez le nom de votre partenaire lorsque vous créez un format personnalisé dans l'interface utilisateur Ad Manager.

Intégration

Si vous prévoyez d'utiliser Open Measurement avec des formats d'annonces natives personnalisés qui ne contiennent pas d'asset vidéo, vous devrez appeler vous-même les API Open Measurement.

Si vous utilisez des formats d'annonces natives personnalisés avec un asset vidéo, vous n'avez pas besoin de suivre ce guide. Le SDK Mobile Ads suit la visibilité de l'asset vidéo à votre place.

**Important** : Pour que les résultats de mesure de vos annonces natives personnalisées de type display soient certifiés par l'IAB, vous devez être certifié en tant que fournisseur de mesure par l'IAB Tech Lab.

Enregistrez votre vue et commencez la mesure

Pour activer Open Measurement sur une annonce native personnalisée, commencez par afficher l'annonce, puis enregistrez votre vue d'annonce personnalisée avec l'objet DisplayOpenMeasurement associé à l'annonce native personnalisée. L'objet DisplayOpenMeasurement fournit la méthode setView() pour enregistrer votre vue de conteneur avec Open Measurement.

Vous devez également indiquer explicitement au SDK de commencer à mesurer votre annonce. Pour ce faire, appelez la méthode start() sur l'objet DisplayOpenMeasurement de votre annonce native personnalisée. La méthode start() doit être appelée à partir du thread principal, et les appels suivants n'ont aucun effet.

En voici un aperçu :

Kotlin

@MainThread
private fun displayCustomNativeAd(
  customNativeAd: CustomNativeAd,
  nativeAdViewContainer: FrameLayout,
) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  val displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement()
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer)
    displayOpenMeasurement.start()
  }
}
OpenMeasurementSnippets.kt

Java

@MainThread
private void displayCustomNativeAd(
    CustomNativeAd customNativeAd, FrameLayout nativeAdViewContainer) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  DisplayOpenMeasurement displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer);
    displayOpenMeasurement.start();
  }
}
OpenMeasurementSnippets.java

Notez que vous devez afficher votre annonce avant d'enregistrer votre vue. L'affichage de votre annonce est abordé dans la section Formats d'annonces natives personnalisés.

La mise en page nativeAdViewContainer est le conteneur d'annonces pour l'annonce native personnalisée et doit contenir tous les assets dans le cadre de délimitation de la vue.

Important : Veillez à appeler destroy() sur l'annonce native personnalisée lorsque vous n'en avez plus besoin, par exemple après avoir déréférencé l'objet ou détruit l'activité. Cela permet de s'assurer que l'événement sessionFinish de l'IAB est déclenché.

Obtenir la certification de l'IAB

Une fois que vous aurez publié votre application, vous commencerez à recevoir des données de mesure. Toutefois, vos données ne seront certifiées que lorsque vous aurez terminé le processus de certification de l'IAB.