Suite de pruebas de mediación

A través de la suite de pruebas de Mediación de AdMob puedes comprobar si has configurado correctamente las aplicaciones y los bloques de anuncios para mostrar anuncios de redes de terceros.

En esta guía se describe cómo usar la suite de pruebas de Mediación de AdMob en una aplicación iOS. El primer paso es integrar la herramienta en la aplicación en cuestión.

Requisitos previos

  • Xcode 11 o posterior

  • iOS 8.0 o posterior

Instalación

Para instalar la suite de pruebas de mediación, utiliza CocoaPods. Para ello, solo tienes que añadir la siguiente línea a tu Podfile:

pod 'GoogleMobileAdsMediationTestSuite'

De esta forma, configuras la suite de pruebas, así como las dependencias de Material Components necesarias. Ejecuta pod install para completar la instalación.

Ejecutar la suite de pruebas de Mediación

Configuración

Para mostrar la herramienta, primero importa el framework:

Swift

import GoogleMobileAdsMediationTestSuite

Objective‑C

@import GoogleMobileAdsMediationTestSuite;

A continuación, una vez que haya aparecido la vista, muestra la suite de pruebas de la siguiente manera:

Swift

GoogleMobileAdsMediationTestSuite.present(on:self, delegate:nil)

Objective‑C

[GoogleMobileAdsMediationTestSuite presentOnViewController:self delegate:nil];

Ten en cuenta que esto requiere que hayas introducido correctamente el ID de tu aplicación AdMob en el archivo Info.plist.

Recuerda también que el delegado es opcional y se proporciona solo si quieres que se te notifique cuando se cierre la herramienta. Para implementar la retrollamada de delegado, debes cumplir el protocolo GMTSMediationTestSuiteDelegate y utilizar el método mediationTestSuiteWasDismissed.

Ejecutar la suite de pruebas

La herramienta se abre y muestra 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 se comprueba que funcionan todas las redes de un bloque de anuncios, el bloque se pasa de la pestaña de errores a la otra. Si no ves una lista de bloques de anuncios, significa que se ha producido un error en la llamada a la red o que no se ha encontrado ningún bloque de anuncios.

Si quieres hacer una búsqueda en la lista de bloques de anuncios, selecciona 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.

En cada bloque de anuncios, esta pantalla muestra advertencias si:

  • No se ha instalado un SDK de fuente de anuncios.
  • No se ha instalado un adaptador de fuente de anuncios.

Si se pueden hacer pruebas, la pantalla también mostrará el estado general de los resultados de las pruebas de todas las fuentes de anuncios.

Selecciona un bloque de anuncios para ver su pantalla de detalles.

Detalles del bloque de anuncios

En esta pantalla se muestra la información sobre el bloque de anuncios, que incluye 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

En cada fuente de anuncios, hay indicadores que muestran si el SDK y el adaptador están instalados y el resultado de la última prueba realizada en la sesión con estos ajustes.

Ten en cuenta que en los eventos personalizados se utiliza la etiqueta Evento personalizado: evento personalizado. El indicador de estado del adaptador de un evento personalizado será positivo si se encuentra la clase que has 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 por 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, selecciona la entrada correspondiente a esa fuente:

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

  • Si está instalado el SDK y, si está disponible, su versión.
  • Si está instalado el adaptador y, si está disponible, su versión.
  • El estado de inicialización del adaptador, si está disponible.
  • Los parámetros de configuración que se han introducido 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 indica si la operación 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 no se conservan de una sesión a otra.

Habilitar las pruebas en producción

De forma predeterminada, la suite de pruebas de Mediación solo se ejecuta en versiones de desarrollo, ad hoc y empresariales, para que los usuarios finales no puedan ejecutarla por error.

Si necesitas ejecutar la suite de pruebas de Mediación en un dispositivo una vez que tu aplicación esté en producción, deberás registrar tu dispositivo como un dispositivo de prueba con el SDK.

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 iniciarla. Luego, podrás hacerlo en cualquier dispositivo incluido en la lista blanca de la compilación.

Configurar solicitudes de anuncios con parámetros de red adicionales (opcional)

Algunas redes con mediación, como Vungle, requieren u ofrecen la opción de proporcionar un objeto de parámetros de red adicionales personalizados 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 el método estático [GoogleAdsMediationTestSuite setAdRequest:]:

Swift

let request = GADRequest()
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras object, call
// 'request.register(<network extras>)'
...
GoogleAdsMediationTestSuite.setAdRequest(request);

Objective‑C

GADRequest request = [GADRequest request];
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras object, call
// '[request registerAdNetworkExtras:<network extras>];'
...
[GoogleAdsMediationTestSuite setAdRequest:request];

Haz esto antes de iniciar la suite de pruebas de Mediación.

Esto permite crear una instancia y configurar una solicitud de anuncio con los parámetros adicionales necesarios, y la suite de pruebas podrá usarlos en su solicitud a la red con mediación.

Configuración avanzada de CocoaPods (opcional, solo para depuraciones)

Si solo quieres incluir el grupo de anuncios en la versión de depuración de tu aplicación, especifica en tu Podfile que dicho grupo de anuncios solo se incluya en la configuración de compilación de Debug. También debes proteger cualquier código que llame a la herramienta mediante sentencias #ifdef DEBUG o similares.

Para incluir el pod únicamente en la configuración de depuración, incluye la siguiente línea:

pod 'GoogleMobileAdsMediationTestSuite', :configurations => ['Debug'], :path => '/path/to/GoogleMobileAdsMediationTestSuite/'

Encapsula mediante #ifdef DEBUG todas las referencias al framework y sus clases:

Swift

import UIKit
#if DEBUG
import GoogleMobileAdsMediationTestSuite
#endif
import GoogleMobileAds

let APP_ID = "ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
    }

  @IBAction func presentMediationController(_ sender: AnyObject) {
      #if DEBUG
        GoogleMobileAdsMediationTestSuite.present(withAppId:APP_ID, on:self, delegate:nil)
      #endif
    }

Objective‑C

#import "ViewController.h"
#ifdef DEBUG
@import GoogleMobileAdsMediationTestSuite;
#endif
#import <GoogleMobileAds/GoogleMobileAds.h>

static NSString *APP_ID = @"ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy";

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
}

- (IBAction)presentMediationController:(id)sender {
#ifdef DEBUG
    [GoogleMobileAdsMediationTestSuite presentWithAppId:APP_ID
                                       onViewController:self
                                               delegate:nil];
  }
#endif
}

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 en uno. 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 todas las versiones de adaptadores, así como con los adaptadores de eventos personalizados. Si quieres consultar las redes publicitarias de nuestra iniciativa de código abierto, ve a nuestra página sobre la mediación.