Ce guide explique comment intégrer des formats d'annonces natives personnalisés à Open Measurement.
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'interface utilisateur d'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 composant vidéo, vous n'avez pas besoin de suivre ce guide. Le SDK publicitaire Mobile Ads suit la visibilité du composant vidéo pour vous.
Enregistrer votre vue et commencer à mesurer
Pour activer Open Measurement sur une annonce native personnalisée, affichez d'abord 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 la section Formats d'annonces natives personnalisés.
La mise en page nativeAdViewContainer est le conteneur d'annonce pour l'annonce native personnalisée. Elle doit contenir tous les assets dans le cadre de délimitation de la vue.
Obtenir la certification de l'IAB
Une fois votre application publiée, vous commencerez à recevoir des données de mesure. Toutefois, vos données ne seront pas certifiées tant que vous n'aurez pas terminé le processus de certification de l'IAB.