Inspector de anuncios

Inspector de anuncios es una superposición en las aplicaciones que permite que los dispositivos autorizados analicen las solicitudes de anuncios de prueba en tiempo real y sin salir de la aplicación móvil. Se incluye en la versión 7.68.0 (y posteriores) del SDK de anuncios de Google para móviles y puede habilitarse sin necesidad de escribir código.

Si usas Inspector de anuncios con versiones del SDK de anuncios para móviles que sean anteriores a 8.5.0, puedes hacer lo siguiente:

  • Inspeccionar tus bloques de anuncios
  • Inspeccionar adaptadores de terceros
  • Comprobar si tus anuncios tienen la tasa de relleno que esperas
  • Identificar errores y consultar información sobre cómo resolverlos
  • Ver los detalles de mediación de cada red publicitaria por solicitud
  • Hacer pruebas con fuentes publicitarias de mediación concretas de terceros
  • Comprobar que se ha configurado correctamente cada bloque de anuncios para la mediación en cascada
  • Probar las integraciones de eventos personalizados

Con la versión 8.5.0 (y posteriores) del SDK de anuncios de Google para móviles, también puedes hacer lo siguiente:

  • Consultar detalles de las pujas de cada red publicitaria por solicitud
  • Consultar detalles de las pujas y la mediación en cascada de cada red publicitaria por solicitud
  • Hacer pruebas con fuentes publicitarias de terceros que envíen pujas o se usen en la mediación en cascada
  • Comprobar que se ha configurado correctamente cada bloque de anuncios para las pujas y la mediación en cascada

En esta guía se explica cómo iniciar y usar las diferentes funciones que ofrece la herramienta Inspector de anuncios.

Requisitos previos

Para usar Inspector de anuncios, debes hacer lo siguiente:

  • Hacer todo lo que se indica en la guía de introducción.

  • Usar la versión 7.68.0 (o posteriores) del SDK de anuncios de Google para móviles.

Abrir Inspector de anuncios

Esta herramienta se puede iniciar desde cualquier parte de la aplicación y hay tres formas de hacerlo:

  1. Con el gesto seleccionado en la interfaz de AdMob al registrar un dispositivo de prueba.

  2. De forma automatizada con la API proporcionada.

  3. Con el botón de inicio del menú de depuración.

Abrir con un gesto

No es necesario hacer ningún cambio en tu aplicación para iniciar Inspector de anuncios con un gesto. Solo tienes que hacer el gesto que hayas configurado en AdMob para el dispositivo de prueba en cuestión: girar dos veces la muñeca o agitar el dispositivo. Más información

Después de configurar un gesto en la interfaz de AdMob y esperar 15 minutos a que se aplique este ajuste, tu aplicación debe hacer una solicitud de anuncio para que el SDK de anuncios de Google para móviles reciba los detalles de la configuración de tu gesto. Si el gesto indicado no funciona, prueba a cargar un anuncio, reiniciar la aplicación y volver a hacer el gesto.

Abrir de forma automatizada

Inspector de anuncios también se puede iniciar de manera automatizada:

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

Esta API funciona en los dispositivos de prueba registrados de forma automatizada o en la interfaz de AdMob.

Asegúrate de que el controlador de vista transmitido a esta API es totalmente visible en la pantalla (se ha llamado a viewDidAppear:). Si el controlador de vista enviado está en proceso de mostrarse (por ejemplo, si se llama a la API anterior mediante la función viewDidLoad del controlador), Inspector de anuncios no se podrá abrir.

Consultar resultados de solicitudes de anuncios recientes por bloque de anuncios

Cuando se abre Inspector de anuncios, se muestra su pantalla principal. En ella, se incluye una lista de todos los bloques de anuncios de la interfaz de AdMob que están asociados al ID de tu aplicación y tienen configuraciones de puja o de mediación:

Los bloques de anuncios se ordenan cronológicamente con las solicitudes completadas más recientemente en primer lugar. Como se ha indicado arriba, los bloques de anuncios conocidos que no tengan solicitudes completadas aparecerán inactivos.

Te recomendamos que inicialices el SDK de anuncios de Google para móviles antes de usar Inspector de anuncios.

Ver los adaptadores disponibles

En la pestaña Adaptadores, verás una lista con todos los adaptadores de terceros asociados a las fuentes publicitarias de las configuraciones de puja o de mediación de tu aplicación, así como sus estados de inicialización. Si no se encuentra el adaptador o no se puede inicializar, consulta el artículo del Centro de Ayuda para solucionar el problema.

Además de los adaptadores de terceros compatibles, también puedes ver los adaptadores de eventos personalizados. Los eventos personalizados permiten que los editores usen una red publicitaria que AdMob no admite. Los eventos personalizados se pueden identificar en la lista de adaptadores junto con los adaptadores de terceros estándar por su nombre de clase, tal como se muestra a continuación:

Inspector de anuncios, además de proporcionar el nombre de la clase y la información del estado, también facilita las etiquetas que se asignaron a esa clase en la interfaz de AdMob.

Consultar detalles de bidding de un bloque de anuncios

Requisitos previos: tener la versión 8.5.0 o una posterior del SDK de anuncios de Google para móviles

Si es la primera vez que utilizas las pujas, consulta el artículo que contiene información general sobre este tema.

