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