Danos tu opinión sobre el SDK de anuncios de Google para móviles. Rellena la encuesta anual.

Suite de pruebas de mediación

La suite de pruebas de mediación de AdMob permite comprobar si has configurado correctamente las aplicaciones y los bloques de anuncios para mostrar anuncios de redes de terceros a través de Mediación de AdMob.

En esta guía se describe cómo utilizar la suite de pruebas de mediación de AdMob en aplicaciones para Android. Lo primero que debes hacer es integrar la herramienta en tu aplicación.

Requisitos previos

  • SDK de Android 4.0 (nivel de API 14) o posterior

  • Servicios de Google Play 9.8.0 o posterior

Instalación

Usar Gradle

Las siguientes dependencias son necesarias; cópialas en el archivo build.gradle de tus aplicaciones:

dependencies {
    // You should already have the ads dependency in your app.
    implementation 'com.google.android.gms:play-services-ads:17.2.0'
    implementation 'com.google.android.ads:mediation-test-suite:0.9.5'
}

Incluye el repositorio google() en tu archivo build.gradle de nivel superior:

// Top-level build file where you can add configuration options common to all
// sub-projects/modules.

buildscript {

   repositories {
       google()
       jcenter()
   }
   dependencies {
       classpath 'com.android.tools.build:gradle:3.1.1'

       // NOTE: Do not place your application dependencies here; they belong
       // in the individual module build.gradle files
   }
}

allprojects {
   repositories {
       google()
       jcenter()
   }
}

Lanzar la suite de pruebas de mediación

Debes mostrar tu ID de aplicación de AdMob a la suite de pruebas de mediación. Encontrarás dicho ID en la interfaz de AdMob.

MediationTestSuite.launch(MainActivity.this, "Your application ID");

La herramienta se abre con el siguiente aviso de renuncia de responsabilidad:

Marca la casilla y toca Aceptar para continuar.

A continuación, aparecerá una lista de bloques de anuncios para tu cuenta, separados en dos pestañas: una contiene los bloques de anuncios con errores y, la otra, los bloques de anuncios que funcionan.

La lista de bloques de anuncios con errores se divide entre los componentes que no están disponibles y los errores de configuración:

Cuando todas las redes de un bloque de anuncios se prueban con éxito, el bloque de anuncios pasará de la pestaña de errores a la otra. Si no ves ninguna lista de bloques de anuncios, significa que se ha producido un error en la llamada a la red o que no se han encontrado bloques de anuncios.

Si quieres buscar en la lista de bloques de anuncios, toca el icono de búsqueda que se encuentra en la parte superior y escribe una cadena de ID de bloque de anuncios. También puedes buscar por nombre de red o por formato de anuncio.

Para un bloque de anuncios determinado, se indica en pantalla lo siguiente:

  • Si el SDK está instalado.
  • Si el adaptador está instalado.
  • Si se han configurado correctamente las entradas de los archivos de manifiesto necesarios.

Selecciona un bloque de anuncios para pasar a su pantalla de detalles.

Detalles del bloque de anuncios

En esta pantalla se muestra la información sobre el bloque de anuncios, incluido el ID, el formato del anuncio y la cascada de mediación configurada para dicho bloque:

Fíjate en los siguientes aspectos de esta pantalla:

Resumen de la fuente del anuncio

Por cada fuente de anuncios hay indicadores que muestran si el SDK y el adaptador están instalados, si se encuentran las entradas de manifiesto necesariasy el resultado de la última prueba realizada en la sesión con esta configuración.

Ten en cuenta que en los eventos personalizados se utiliza la etiqueta Evento personalizado: tu evento personalizado. El indicador de estado del adaptador de un evento personalizado será positivo si se encuentra la clase que se ha especificado para dicho evento. Puedes cargar y ver anuncios de eventos personalizados de la misma manera que en otras redes.

Búsqueda

Al tocar el icono de búsqueda, aparece una pantalla en la que puedes buscar las fuentes de anuncios por su nombre.

Prueba en lotes

Cada fuente de anuncios puede seleccionarse para probarla en un lote; para ello, marca la casilla que se encuentra a la izquierda del nombre de dicha fuente. A continuación, aparecerá una nueva opción en la barra de navegación:

Pulsa el botón Cargar anuncios de la parte superior derecha para cargar secuencialmente los anuncios de las fuentes seleccionadas. Mientras se realiza la prueba, se muestra un indicador de progreso. Al pulsar el icono Atrás de la parte superior izquierda se borra la selección.

Cargar y mostrar anuncios

Para ver la pantalla de detalles de una fuente de anuncios, toca en la entrada correspondiente a esa fuente:

