Formati degli annunci nativi personalizzati di tipo display e Open Measurement

Questa guida spiega come integrare i formati degli annunci nativi personalizzati con Open Measurement.

Prerequisiti

Prima di continuare, completa queste operazioni:

• Leggi la pagina sull'uso di Open Measurement con l'SDK Mobile Ads.
• Integra i formati degli annunci nativi personalizzati.
• Configura un fornitore visibilità e assegnale al tuo elemento pubblicitario.
• Inserisci il nome del partner quando crei un formato personalizzato nell'interfaccia utente di Ad Manager.

Integrazione

Se prevedi di utilizzare Open Measurement con formati degli annunci nativi personalizzati che non contengono un asset video, dovrai chiamare le API Open Measurement.

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.

Punto chiave:affinché i risultati di misurazione degli annunci nativi personalizzati di tipo display vengano certificati da IAB, devi essere certificato come fornitore di misurazioni da IAB Tech Lab.

Registra la visualizzazione e inizia la misurazione

Per attivare Open Measurement su un annuncio nativo personalizzato, visualizza prima l'annuncio, quindi registra la visualizzazione dell'annuncio personalizzato con l'oggetto DisplayOpenMeasurement associato all'annuncio nativo personalizzato. L'oggetto DisplayOpenMeasurement fornisce il metodo setView() per registrare la visualizzazione del container con Open Measurement.

Devi anche indicare esplicitamente all'SDK di iniziare a misurare l'annuncio. Per farlo, chiama il metodo start() sull'oggetto DisplayOpenMeasurement dell'annuncio nativo personalizzato. Il metodo start() deve essere chiamato dal thread principale e le chiamate successive non hanno alcun effetto.

Ecco che aspetto ha:

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()
  }
}
OpenMeasurementSnippets.kt

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();
  }
}
OpenMeasurementSnippets.java

Tieni presente che devi visualizzare l'annuncio prima di registrare la visualizzazione. La visualizzazione dell'annuncio è trattata in Formati degli annunci nativi personalizzati.

Il layout nativeAdViewContainer è il container dell'annuncio nativo personalizzato e deve contenere tutti gli asset all'interno del riquadro di delimitazione della visualizzazione.

Importante: assicurati di chiamare destroy() sull'annuncio nativo personalizzato quando hai finito di utilizzarlo, ad esempio dopo aver dereferenziato l'oggetto o distrutto l'attività. In questo modo, viene attivato l'evento sessionFinish di IAB.

Certificazione IAB

Una volta rilasciata l'app, inizierai a ricevere i dati di misurazione, tuttavia, i tuoi dati non verranno certificati finché non completi la procedura di certificazione IAB.