Ce guide explique comment intégrer des formats d'annonces natives personnalisés avec la mesure ouverte.
Prérequis
Avant de continuer, procédez comme suit :
- Consultez 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'UI Ad Manager.
Intégration
Si vous prévoyez d'utiliser Open Measurement avec des formats d'annonces natives personnalisés qui ne contiennent pas de composant vidéo, vous devrez appeler vous-même les API Open Measurement.
Si vous utilisez des formats d'annonces natives personnalisés avec un élément vidéo, vous n'avez pas besoin de suivre ce guide. Le SDK Mobile Ads suit la visibilité de l'élément vidéo pour vous.
Enregistrer votre vue et commencer à mesurer
Pour activer la mesure ouverte 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. Les appels ultérieurs 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()
}
}
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();
}
}
Notez que vous devez afficher votre annonce avant d'enregistrer votre vue. L'affichage de votre annonce est abordé dans Formats personnalisés d'annonces natives.
La mise en page nativeAdViewContainer est le conteneur d'annonces pour l'annonce native personnalisée. Elle doit contenir tous les composants dans le cadre de sélection de la vue.
Certification avec l'IAB
Une fois votre application publiée, 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.