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 display 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 integrando la herramienta en dicha aplicación.

Requisitos previos

  • Usar Xcode 11 o posterior
  • Apuntar a iOS 8.0 o posterior
  • Crear una cuenta de Ad Manager y registrar una aplicación
  • Comprobar que se ha introducido correctamente el ID de la aplicación en el archivo

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];

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 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 de tu cuenta divida en dos pestañas: Bloques de anuncios con errores y Bloques de anuncios en funcionamiento.

La lista de bloques de anuncios con errores se divide en 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 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 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 , que incluye el ID del , el formato de anuncio y la cascada de mediación configurada para el :

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 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

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 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 "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 .

Cuando hayas instalado todos los componentes necesarios, puedes probar a cargar 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, 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 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 probaste el anuncio en la pantalla de la lista del . 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 probando.

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 probar 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 ejecutarla en cualquier dispositivo incluido en la lista de permitidos de la compilación.

Configurar solicitudes de anuncios con parámetros de red adicionales (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 = ()
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras object, call
// 'request.register(\)'
...
GoogleAdsMediationTestSuite.setAdRequest(request);

Objective‑C

 request = [ 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']

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
}