Formatos personalizados de anuncios nativos de tipo de visualización y Open Measurement

En esta guía, se explica cómo integrar formatos de anuncios nativos personalizados con Open Measurement.

Requisitos previos

Antes de continuar, haz lo siguiente:

• Lee Open Measurement con el SDK de anuncios para dispositivos móviles.
• Integra formatos de anuncios nativos personalizados.
• Configura un proveedor de visibilidad y asígnalo a tu línea de pedido.
• Ingresa el nombre de tu socio cuando crees un formato personalizado en la IU de Ad Manager.

Integración

Si planeas usar Open Measurement con formatos de anuncios nativos personalizados que no contengan un recurso de video, serás responsable de llamar a las APIs de Open Measurement.

Si usas formatos de anuncios nativos personalizados con un recurso de video, no es necesario que sigas esta guía. El SDK de anuncios para dispositivos móviles hace un seguimiento de la visibilidad del recurso de video en tu nombre.

Punto clave: Para que IAB certifique los resultados de medición de tus anuncios nativos personalizados de tipo display, debes estar certificado como proveedor de medición con el IAB Tech Lab.

Registra tu vista y comienza a medir

Para habilitar Open Measurement en un anuncio nativo personalizado, primero muestra el anuncio y, luego, registra tu vista de anuncio personalizado con el objeto DisplayOpenMeasurement asociado al anuncio nativo personalizado. El objeto DisplayOpenMeasurement proporciona el setView() método para registrar tu vista de contenedor con Open Measurement.

También debes indicarle explícitamente al SDK que comience a medir tu anuncio. Para ello, llama al método start() en el objeto DisplayOpenMeasurement de tu anuncio nativo personalizado. Se debe llamar al método start() desde el subproceso principal, y las llamadas posteriores no tienen ningún efecto.

A continuación, le mostramos cómo se ve:

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

Ten en cuenta que debes mostrar tu anuncio antes de registrar tu vista. La visualización de tu anuncio se explica en Formatos de anuncios nativos personalizados.

El diseño nativeAdViewContainer es el contenedor de anuncios para el anuncio nativo personalizado y debe contener todos los recursos dentro del cuadro delimitador de la vista.

**Importante:** Asegúrate de llamar a destroy() en el anuncio nativo personalizado cuando termines de usarlo, por ejemplo, después de anular la referencia del objeto o destruir la actividad. Esto garantiza que se active el evento IAB sessionFinish se active.

Obtén la certificación de IAB

Una vez que publiques tu app, comenzarás a recibir datos de medición. Sin embargo, tus datos no se certificarán hasta que completes el proceso de certificación de IAB.