Suite de pruebas de Mediación

Con la suite de pruebas de Mediación de los anuncios de Google para móviles, puedes comprobar si has configurado correctamente tus aplicaciones y bloques de anuncios para que se muestren anuncios de redes de terceros a través de la función de mediación. En esta guía se describe cómo utilizar la suite de pruebas de Mediación de los anuncios de Google para móviles en una aplicación iOS tras integrar la herramienta en la aplicación en cuestión.

Requisitos previos

  • Xcode 12 o posterior
  • iOS 8.0 o posterior
  • Comprobar que se ha introducido correctamente el ID de la aplicación en el archivo Info.plist

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

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, abre la suite de pruebas de la siguiente manera:

Swift


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

Objective‑C


[GoogleMobileAdsMediationTestSuite presentOnViewController:self delegate:nil];

Este delegado opcional te avisa cuando se cierra la suite de pruebas de Mediación. Para implementar la retrollamada de delegado, debes cumplir el protocolo GMTSMediationTestSuiteDelegate y utilizar el método mediationTestSuiteWasDismissed.

La herramienta muestra el siguiente aviso cuando se abre:

Para continuar, marca la casilla y selecciona Aceptar.

A continuación, aparecerá una lista de bloques de anuncios de tu cuenta divida en dos pestañas: Bloques de anuncios con errores y Bloques de anuncios en funcionamiento.

Registrar un dispositivo de prueba

Si tu dispositivo todavía no está registrado en la interfaz de AdMob como dispositivo de prueba, aparecerá un mensaje donde se te preguntará si quieres hacerlo:

Después de hacer el registro, se producirán una serie de cambios en la suite de pruebas de Mediación:

  • Podrás ver los nombres de los bloques de anuncios en lugar de sus ID en la interfaz de usuario de la suite de pruebas.
  • Podrás hacer búsquedas tanto por nombre como por ID de bloque de anuncios en la pantalla Datos del bloque de anuncios.
  • Se habilitará tu dispositivo para que reciba anuncios de prueba de AdMob.

Al hacer clic en Registrar dispositivo, se abre la página para registrar dispositivos de prueba en la interfaz de AdMob, con la plataforma y el ID del dispositivo rellenados previamente a partir de los datos de la suite de pruebas de Mediación. Añade un nombre para tu dispositivo de prueba y haz clic en Guardar para registrar el dispositivo. Consulta el artículo Configurar un dispositivo de prueba para acceder a más directrices.

Por lo general, el registro del dispositivo se hace efectivo en la suite de pruebas de Mediación en 15 minutos, pero el proceso puede tardar hasta 24 horas. Si quieres ver los cambios, cierra y vuelve a abrir la suite de pruebas de Mediación.

Debes iniciar sesión en tu cuenta de AdMob para acceder a la página de registro de dispositivos de prueba. Si no tienes acceso a la cuenta, pero quieres añadir el dispositivo mediante este método, haz clic en el enlace. Después, desde el navegador que se abrirá, comparte la URL con un propietario de la cuenta. A continuación, el propietario podrá acceder al enlace y registrar tu dispositivo en la cuenta.

Si no quieres registrar tu dispositivo como dispositivo de prueba en este momento, pulsa Cerrar.

Bloques de anuncios con errores

La lista Bloques de anuncios con errores se divide entre aquellos en los que faltan componentes y los que tienen errores de configuración:

Cuando se comprueba que funcionan todas las redes de un bloque de anuncios, el bloque pasa de la pestaña de errores a la de bloques de anuncios en funcionamiento. Si no aparece ninguna 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 esta pantalla se muestran advertencias de cada bloque de anuncios 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, en la pantalla también se mostrará el estado general de los resultados de las pruebas de todas las fuentes de anuncios.

Selecciona un bloque de anuncios para ver la pantalla Datos del bloque de anuncios.

Datos del bloque de anuncios

En esta pantalla se muestra información sobre el ad unit, que incluye el ID del ad unit, el formato de anuncio y la cascada de mediación configurada para el ad unit:

Fíjate en los siguientes aspectos de esta pantalla:

Resumen de la fuente de anuncios

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 esta configuración.

