Formati degli annunci nativi personalizzati di tipo display e Open Measurement

Questa guida spiega come integrare i formati degli annunci nativi personalizzati con la misurazione aperta.

Prerequisiti

Prima di continuare, esegui le seguenti operazioni:

• Leggi l'articolo Open Measurement con l'SDK Mobile Ads.
• Integra formati degli annunci nativi personalizzati.
• Configura un fornitore visibilità e assegnalo 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 tu stesso le API Open Measurement.

Se utilizzi formati di annunci nativi personalizzati con una risorsa video, non devi seguire questa guida. L'SDK Mobile Ads monitora la visibilità della risorsa video per tuo conto.

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

Registra la visualizzazione e inizia la misurazione

Per attivare la misurazione aperta 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 contenitore con Open Measurement.

Devi anche indicare esplicitamente all'SDK di iniziare a misurare il tuo annuncio. Per farlo, chiama il metodo start() sull'oggetto DisplayOpenMeasurement del tuo annuncio nativo personalizzato. Il metodo start() deve essere chiamato dal thread principale e le chiamate successive non hanno 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()
  }
}

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

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

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

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

Certificazione IAB

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