Questa guida spiega come integrare i formati di annunci nativi personalizzati con la misurazione aperta.
Prerequisiti
- SDK Google Mobile Ads versione 18.1.1 o successive.
- Leggi Open Measurement con l'SDK Mobile Ads.
- Integra formati di annunci nativi personalizzati.
- Configura un fornitore di visibilità e assegnalo al tuo elemento pubblicitario.
- Inserisci il nome del tuo partner durante la creazione di un formato personalizzato nell'interfaccia utente di Ad Manager.
Integrazione
Se prevedi di utilizzare Open Measurement con formati di annunci nativi personalizzati che non contengono un asset video, sarai responsabile della chiamata dell'API Open Measurement. La funzionalità Open Measurement per i formati di annunci nativi personalizzati di tipo display è supportata solo dall'SDK Mobile Ads versione 18.1.1 e successive.
Se utilizzi formati di annunci nativi personalizzati con un asset video, non devi seguire questa guida; l'SDK Mobile Ads monitora la visibilità dell'asset video per tuo conto.
Vediamo ora come utilizzare la funzionalità di misurazione aperta con NativeCustomTemplateAd. In generale, devi avvisare l'SDK Mobile Ads quando vuoi iniziare la misurazione della visibilità e registrare la visualizzazione dell'annuncio personalizzata.
Carica un annuncio
Il caricamento di un annuncio è lo stesso indipendentemente dal fatto che tu stia utilizzando Open Measurement o meno. Ecco un metodo che mostra come richiedere 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();
}
Registra la visualizzazione e inizia la misurazione
Per attivare la misurazione aperta su un NativeCustomTemplateAd, registra la visualizzazione dell'annuncio personalizzata con l'oggetto DisplayOpenMeasurement associato a NativeCustomTemplateAd. L'oggetto DisplayOpenMeasurement fornisce il
metodo setView() per registrare la vista contenitore con la misurazione aperta.
Devi anche indicare esplicitamente all'SDK di iniziare a misurare l'annuncio. Per farlo, chiama il metodo start() sull'oggetto DisplayOpenMeasurement del tuo NativeCustomTemplateAd. Il metodo start() deve essere chiamato dal thread principale e le chiamate successive non hanno alcun effetto.
Ecco che aspetto ha:
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();
}
Tieni presente che devi pubblicare il tuo annuncio prima di registrare la visualizzazione. La visualizzazione dell'annuncio è descritta nell'articolo Formati di annunci nativi personalizzati.
Il layout customTemplateAdFrame è il contenitore di annunci per NativeCustomTemplateAd e deve contenere tutti gli asset nel riquadro di delimitazione della vista.
Certificazione IAB
Una volta rilasciata l'app, inizierai a ricevere dati di misurazione, ma i tuoi dati non saranno certificati finché non avrai completato la procedura di certificazione IAB.