En el caso de los eventos personalizados, se utiliza la etiqueta de evento personalizado custom event. El indicador de estado del adaptador de un evento personalizado será positivo si se encuentra la clase que se ha especificado para ese evento. Puedes cargar y ver anuncios de eventos personalizados de la misma manera que en otras redes.

Buscar

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

Pruebas en lotes

Todas las fuentes de anuncios pueden testarse 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 para 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 para volver 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, en la pantalla se indica 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 testar la carga de un anuncio. Toca la opción para cargar un 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, busca en los registros de la consola mensajes del SDK que se está testando.

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 seleccionas Mostrar anuncio.
  • En el caso de los anuncios nativos, los recursos devueltos se muestran insertados.

    El anuncio se abrirá en una nueva pantalla, como en el siguiente ejemplo:

Cuando regreses a la pantalla Datos del bloque de anuncios, verás los resultados de la última vez que testaste el anuncio en la pantalla de la lista del ad unit. Las fuentes de anuncios que se han cargado correctamente pasan al final de la lista y dejan paso a las fuentes de anuncios que debes seguir testando.

Partners de Puja Abierta

Consulta la guía para verificar la configuración de Puja Abierta si quieres obtener más información sobre cómo testar esta función.

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 fase de producción, debes registrarlo como dispositivo de prueba mediante 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 ejecutar la suite. Luego, podrás iniciarla en cualquier dispositivo incluido en la lista de permitidos de la compilación.

Configurar solicitudes de anuncios con extras de red (opcional)

Algunas redes con mediación, como Vungle, ofrecen la opción de proporcionar un objeto de parámetros de red adicionales personalizados para facilitar más información en 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 de clase [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(\)'
...
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:\];'
...
[GoogleAdsMediationTestSuite setAdRequest:request];

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

De este modo, puedes 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
}

Registro de cambios

v2.0.0

Fecha de lanzamiento: 04/06/2021

  • Se ha añadido la compatibilidad con la versión 20 de play-services-ads. Se necesita la versión 20.0.0 (o una posterior) del SDK.
  • Se ha actualizado la dependencia play-services-ads a la versión 20.1.0.
  • Se han quitado las APIs MediationTestSuite.addTestDevice() y MediationTestSuite.getTestDevices(). Usa MobileAds.setRequestConfiguration() para configurar identificadores de dispositivos de prueba en su lugar.
  • Se ha añadido compatibilidad con las configuraciones de banner de AdColony, Vungle y IronSource.
  • Se han corregido los fallos por los que i-mobile y Tapjoy devolvían incorrectamente errores de configuración.

v1.5.0

Fecha de lanzamiento: 23/11/2020

  • Se ha añadido la API MediationTestSuite.launchForAdManager(Context context) para habilitar la compatibilidad con Ad Manager usando un ID de aplicación combinado.
  • Se ha añadido la posibilidad de registrar dispositivos de prueba para AdMob.
  • Se ha corregido el problema por el que se producía un fallo si no había ninguna asignación de bloques de anuncios de Ad Manager configurada.
  • Se han quitado las comprobaciones de archivos de manifiesto obsoletos del SDK de Vungle.
  • Se ha actualizado la dependencia play-services-ads a la versión 19.5.0.

v1.4.0

Fecha de lanzamiento: 30/07/2020

  • Se ha actualizado la dependencia play-services-ads a la versión 19.3.0.
  • Se ha solucionado el problema que había con el formato de banner o intersticial que provocaba fallos.
  • Se ha añadido la compatibilidad con Fyber Marketplace.
  • Se ha añadido la compatibilidad con banners de Chartboost.
  • Se ha solucionado el problema con la detección de entradas de archivos de manifiesto de MoPub.

v1.3.0

Fecha de lanzamiento: 27/02/2020

  • Se ha añadido la compatibilidad con la carga de anuncios de Puja Abierta.
  • Se han corregido los requisitos de archivo de manifiesto de InMobi y AppLovin.

v1.2.2

Fecha de lanzamiento: 10/12/2019

  • Se ha corregido el error del archivo de ProGuard que producía fallos en Unity.

v1.2.1

Release Date: 11/11/2019

  • Se ha actualizado la dependencia de anuncios a la versión 18.3.0.

v1.2.0

