Ce guide explique comment intégrer des formats personnalisés d'annonces natives avec Open Measurement.
Prérequis
Avant de continuer, procédez comme suit :
- Lisez Open Measurement avec le SDK Mobile Ads.
- Intégrez des formats personnalisés d'annonces natives.
- 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 personnalisés d'annonces natives qui ne contiennent pas de composant Vidéo, vous devrez appeler vous-même les API Open Measurement.
Si vous utilisez des formats personnalisés d'annonces natives avec un composant Vidéo, vous n'avez pas besoin de suivre ce guide. Le SDK Mobile Ads suit la visibilité du composant Vidéo à votre place.
Enregistrez votre vue et commencez la mesure
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, 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()
}
}
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 personnalisés d'annonces natives.
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.
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.