Inspector de anuncios (Beta)

El inspector de anuncios es una superposición en la aplicación que permite que los dispositivos autorizados realicen un análisis en tiempo real de las solicitudes de anuncios de prueba directamente en una app para dispositivos móviles. Se incluye en el SDK de anuncios de Google para dispositivos móviles versión 8.10.0 y versiones posteriores, y se puede habilitar sin necesidad de programación.

Con el inspector de anuncios, puedes hacer lo siguiente:

  • Inspecciona tus unidades de anuncios
  • Verifica si tus anuncios se están completando según lo esperado
  • Identificar errores y ver detalles sobre cómo resolverlos
  • Ver los detalles de cada red de publicidad de licitación por solicitud
  • Consulta los detalles de mediación de cada red de publicidad por solicitud
  • Prueba fuentes de anuncios de mediación en cascada o ofertas de terceros individuales
  • Verifica si configuraste de forma correcta cada unidad de anuncios para la licitación y la mediación en cascada

En esta guía, se muestra cómo iniciar y usar las diferentes funciones del inspector de anuncios.

Requisitos previos

Para usar el inspector de anuncios, debes hacer lo siguiente:

  • Usa la versión 8.10.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Cómo iniciar el inspector de anuncios

El inspector de anuncios se puede iniciar desde cualquier parte de la app de las siguientes maneras:

  1. Usa el botón de inicio del menú de depuración.
  2. Usa el gesto que seleccionaste en la configuración del inspector de anuncios.
  3. De manera programática, con la API proporcionada

Cómo iniciar con el menú de depuración

No es necesario realizar cambios en tu app para iniciar el inspector de anuncios a través del menú de depuración. Solo busca un anuncio publicado por tu red de Ad Manager y mantén presionado el anuncio con dos dedos para abrir el menú de depuración. Luego, selecciona Abrir inspector de anuncios.

Si no vinculaste tu dispositivo, es posible que se te solicite que accedas a tu cuenta de Ad Manager.

También puedes seleccionar Configuración del inspector de anuncios en la configuración de depuración y elegir un gesto que pueda abrir el inspector de anuncios en el futuro sin tener que pasar por el menú de depuración.

Cómo iniciar de manera programática

