En esta guía, se explica cómo integrar formatos de anuncios nativos personalizados con la medición abierta.
Requisitos previos
- SDK de anuncios de Google para dispositivos móviles versión 18.1.1 o posterior.
- 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 tu nombre de 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, deberás llamar a las APIs de Open Measurement por tu cuenta. La medición abierta para los formatos de anuncios nativos personalizados de tipo de visualización solo es compatible con la versión 18.1.1 y posteriores del SDK de anuncios para dispositivos móviles.
Si usas formatos del anuncio nativo personalizados con un recurso de video, no necesitas seguir esta guía; el SDK de anuncios para dispositivos móviles hace un seguimiento de la visibilidad del recurso de video por ti.
Veamos ahora cómo usar la medición abierta con NativeCustomTemplateAd
. En general, debes alertar al SDK de anuncios para dispositivos móviles cuando quieras comenzar la medición de visibilidad y registrar tu vista de anuncio personalizada.
Carga un anuncio
La carga de un anuncio es la misma, independientemente de si utilizas la medición abierta o no. A continuación,
hay un método que muestra cómo solicitar un NativeCustomTemplateAd
:
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomTemplateAd("YOUR-TEMPLATE-ID",
new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
@Override
public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomTemplateAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomTemplateAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
Registra tu vista y comienza a medir
Para habilitar la medición abierta en un NativeCustomTemplateAd
, registra tu vista de anuncio personalizada con el objeto DisplayOpenMeasurement
asociado con la NativeCustomTemplateAd
. El objeto DisplayOpenMeasurement
proporciona el método setView()
para registrar la 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 NativeCustomTemplateAd
. Se debe llamar al método start()
desde el subproceso principal, y las llamadas posteriores no tendrán efecto.
A continuación, le mostramos cómo se ve:
public void registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {
...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();
}
Ten en cuenta que debes mostrar el anuncio antes de registrar la vista. La visualización de tu anuncio está incluida en los Formatos de anuncios nativos personalizados.
El diseño customTemplateAdFrame
es el contenedor de anuncios para NativeCustomTemplateAd
y debe contener todos los elementos dentro del cuadro delimitador de la vista.
Certificar con la IAB
Una vez que lances la 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 la IAB.