Ce guide explique comment intégrer des formats d'annonces natives personnalisées avec la mesure ouverte.
Prérequis
- SDK Google Mobile Ads version 18.1.1 ou ultérieure.
- Consultez l'article Open Measurement avec les annonces pour mobile SDK.
- Intégrez des annonces natives personnalisées. d'assistance.
- Configurez un fournisseur de mesure de la visibilité et attribuez-le à votre élément de campagne.
- Saisissez le nom de votre partenaire lors de la création d'un compte dans l'interface utilisateur d'Ad Manager.
Intégration
Si vous prévoyez d'utiliser les mesures ouvertes avec des formats d'annonces natives personnalisées qui ne contiennent pas d'asset vidéo, vous devrez appeler vous-même les API Open Measurement. Open Measurement pour une annonce native personnalisée de type display ne sont compatibles qu'avec le SDK Mobile Ads version 18.1.1 ou ultérieure.
Si vous utilisez des formats d'annonces natives personnalisées 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 en votre nom.
Charger une annonce
Le chargement d'une annonce est le même, que vous utilisiez ou non la mesure ouverte. Voici une méthode qui montre comment demander un NativeCustomFormatAd :
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomFormatAd("YOUR-TEMPLATE-ID",
new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomFormatAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomFormatAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
Enregistrer votre vue et commencer à mesurer
Pour activer Open Measurement sur un NativeCustomFormatAd, enregistrez votre
l'affichage de l'annonce avec l'objet DisplayOpenMeasurement associé à
NativeCustomFormatAd L'objet DisplayOpenMeasurement fournit la méthode setView() pour enregistrer la vue de votre conteneur avec Open Measurement.
Vous devez également indiquer explicitement au SDK de commencer à mesurer votre annonce. Pour ce faire, procédez comme suit :
appelez la méthode start() sur l'objet DisplayOpenMeasurement de votre
NativeCustomFormatAd 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(NativeCustomFormatAd ad) {
...
// Show ad
...
displayCustomFormatAd(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ées.
La mise en page customTemplateAdFrame est le conteneur d'annonces
NativeCustomFormatAd et doit contenir tous les éléments dans le cadre de délimitation
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 rempli le processus de certification de l'IAB.