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

En esta guía, se explica cómo integrar los formatos de anuncios nativos personalizados con la medición abierta.

Requisitos previos

Antes de continuar, haz lo siguiente:

• Lee el artículo sobre 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 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 medición abierta 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 en tu nombre.

Punto clave: Para que IAB certifique los resultados de la medición de tus anuncios personalizados nativos de tipo de visualización, debes contar con la certificación de proveedor de mediciones 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 de anuncio personalizada con el objeto DisplayOpenMeasurement asociado con el anuncio nativo personalizado. El objeto DisplayOpenMeasurement proporciona el método setView() 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 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 la vista. La visualización de tu anuncio se explica en Formatos de anuncios nativos personalizados.

El diseño nativeAdViewContainer es el contenedor del anuncio nativo personalizado y debe incluir 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 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 de IAB.