Para una fuente de anuncios determinada, se indica en pantalla lo siguiente:

  • Si el SDK está instalado.
  • Si el adaptador está instalado.
  • Si se han configurado correctamente las entradas de los archivos de manifiesto necesarios.
  • Los parámetros de la configuración se han ingresado en la consola de AdMob.

Cuando hayas instalado todos los componentes necesarios, puedes probar a cargar un anuncio. Toca Cargar anuncio para enviar una solicitud de anuncio al SDK de la fuente de anuncios. Una vez completada la solicitud, se presenta una actualización que indica si la solicitud se ha realizado correctamente o no.

Si se ha producido algún error al realizar la solicitud, comprueba los registros de la consola para saber si hay mensajes que indican que se está probando el SDK.

Si la solicitud se realiza correctamente:

  • En el caso de un anuncio de banner, el anuncio se muestra insertado.
  • En el caso de los anuncios intersticiales o bonificados, puedes mostrar el anuncio si tocas en Mostrar anuncio.

    El anuncio se abrirá en una nueva pantalla, por ejemplo:

Cuando regreses a la pantalla de detalles del bloque de anuncios, verás los resultados de la última vez que probaste el anuncio en la lista de bloques de anuncios. Las fuentes de anuncios que se cargaron correctamente pasan al final de la lista y dejan paso a las fuentes de anuncios que debes seguir probando. Ten en cuenta que estos resultados se almacenan únicamente durante la sesión.

Habilitar las pruebas en producción

De forma predeterminada, la suite de pruebas de mediación solo se ejecuta en compilaciones de depuración , de modo que los usuarios finales no puedan hacerlo por error.

Si durante la fase de producción de la aplicación necesitas ejecutar la suite de pruebas de mediación en un dispositivo, incluye el ID de AdMob de dicho dispositivo de prueba en una lista blanca antes de distribuir la compilación. Este ID se encuentra en los registros de la consola.

Si quieres incluir el dispositivo de prueba en la lista blanca, registra su ID con la suite de pruebas de mediación:

Java

MediationTestSuite.addTestDevice("33BE2250B43518CCDA7DE426D04EE231");  // An example device ID

Kotlin

MediationTestSuite.addTestDevice("33BE2250B43518CCDA7DE426D04EE231") // An example device ID

Si se incluye la suite de pruebas de mediación en una aplicación de producción, deberás configurar un gesto secreto o un menú de depuración oculto para lanzarla. Luego, podrás hacerlo en cualquier dispositivo incluido en una lista blanca en la compilación.

Configurar solicitudes de anuncios con extras de red (opcional)

Algunas redes con mediación, como Vungle, requieren u ofrecen la opción de proporcionar un paquete de extras de red personalizado para facilitar más información a las solicitudes enviadas a su red. Si fuera tu caso, puedes configurar una solicitud de anuncio para que la suite de pruebas la utilice mediante el método estáticoMediationTestSuite.setAdRequest():

Java

AdRequest requestBuilder = new AdRequest.Builder();
...
// Set your network extras for your chosen networks here.
// i.e for each network extras bundle, call
// 'requestBuilder.addNetworkExtrasBundle(<network adapter class>, <network extras bundle>)'
...
MediationTestSuite.setAdRequest(requestBuilder.build());

Kotlin

val requestBuilder = AdRequest.Builder()
...
// Set your network extras for your chosen networks here.
// i.e for each network extras bundle, call
// 'requestBuilder.addNetworkExtrasBundle(<network adapter class>, <network extras bundle>)'
...
MediationTestSuite.setAdRequest(requestBuilder.build())

Haz esto antes de lanzar la suite de pruebas de mediación.

Esto permite configurar e instanciar las solicitudes de anuncio con los elementos adicionales correspondientes, y la suite de pruebas podrá usarlos en sus solicitudes a la red con mediación.

Preguntas frecuentes

¿La renuncia de responsabilidad se muestra siempre?
Sí, lo hacemos de forma intencionada, como recordatorio de que es necesario activar el modo de prueba para las fuentes de anuncios con mediación.
¿Por qué aparece AdMob varias veces en la página de detalles del bloque de anuncios?
Si varios grupos de mediación apuntan al mismo bloque de anuncios, combinamos todos los grupos. Por ejemplo, puede que veas varias entradas de AdMob y quizá de otras fuentes de anuncios. Incluso dentro del mismo grupo de mediación, es posible definir al mismo partner de mediación hasta tres veces.
¿Qué redes o fuentes de anuncios admite la suite de pruebas de mediación?
La suite de pruebas es compatible con todos los adaptadores de código abierto y versionados, así como los adaptadores de eventos personalizados. Las redes publicitarias de nuestra iniciativa de código abierto están publicadas en nuestra página de mediación.