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 la medición abierta.

Requisitos previos

Antes de continuar, haz lo siguiente:

• Lee Open Measurement con el SDK de anuncios para dispositivos móviles.
• Integrar 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 la medición abierta con formatos de anuncios nativos personalizados que no contienen un recurso de video, serás responsable de llamar a las APIs de Open Measurement por tu cuenta.

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

Punto clave: Para que IAB certifique los resultados de la medición de tus anuncios personalizados nativos de tipo de visualización, debes obtener la certificación como proveedor de medición de IAB Tech Lab.

Registra tu vista y comienza a medir

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

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

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

Ten en cuenta que debes mostrar el anuncio antes de registrar la vista. En Formatos de anuncios nativos personalizados, se explica cómo mostrar tu anuncio.

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 sessionFinish de la IAB.

Obtén la certificación de IAB

Una vez que lances 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 del IAB.