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 una aplicación de Unity. El primer paso es integrar la herramienta en la aplicación.

Requisitos previos

  • Es necesario contar con el paquete GoogleMobileAds de Unity en tu proyecto de dicha plataforma.

  • El objetivo debe ser iOS 8.0 o una versión posterior.

  • El objetivo debe ser el SDK de Android 4.0 (nivel de API 14) o una versión posterior.

  • Es necesario crear una cuenta de AdMob y registrar una aplicación.

Instalación

Descargar la suite de pruebas de mediación

Después de descargar la suite de pruebas de mediación, con el proyecto de Unity abierto, haz doble clic en el paquete de Unity e importa los archivos en tu proyecto.

Una vez hecho esto, habrás integrado GoogleMobileAdsMediationTestSuite en tu proyecto de Unity.

Lanzar la suite de pruebas de mediación

Para incluir la suite de pruebas en una secuencia de comandos, primero debes añadir las siguientes importaciones:

using GoogleMobileAdsMediationTestSuite.Api;

A continuación, llama a MediationTestSuite.Show() con tu ID de aplicación de AdMob como parámetro para lanzar la suite de pruebas. Encontrarás dicho ID en la interfaz de AdMob.

private void ShowMediationTestSuite()
{
    #if UNITY_ANDROID
    string appId = "<Your Android application ID>";
    #elif UNITY_IPHONE
    string appId = "<Your iPhone application ID>";
    #else
    string appId = "unexpected_platform";
    #endif

    MediationTestSuite.Show(appId);
}

El complemento de Unity es un envoltorio que te permite integrar y lanzar fácilmente la suite de pruebas desde el entorno de Unity. Una vez que se ejecute, tendrá el mismo aspecto que las suites de pruebas de iOS y de Android. Sigue las guías correspondientes si necesitas ayuda para moverte por la suite de pruebas.

Saber cuándo se cierra la suite de pruebas

Si quieres recibir una notificación cuando se cierre la suite de pruebas, puedes registrar un delegado para el gestor de eventos MediationTestSuite.OnMediationTestSuiteDismissed.

public void Start()
{
    MediationTestSuite.OnMediationTestSuiteDismissed += this.HandleMediationTestSuiteDismissed;
}

public void HandleMediationTestSuiteDismissed(object sender, EventArgs args)
{
    MonoBehaviour.print("HandleMediationTestSuiteDismissed event received");
}

Esto te vendría bien si, por ejemplo, quieres saber cuándo se puede reanudar un juego.

Habilitar las pruebas en la fase de producción y en compilaciones que no son de desarrollo

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

Si durante la fase de producció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. Tal ID se encuentra en los registros de la consola.

Si quieres incluir el dispositivo de prueba en la lista blanca, hazlo mediante AdRequest.Builder. Luego, configura la solicitud de anuncio para que la utilice la suite de pruebas de mediación:

MediationTestSuite.AdRequest = new AdRequest.Builder()
  .AddTestDevice("2077ef9a63d2b398840261c8221a0c9b")
  .Build();

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 objeto de extras de red personalizado para facilitar más información a las solicitudes enviadas a su red. Si es lo que necesitas, puedes configurar una solicitud de anuncio para que la suite de pruebas la utilice mediante la propiedad estática MediationTestSuite.AdRequest:

AdRequest adRequestBuilder = new AdRequest.Builder();
...
// Set your network extras for your chosen networks here.
// i.e for each network extras object, call
// 'adRequestBuilder.AddMediationExtras(<network extras>)'
...
MediationTestSuite.AdRequest = adRequestBuilder.Build();

Recuerda que debes hacerlo antes de llamar a MediationTestSuite.Show().

Esto permite configurar e instanciar las solicitudes de anuncio con los extras necesarios, y la suite de pruebas podrá usarlas en sus solicitudes a la red mediada.

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.

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.