En el registro de solicitudes del SDK, puedes ver las fuentes publicitarias de bidding a las que se llama en la solicitud de anuncio. Toca un bloque de anuncios del registro de solicitudes del SDK para ver los detalles de cada fuente publicitaria en la subasta de bidding.

Toca el enlace View all bidders (Ver todos los postores) para visualizar todas las redes publicitarias de bidding que se han configurado para el bloque de anuncios. Los resultados de bidding se ordenan de manera que los elementos para los que se deben tomar medidas aparecen en la parte superior de la lista:

  • En la parte superior, aparece la red publicitaria que ha ganado la subasta.

  • A continuación se muestran las redes publicitarias que presentan problemas. Para solucionarlos, sigue estos pasos.

  • Por otro lado, se muestran las redes publicitarias que no han devuelto ningún anuncio ni han pujado. Esto puede indicar que hay problemas con una fuente publicitaria, ya que es posible que no haya enviado pujas debido a su configuración o a su sistema de toma de decisiones. Puedes consultar la guía de configuración de la fuente publicitaria o ponerte en contacto directamente con esa fuente para obtener asistencia.

  • Por último, al final de la lista aparecen redes publicitarias que perdieron la subasta de bidding.

La cascada de mediación puede colocar la fuente publicitaria que ganó la subasta de bidding en función de su valor de eCPM.

Cuando se llame a esa fuente en la cascada de mediación, será la que sirva el anuncio. Para obtener más información sobre cómo funcionan las pujas con la cascada de mediación, consulta el ejemplo 2 y el ejemplo 3 sobre fuentes publicitarias postoras y en cascada en un grupo de mediación.

Consultar detalles de la cascada de mediación de un bloque de anuncios

Toca un bloque de anuncios para ver el registro de solicitudes del SDK, en el que se ofrece información sobre la cascada de mediación hasta que las solicitudes más recientes se rellenan con un anuncio o hasta que se procesa la cascada completa sin que se muestre ningún anuncio.

Cada solicitud puede ampliarse mediante el indicador de identificación para mostrar los resultados de la cascada de mediación que se utilizó en la solicitud, así como los errores y la latencia que le corresponden a esta última.

Los mensajes de error referentes a fuentes de anuncios de terceros se envían directamente desde la fuente. Si necesitas más información, ponte en contacto con la fuente publicitaria de terceros que utilices.

Hacer pruebas en una sola fuente publicitaria

Inspector de anuncios tiene una función para restringir las solicitudes de anuncios en tu aplicación, de forma que solo se sirvan anuncios de una fuente publicitaria de bidding o que se use en la mediación en cascada. De este modo, puedes verificar si has implementado correctamente el adaptador de terceros y si la fuente sirve anuncios correctamente.

Para habilitar esta función, activa el interruptor Single ad source test (Hacer pruebas en una sola fuente publicitaria), situado en la parte inferior de la pantalla. Esto hará que se muestre el siguiente cuadro de diálogo para seleccionar fuentes publicitarias:

Para hacer pruebas con fuentes publicitarias específicas, debes inicializar el SDK de anuncios de Google para móviles.

Después, puedes seleccionar una fuente de anuncios en la que quieres hacer pruebas. Cuando hayas elegido una, se mostrará la siguiente pantalla:

El ajuste de las pruebas con una sola fuente de anuncios se aplica a las solicitudes posteriores que se hagan en la misma sesión, con excepción de los anuncios que se hayan almacenado previamente en caché y que no se hayan mostrado todavía. Te recomendamos que fuerces el reinicio de tu aplicación cuando utilices pruebas de fuentes únicas para invalidar los anuncios almacenados en caché que podrían servirse, ya que el objetivo es que la fuente de anuncios que has elegido sea la que reciba la solicitud.

Después de reiniciar la aplicación, todos los emplazamientos de bloques de anuncios intentarán mostrar un anuncio únicamente de la red seleccionada. Si abres Inspector de anuncios cuando haya en curso una prueba de una sola fuente, se mostrará la fuente de anuncios de prueba activa:

En el modo de pruebas con una única fuente publicitaria, se intentan rellenar todas las solicitudes de anuncios con la fuente seleccionada, independientemente de si se ha configurado en la puja o la mediación de los bloques de anuncios que tengan esas solicitudes. Por tanto, si la fuente publicitaria que estás utilizando en la prueba no se ha incluido en la cascada de mediación de un bloque de anuncios, aparecerá el mensaje de error "Sin rellenar".

Al hacer una prueba en una única fuente publicitaria, puedes seleccionar un bloque de anuncios para consultar el registro de solicitudes del SDK. De esta forma, puedes ver si la fuente de anuncios ha rellenado las solicitudes que se le han asignado tras habilitar la prueba. En caso de que la fuente no haya podido cargar un anuncio, aparecerá un mensaje de error con una descripción del problema.

Si has añadido varias instancias de la fuente de anuncios seleccionada a una cascada de mediación, verás cada instancia de la llamada que se hizo a esa fuente hasta que se rellenó el anuncio o se terminó de procesar la cascada sin que se rellenara.

No se pueden usar eventos personalizados en las pruebas con fuentes de anuncios.

Detener pruebas en una sola fuente publicitaria

Para detener una prueba, desactiva el interruptor:

Aparecerá un mensaje de confirmación sobre la siguiente pantalla de reinicio:

Te recomendamos que fuerces el reinicio de tu aplicación después de detener la prueba para invalidar los anuncios almacenados en caché de la fuente publicitaria que se ha testado.