Cómo usar un correlador personalizado con el SDK de anuncios para dispositivos móviles

Algunas apps requieren que dos solicitudes de anuncios se correlacionen entre sí.

El SDK de anuncios de Google para dispositivos móviles no te permite correlacionar dos solicitudes, lo que dificulta evitar que la misma creatividad se publique en dos solicitudes de anuncios similares. Las solicitudes de anuncios correlacionadas también son necesarias para las funciones de publicidad simultánea y exclusión competitiva en Ad Manager.

Un valor de correlator es un número entero sin signo aleatorio de 16 caracteres de longitud que se representa como una cadena. De forma predeterminada, el SDK de GMA genera un correlator nuevo con cada solicitud de anuncio, lo que significa que no se correlacionan dos solicitudes.

Para correlacionar dos solicitudes, puedes anular manualmente el correlator generado por el SDK de GMA y aplicar el mismo correlator a varias solicitudes de anuncios. Para usar esta función, debes generar tu propio correlator aleatorio. A continuación, se muestran ejemplos de cómo pasar tu propio correlator:

Java

Bundle extras = new Bundle();
String correlator = "2510196024846425"; // make randomly - should be 16 digits.
extras.putString("correlator", correlator);
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

Kotlin

val extras = Bundle()
val correlator = "2510196024846425" // make randomly - should be 16 digits.
extras.putString("correlator", correlator)
val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

La duración del correlator es de 30 segundos. El servidor no considerará que las solicitudes realizadas con más de 30 segundos de diferencia están correlacionadas.

Prácticas recomendadas

El uso del correlator personalizado le proporcionará a Ad Manager el contexto que necesita para evitar que se seleccione la misma creatividad, pero las solicitudes de anuncios deben realizarse de forma secuencial: realiza una solicitud de anuncio, obtén la respuesta y, luego, realiza la siguiente solicitud.

Puedes hacerlo varias veces, pero cuantas más llamadas realices, más recursos consumirás. Lo mejor es limitar las solicitudes secuenciales a entre 3 y 5. Puedes realizar llamadas adicionales a medida que el usuario se desplaza hacia abajo en la página.

Dado que el correlator vence después de 30 segundos, no es necesario que generes un valor nuevo para la misma página vista prolongada. Se genera un correlator nuevo al comienzo de cada vista de página de larga duración. Si ya no necesitas este comportamiento, deja de pasar tu propio correlator.

Para evitar que se publiquen los anuncios que mostraste en llamadas posteriores después de que venza el correlator, considera agregar una limitación de frecuencia de 1 anuncio cada 5 a 10 minutos. La hora que selecciones debe coincidir con el uso típico de tu app. Las limitaciones de frecuencia se pueden eliminar definitivamente si no renderizas los anuncios, por lo que, si realizas una solicitud de anuncio, pero no renderizas el anuncio y realizas llamadas adicionales, es posible que recibas el mismo anuncio.