Questa guida spiega come integrare i formati degli annunci nativi personalizzati con la misurazione aperta.
Prerequisiti
- SDK Google Mobile Ads versione 18.1.1 o successive.
- Leggi Open Measurement with the Mobile Ads l'SDK.
- Integrare formati degli annunci nativi personalizzati.
- Configurare una visibilità fornitore e assegnarlo all'elemento pubblicitario.
- Inserisci il nome partner durante la creazione di un'immagine nell'interfaccia utente di Ad Manager.
Integrazione
Se prevedi di utilizzare la misurazione aperta con formati degli annunci nativi personalizzati che non contengono un asset video, dovrai chiamare autonomamente le API Open Measurement. Apri la misurazione per l'annuncio nativo personalizzato di tipo display è supportato solo dalla versione 18.1.1 e successive dell'SDK Mobile Ads.
Se utilizzi formati degli 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.
Carica un annuncio
Il caricamento di un annuncio è lo stesso indipendentemente dal fatto che tu stia utilizzando o meno la misurazione aperta. Ecco
un metodo che dimostra come richiedere 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();
}
Registra la visualizzazione e inizia la misurazione
Per attivare la misurazione aperta in un NativeCustomFormatAd, registra la visualizzazione annunci personalizzata con l'oggetto DisplayOpenMeasurement associato al NativeCustomFormatAd. L'oggetto DisplayOpenMeasurement fornisce
Metodo setView() per registrare la vista container con misurazione aperta.
Devi anche indicare esplicitamente all'SDK di iniziare a misurare l'annuncio. Per
chiama il metodo start() sull'oggetto DisplayOpenMeasurement del tuo
NativeCustomFormatAd. Il metodo start() deve essere chiamato dall'istanza principale
il thread e le chiamate successive non hanno alcun effetto.
Ecco che aspetto ha:
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();
}
Tieni presente che devi visualizzare il tuo annuncio prima di registrare la visualizzazione. Visualizzazione in corso... il tuo annuncio è illustrato nell'articolo Annuncio nativo personalizzato Formati.
Il layout customTemplateAdFrame è il contenitore degli annunci per
NativeCustomFormatAd e deve contenere tutti gli asset all'interno del riquadro di delimitazione di
la vista.
Ottieni la certificazione IAB
Una volta rilasciata l'app, inizierai a ricevere dati di misurazione. ma i tuoi dati non saranno certificati finché non avrai completato procedura di certificazione IAB.