Ce guide explique comment intégrer des formats d'annonces natives personnalisés à l'aide de mesures ouvertes.
Conditions préalables
- SDK Google Mobile Ads 18.1.1 ou version ultérieure.
- Consultez Open Measurement avec le SDK Mobile Ads.
- Intégrez des formats personnalisés d'annonces natives.
- Configurez un fournisseur de 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égrer
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. Open Measurement pour les formats d'annonces natives personnalisés de type display n'est compatible qu'avec les versions 18.1.1 et ultérieures du SDK Mobile Ads.
Si vous utilisez des formats personnalisés d'annonces natives avec un asset vidéo, vous n'avez pas besoin de suivre ce guide. Le SDK Mobile Ads suit la visibilité de l'élément vidéo en votre nom.
Voyons maintenant comment utiliser les mesures ouvertes avec NativeCustomTemplateAd. En règle générale, vous devez alerter le SDK Mobile Ads lorsque vous souhaitez commencer à mesurer la visibilité et enregistrer votre vue d'annonce personnalisée.
Charger une annonce
Le chargement d'une annonce est le même, que vous utilisiez Open Measurement ou non. Voici une méthode qui montre comment demander un NativeCustomTemplateAd:
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomTemplateAd("YOUR-TEMPLATE-ID",
new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
@Override
public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomTemplateAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomTemplateAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
Enregistrez votre vue et commencez à mesurer
Pour activer Open Measurement sur un NativeCustomTemplateAd, enregistrez votre vue d'annonce personnalisée avec l'objet DisplayOpenMeasurement associé à l'NativeCustomTemplateAd. L'objet DisplayOpenMeasurement fournit la méthode setView() pour enregistrer la vue du 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 NativeCustomTemplateAd. 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 :
public void registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {
...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().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 customTemplateAdFrame est le conteneur d'annonces pour NativeCustomTemplateAd. Elle doit contenir tous les éléments situés dans le cadre de délimitation de la vue.
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.