Inspector de anuncios

Inspector de anuncios es una superposición en la app que permite que los dispositivos autorizados realicen análisis en tiempo real de las solicitudes de anuncios de prueba directamente dentro de una app para dispositivos móviles. Se puede habilitar sin necesidad de programar.

En el caso de los anuncios para dispositivos móviles Unity 7.0.0 y versiones posteriores, puedes hacer lo siguiente:

  • Inspeccione sus unidades de anuncios
  • Inspecciona tus adaptadores de terceros
  • 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 licitación y de mediación en cascada juntos para cada red de publicidad por solicitud
  • Prueba las fuentes de anuncios de mediación y licitación de terceros individuales
  • Verifica si configuraste de forma correcta cada unidad de anuncios para la licitación y la mediación en cascada

  • Cómo probar integraciones de eventos personalizados

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:

  • Utiliza la versión del complemento Unity de anuncios para dispositivos móviles 7.0.0 o una versión posterior.

Lanzar el inspector de anuncios

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

  1. Usa el gesto seleccionado en la IU de AdMob cuando registres un dispositivo de prueba.
  2. De manera programática con la API proporcionada
  3. Usa el botón de inicio del menú de depuración.

Cómo iniciar el dispositivo con gestos

No se necesitan cambios en tu app para iniciar el inspector de anuncios con un gesto. Solo debes realizar el gesto (girar doble o sacudir) que configuraste en AdMob para ese dispositivo de prueba. Más información

Después de configurar un gesto en la IU de AdMob (y esperar 15 minutos para que se propague), tu app debe realizar una solicitud de anuncio al SDK de anuncios de Google para dispositivos móviles para obtener información sobre la configuración de gestos. Si el gesto especificado no funciona, intenta cargar un anuncio, reiniciar la app y volver a probar el gesto.

Lanzar de manera programática

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

public void OnButtonClick() {
  MobileAds.OpenAdInspector(error => {
    // Error will be set if there was an issue and the inspector was not displayed.
  });
}

Esta API funciona para dispositivos de prueba registrados de manera programática o en la IU de AdMob.

Consulta las unidades de anuncios y soluciona problemas relacionados con ellas

Una vez iniciado, aparecerá la pantalla principal del inspector de anuncios, que contendrá una lista de todas las unidades de anunciosde la IU de AdMob asociada con el ID de tu app de AdMob que tengan configuraciones de licitación o mediación:

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

Consulta 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, en el que se proporcionan detalles sobre la cascada de mediación hasta el momento en que se completó el anuncio (o la cascada finalizó sin relleno) para las solicitudes de anuncios más recientes.

Las solicitudes se pueden 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 apliquen a ella.

En el caso de las fuentes de anuncios de terceros, los mensajes de error se envían directamente desde la fuente del anuncio. Si necesitas más información, consulta a tu fuente de anuncios de terceros.

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

Si es la primera vez que realizas ofertas, consulta la descripción general.

En el registro de solicitudes del SDK, puedes ver las bidding fuentes de anuncios 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 del anuncio en la subasta de bidding .

Los resultados de bidding se ordenan para que los elementos accionables estén más cerca de la parte superior de la lista:

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

  • A continuación, están las redes de publicidad con problemas. Puedes seguir los pasos para solucionar problemas.

  • Luego, están las redes de publicidad que no mostraron ningún anuncio o que no hicieron ofertas. Este es un posible indicador de muchos problemas diferentes con la fuente del anuncio, ya que podría no tener ofertas debido a su configuración o toma de decisiones. Puedes consultar la guía de configuración de la fuente del anuncio o comunicarte con la fuente del anuncio directamente para obtener asistencia.

  • Por último, en la parte inferior de la lista, se encuentran las redes de publicidad que perdieron la subastabidding .

La cascada de mediación puede colocar la fuente del anuncio que ganó la subastabidding según su valor de eCPM.

Cuando se llama a una fuente del anuncio en la cascada de mediación, esta puede publicar anuncios. Para obtener más información sobre cómo funcionan las licitaciones con la cascada de mediación, consulta el ejemplo 2 y el ejemplo 3 de las fuentes de anuncios de licitación y cascada en un grupo de mediación.

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 hay errores, 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 Compartir solicitud de anuncio y respuesta para exportar la solicitud de anuncio y la respuesta 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 ayuda a depurar tu app o validar que una red recopile sus indicadores correctamente.

Android
iOS

Ver 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 licitación o mediación de tu app. Luego, expande las tarjetas para ver sus estados de inicialización y las versiones del SDK. Además de los adaptadores de terceros compatibles, también puedes ver los adaptadores de eventos personalizados. Los eventos personalizados permiten a los editores usar redes de publicidad AdMob no compatibles. 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 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 deAdMob .

En caso de que no se encuentre el adaptador o no se inicialice, consulta Cómo solucionar problemas detectados con el inspector de anuncios para obtener más información.

Android
iOS

Prueba tus unidades de anuncios

Si quieres probar tu unidad de anuncios sin tener que navegar a ella en la IU de tu app, el inspector de anuncios lo admite 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 tus solicitudes de anuncios de prueba de forma asíncrona, y hasta realizar pruebas de fuentes del anuncio individuales.

Pruebas de anuncios

Las pruebas de anuncios del inspector de anuncios que se describen en esta sección son una excelente herramienta para verificar tu experiencia de anuncios de base y validar la configuración de mediación cuando se usa con pruebas de fuentes del anuncio individuales.

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. Luego, los resultados de la prueba aparecen en el registro de solicitudes del SDK debajo del encabezado Solicitado al inspector de anuncios.

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

Prueba de una sola fuente del anuncio

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 mediación en cascada bidding o de mediación en cascada. Esto te permite verificar que 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:

Android
iOS

Debes inicializar el SDK de anuncios de Google para dispositivos móviles antes de poder usar la prueba de 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 fuente del anuncio única se aplica a todas las solicitudes de anuncios futuras que realice en la misma sesión. Sin embargo, no se aplica a ningún anuncio almacenado en caché previamente en esa sesión que aún no se mostró. Se recomienda forzar el reinicio de la app cuando apliques una sola prueba de fuente del anuncio para invalidar cualquier anuncio almacenado en caché que se pueda publicar en lugar de que la fuente del anuncio que elegiste 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 una sola prueba de fuente del anuncio está activa, se mostrará la fuente del anuncio de prueba activa:

En el modo de prueba de fuente del anuncio única, 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 para la unidad de anuncios solicitada. Si la fuente del anuncio que estás probando no está en la cascada de mediación de una unidad de anuncios, verás el mensaje de error "Sin relleno".

En una prueba de 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 realizadas después de que se habilitó la prueba de una sola fuente del anuncio. Si la fuente del anuncio no pudo cargar un anuncio, aparecerá un mensaje de error que describe el error.

Si agregaste varias instancias de la fuente de anuncios seleccionada a una cascada de mediación, verás cada instancia de la llamada a la fuente del anuncio en esa cascada hasta que el anuncio se rellene o la cascada finalice sin relleno.

Cómo detener una sola prueba de fuente del anuncio

Para detener la prueba, desactiva el interruptor:

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

Recomendamos forzar 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ó.

Copiar todos los resultados de depuración

El inspector de anuncios admite la copia de una cadena JSON que contiene resultados de depuración completos de la herramienta, incluidos los detalles de tu appAdMob , 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.