El inspector de anuncios también se puede iniciar de forma programática:

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[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 para dispositivos de prueba registrados de forma programática.

Asegúrate de que el controlador de vista que se pasó a esta API ya esté completamente visible en la pantalla (se llamó a viewDidAppear:). Si el controlador de vista que se pasó está en proceso de mostrarse, como cuando se llama a la API en la función viewDidLoad del controlador de vista, la presentación del inspector de anuncios falla.

Cómo ver unidades de anuncios y solucionar problemas

Una vez que se lance, aparecerá la pantalla principal del inspector de anuncios, que contendrá una lista de todas las unidades de anuncios para las que el dispositivo realizó solicitudes de anuncios desde que se habilitó el inspector durante esta sesión de la app. La lista también contiene unidades de anuncios con ofertas habilitadas, ordenadas cronológicamente, primero las solicitudes completadas más recientes y, luego, las que no tienen solicitudes de anuncios completadas (atenuadas):

Te recomendamos inicializar el SDK de anuncios de Google para dispositivos móviles antes de usar el Inspector de anuncios.

Cómo ver los detalles de la cascada de mediación de una unidad de anuncios

Presiona una unidad de anuncios para ver su registro de solicitudes del SDK, el cual proporciona detalles sobre la cascada de mediación hasta el momento en que se completó el anuncio (o la cascada finalizó sin un complemento) para las solicitudes de anuncios más recientes.

Cada solicitud se puede expandir con el indicador de divulgación para mostrar los resultados de la cascada de mediación de esa solicitud, junto con cualquier error y latencia que se haya aplicado a esa solicitud.

En el caso de las fuentes de anuncios de terceros, los mensajes de error provienen directamente de la fuente de anuncios. Si necesitas más información, consulta a tu fuente de anuncios de terceros.

Cómo ver los detalles de las ofertas de una unidad de anuncios

Si es la primera vez que realizas una oferta, lee la introducción a Open Bidding.

En el registro de solicitudes del SDK, puedes ver las fuentes de anuncios de ofertas a las que se llama en la solicitud de anuncio. Presiona una unidad de anuncios en el registro de solicitudes del SDK para ver los detalles de cada fuente de anuncios en la subasta de ofertas.

Los resultados de las ofertas se ordenan para acercar los elementos prácticos a la parte superior de la lista:

  • En la parte superior, se muestra la red de publicidad que ganó la subasta.

  • A continuación, se muestran las redes de publicidad con problemas. Puedes seguir los pasos para solucionar problemas que se encuentran al final de las preguntas frecuentes sobre las ofertas.

  • Luego, están las redes de publicidad que no mostraron anuncios o que no realizaron ofertas. Este es un posible indicador de muchos problemas diferentes con la fuente de anuncios, ya que es posible que no tenga una oferta debido a su configuración o toma de decisiones. Para obtener más asistencia, puedes consultar la guía de configuración de la fuente de anuncios o las Preguntas frecuentes sobre Open Bidding.

  • Por último, en la parte inferior de la lista se encuentran las redes de publicidad que perdieron la subasta de licitación.

La cascada de mediación puede colocar la fuente de anuncios que ganó la subasta de ofertas según su valor de eCPM.

Una cascada de mediación es el resultado de varios grupos de rendimiento que compiten por el mismo inventario. Puedes agregar hasta diez socios de rendimiento externos a un solo grupo de rendimiento, incluidos los socios de rendimiento de ofertas y los socios de rendimiento de mediación para aplicaciones para dispositivos móviles.

Depuración avanzada de unidades de anuncios

Cuando solucionas problemas de unidades de anuncios, puede ser útil profundizar en la solicitud de anuncio y la respuesta para identificar dónde algo falla, o compartir con la Atención al cliente de Google para ayudar en la depuración. Presiona el ícono de menú en la parte superior de la cadena de cascada y selecciona Share ad request and response para exportar la solicitud y la respuesta del anuncio completas. Esto te ahorra la molestia de tener que ejecutar registros de red en tu propia app.

Además, puedes ver los parámetros de ofertas de terceros decodificados si presionas la opción Parámetro de ofertas de terceros en el mismo menú que la cadena de solicitud. Esto proporciona detalles sobre qué parámetros de ofertas de terceros podrían tener problemas, lo que te ayudará a depurar tu app o a validar que una red esté recopilando sus indicadores correctamente.

Cómo ver los adaptadores disponibles

Haz clic en la pestaña Adaptadores para ver una lista de todos los adaptadores de terceros asociados con las fuentes de anuncios en las configuraciones de ofertas o mediación de tu app. Luego, expande las tarjetas para ver sus estados de inicialización y versiones de SDK. Además de los adaptadores de terceros compatibles, también puedes ver los adaptadores de eventos personalizados. Los eventos personalizados permiten a los publicadores usar redes de publicidad que Ad Manager no admite. Los eventos personalizados se pueden distinguir de los adaptadores de terceros estándar en la lista de adaptadores por sus nombres de clase únicos. Además de proporcionar el nombre de la clase y la información de estado, el inspector de anuncios también muestra las etiquetas asignadas a esos eventos personalizados en la interfaz web de Ad Manager.

En caso de que no se encuentre el adaptador o no se inicialice, consulta Cómo inspeccionar la publicación de anuncios en apps para dispositivos móviles para obtener más información.

Prueba tus unidades de anuncios

Si deseas probar tu unidad de anuncios sin tener que navegar a ella en la IU de tu app, el inspector de anuncios admite esta acción directamente desde la pantalla de detalles de la unidad de anuncios. Además, puedes probar varias unidades de anuncios a la vez, cargar y ver de forma asíncrona tus solicitudes de anuncios de prueba, y hasta realizar pruebas de fuentes de anuncios individuales.

Pruebas de anuncios

Las pruebas de anuncios del inspector de anuncios que se describen en esta sección son una gran herramienta para verificar tu experiencia de anuncios básica y validar la configuración de mediación cuando se usan con pruebas de fuentes de anuncios únicas.

Cuando tengas todo listo para probar tu unidad de anuncios, presiona el botón Solicitar anuncio de prueba en la parte superior de la pantalla del inspector de anuncios para activar la prueba del inspector de anuncios. Luego, los resultados de la prueba aparecen en el registro de solicitudes del SDK debajo del encabezado Solicitado desde el inspector de anuncios.

Más información para usar el inspector de anuncios en tu app

Prueba de fuente de anuncios única

El inspector de anuncios tiene una función para restringir las solicitudes de anuncios de tu app de modo que solo publiquen anuncios de una única fuente de anuncios de licitación o mediación en cascada. Esto te permite verificar si implementaste correctamente el adaptador de terceros y que la fuente de anuncios se publica según lo esperado.

Para habilitar esta función, activa el interruptor Prueba de fuente del anuncio única en la parte inferior de la pantalla. Se mostrará el siguiente diálogo de selección de fuente del anuncio:

Debes inicializar el SDK de anuncios de Google para dispositivos móviles antes de usar la prueba para fuentes de anuncios individuales.

Luego, puedes seleccionar una sola fuente del anuncio para probarla. Una vez que se selecciona una fuente del anuncio, aparece la siguiente pantalla:

La configuración de la prueba de una fuente del anuncio individual se aplica a todas las solicitudes de anuncios futuras que realices en la misma sesión. Sin embargo, no se aplica a los anuncios almacenados en caché previamente en esa sesión que aún no se muestran. Se recomienda forzar el reinicio de la app cuando se aplica una prueba de fuente del anuncio individual para invalidar los anuncios almacenados en caché que se podrían publicar en lugar de que la fuente del anuncio elegida reciba una solicitud.

Después de reiniciar la app, todas las posiciones de unidades de anuncios intentan mostrar un anuncio solo de la red seleccionada. Si inicias el inspector de anuncios cuando hay una sola prueba de fuente de anuncios activa, se muestra la fuente de anuncios de prueba activa:

En el modo de prueba de una fuente del anuncio individual, todas las solicitudes de anuncios intentan completarse con la fuente del anuncio seleccionada, independientemente de si esa fuente del anuncio se configuró para las ofertas o la mediación de la unidad de anuncios solicitada. Si la fuente de anuncios que estás probando no se encuentra en la cascada de mediación de una unidad de anuncios, recibirás un mensaje de error de espacio "sin rellenar".

En la prueba de una fuente del anuncio individual, puedes presionar una unidad de anuncios para ver su registro de solicitudes del SDK. Esto te permite saber si la fuente del anuncio completó las solicitudes de anuncios que se hicieron después de que se habilitó la prueba de la fuente del anuncio individual. Si la fuente de anuncios no pudo cargar un anuncio, aparecerá un mensaje de error que lo describirá.

Si agregaste varias instancias de la fuente de anuncios seleccionada a una cascada de mediación, verías cada instancia de la llamada a la fuente de anuncios en la cascada hasta que se complete el anuncio o la cascada finalice sin completarse.

Cómo detener una prueba de fuente del anuncio individual

Para detener la prueba, desactiva el interruptor:

A continuación, aparecerá un mensaje de confirmación en la siguiente pantalla de reinicio:

Te recomendamos que fuerces el reinicio de la app después de detener la prueba para invalidar los anuncios almacenados en caché de la fuente de anuncios que se probó.

Cómo copiar todos los resultados de la depuración

El Inspector de anuncios admite la copia de una cadena JSON que contiene todos los resultados de depuración de la herramienta, incluidos los detalles de tu app de Ad Manager, los estados de inicialización del adaptador y los resultados de las pruebas de todas las unidades de anuncios.

Para ello, presiona el ícono de la app siete veces hasta que veas el mensaje Copiado del inspector de anuncios en el portapapeles.