Fecha de lanzamiento: 11/09/2019

  • Se ha actualizado para que sea compatible inicialmente con Puja Abierta (se pueden comprobar las configuraciones, pero no es posible cargar anuncios).
  • Se ha añadido compatibilidad con las redes de i-mobile y Verizon Media.

v1.1.1

Fecha de lanzamiento: 28/06/2019

  • Se ha actualizado la dependencia FlexboxLayout para que sea compatible con AndroidX.

v1.1.0

Fecha de lanzamiento: 27/06/2019

  • Se ha actualizado para que sea compatible con AndroidX.
  • Se han actualizado los adaptadores y las redes, así como las configuraciones asociadas (por ejemplo, los requisitos de entradas de manifiesto).
  • Se ha añadido la API MediationTestSuite.launch(Context) que utiliza el ID de AdMob que figura en AndroidManifest.xml.

v1.0.0

Fecha de lanzamiento: 22/04/2019

  • Nueva versión para su lanzamiento general.

v0.9.5

Fecha de lanzamiento: 22/02/2019

  • Se ha corregido un error que se producía al proporcionar el archivo JSON en el parámetro de configuración de una red publicitaria o evento personalizado.

v0.9.4

Fecha de lanzamiento: 11/02/2019

  • Se han actualizado las dependencias, incluida la actualización del SDK de anuncios de Google para móviles a la versión 17.1.3.
  • Se ha corregido un fallo relacionado con permisos erróneos del archivo de manifiesto del SDK de AdColony.
  • Se ha corregido un error que se producía cuando el contexto de la carga de anuncios no tenía actividad en la API 28.

v0.9.3

Fecha de lanzamiento: 07/02/2019

  • Se ha corregido el problema de que la suite de pruebas de Mediación cargaba anuncios de otras redes mientras probaba una.
  • Se ha añadido la vista de recursos nativos cuando se cargan anuncios de este tipo.
  • Se ha añadido la compatibilidad con bloques de anuncios de banner e intersticiales antiguos.
  • Se han añadido protecciones contra el lanzamiento de la suite de pruebas en producción. Ya no se lanzará en compilaciones de lanzamiento, a menos que se ejecute en dispositivos cuyo ID de AdMob se haya añadido a la lista de permitidos mediante MediationTestSuite.addTestDevice(String deviceHash).
  • Se ha añadido la localización de la suite de pruebas a los idiomas chino simplificado, coreano, japonés y vietnamita.

v0.9.2

Fecha de lanzamiento: 03/10/2018

  • Se ha corregido un error por el que los intersticiales de Facebook tenían un parámetro "ID de cuenta" adicional.
  • Se ha corregido un error de permisos incorrectos para las versiones 5.x del SDK de Vungle.
  • Se han corregido errores de las versiones de Android inferiores a la 21.
  • Se ha corregido un error de carga de anuncios que se producía cuando el adaptador de mediación requería contexto de actividad.

v0.9.1

Fecha de lanzamiento: 20/09/2018

  • Se ha actualizado para añadir compatibilidad con las versiones 6.x del SDK de Vungle.
  • Se ha corregido un problema por el que se producía un fallo al compilar con ProGuard.
  • Se ha añadido compatibilidad con Java 7.

v0.9.0

Fecha de lanzamiento: 07/08/2018

  • Versión beta abierta con una interfaz de usuario actualizada.
  • Se ha añadido la posibilidad de hacer pruebas por lotes.

v0.2

Fecha de lanzamiento: 20/03/2018

  • Se ha añadido la compatibilidad con editores que usan grupos de mediación con la nueva interfaz de AdMob.
  • Se ha actualizado la interfaz.
  • Se ha añadido compatibilidad con las siguientes redes publicitarias: Nend, myTarget, maio y IronSource.

v0.1.1

Fecha de lanzamiento: 11/12/2017

  • Se ha corregido un problema que, en ocasiones, daba lugar a NPEs al cargar la configuración de la aplicación.

v0.1

Fecha de lanzamiento: 10/11/2017

  • Lanzamiento inicial. Se lanza, se descargan las configuraciones de mediación, se comprueban los adaptadores, el SDK y la corrección del archivo de manifiesto, y se cargan y muestran anuncios de redes publicitarias de terceros a través de sus adaptadores de mediación de AdMob.