Inspector de anuncios

Inspector de anuncios es una superposición en la app que permite que los dispositivos autorizados realicen de solicitudes de anuncios de prueba directamente en una aplicación para dispositivos móviles. Se puede habilitar sin necesidad de programar.

Con el inspector de anuncios, puedes hacer lo siguiente:

  • Inspeccione sus 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 Open Bidding por solicitud
  • Ver los detalles de mediación de cada red de publicidad por solicitud
  • Prueba las fuentes de anuncios de mediación en cascada o de Open Bidding de terceros individuales
  • Verifica si configuraste correctamente cada unidad de anuncios para Open Bidding mediación en cascada

Esta guía muestra cómo lanzar y utilizar las diferentes funciones del anuncio con el inspector de registros.

Requisitos previos

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

  • Usar la versión del complemento Flutter de anuncios para dispositivos móviles 1.3.0 o una versión posterior.

  • Habilitar prueba o vincular tu dispositivo a Ad Manager. El inspector de anuncios solo se inicia en dispositivos vinculados o de prueba.

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

Iniciar con el menú de depuración

No es necesario realizar cambios en su aplicación para iniciar el inspector de anuncios durante la depuración el menú Simplemente busque un anuncio publicado por su red de Ad Manager y mantenga presionado el anuncio con dos dedos para abrirlo. el menú de depuración. Luego, selecciona Abrir inspector de anuncios.

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

También puedes seleccionar Configuración del inspector de anuncios en la configuración de depuración y Elija un gesto que pueda abrir el inspector de anuncios en el futuro sin tener que ir a través del menú de depuración.

Lanzar de manera programática

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

MobileAds.instance.openAdInspector(
  (AdInspectorError? error) {
    // Error will be non-null if ad inspector closed due to an error.
  });

Esta API funciona para dispositivos de prueba registrado programáticamente.

Consulta las unidades de anuncios y soluciona problemas relacionados con ellas

Después del lanzamiento, aparecerá la pantalla principal del inspector de anuncios, que contendrá una lista de todos los anuncios unidades el dispositivo realizó solicitudes de anuncios desde que se habilitó el inspector de anuncios durante este sesión de la app. La lista también contiene unidades de anuncios con Open Bidding habilitada, ordenadas cronológicamente, con las solicitudes completadas más recientemente y aquellas con no hay solicitudes de anuncios completadas (atenuadas):

Recomendamos inicializar los anuncios de Google para celulares SDK 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, que brinda detalles sobre la la cascada de mediación hasta el momento en que se completó el anuncio (o el finaliza sin relleno) para las últimas solicitudes de anuncios.

Las solicitudes se pueden expandir con el indicador de divulgación para mostrar los resultados. de la cascada de mediación para esa solicitud, junto con cualquier error y latencia que era aplicable para esa solicitud.

En el caso de las fuentes de anuncios de terceros, los mensajes de error se envían directamente desde el 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 utilizas Open Bidding, lee la introducción a Open Bidding. Ofertas.

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 verla los detalles de cada fuente del anuncio en la bidding subasta.

Los bidding resultados se ordenan para mostrar los elementos de acció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 el pasos para solucionar problemas al final de las bidding Preguntas frecuentes.

  • Luego, están las redes de publicidad que no mostraron ningún anuncio o que no hicieron ofertas. Esta es un posible indicador de muchos problemas diferentes con la fuente del anuncio, ya que podría no tener una oferta debido a su configuración o toma de decisiones. Puedes consultar el anuncio desde la guía de configuración de la fuente Preguntas frecuentes sobre Open Bidding para obtener más información y asistencia.

  • Finalmente, en la parte inferior de la lista están las redes de publicidad que perdieron bidding .

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

Una cascada de mediación es el resultado de múltiples grupos de rendimiento que compiten por el en el mismo inventario. Puede agregar hasta diez socios de rendimiento externos a un mismo grupo de rendimiento, incluidos los socios de rendimiento de Open Bidding y la mediación para dispositivos móviles. socios de rendimiento de las aplicaciones.

Depuración avanzada de unidades de anuncios

Cuando solucionas problemas de unidades de anuncios, puede ser útil profundizar en la solicitud de anuncio. y respuesta para identificar dónde algo falla o para compartir con Google Compatibilidad para facilitar la depuración Presiona el ícono de menú en la parte superior de la cascada. y selecciona Compartir solicitud de anuncio y respuesta para exportar la solicitud de anuncio completa y respuesta. Esto te ahorra el inconveniente de tener que ejecutar seguimientos 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ú de la solicitud una cadena vacía. Esta columna proporciona detalles sobre los parámetros de ofertas de terceros que podrían tener problemas, lo que te ayudará a depurar tu app o validar que una red esté recopilar sus indicadores con éxito.

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 del anuncio en las configuraciones de licitación o mediación de tu aplicación. 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 eventos personalizados de varios factores. Los eventos personalizados te permiten Los publicadores usan redes de publicidad que Ad Manager no es compatible. Los eventos personalizados se distinguen de los eventos estándares de terceros adaptadores en la lista de adaptadores por sus nombres de clase únicos. Además de con 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 Ad Manager de Google Cloud.

En caso de que no se encuentre el adaptador o no se inicie, consulta Inspeccionar la publicación de anuncios en aplicaciones para dispositivos móviles 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 tu app, el inspector de anuncios lo admite directamente desde la pantalla de detalles de la unidad de anuncios. También puede probar varias unidades de anuncios a la vez, cargar de forma asíncrona ver sus solicitudes de anuncios de prueba 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 lo siguiente: para verificar tu experiencia del anuncio de base y validar tu 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 del inspector de anuncios. Realiza pruebas Los resultados aparecen en el registro de solicitudes del SDK debajo del encabezado Requested del inspector de anuncios.

Obtenga información sobre cómo usar el inspector de anuncios en su app

Prueba de una sola fuente del anuncio

El inspector de anuncios tiene una función para restringir la publicación de solicitudes de anuncios en tu app anuncios de un solo anuncio bidding o de mediación en cascada fuente. Así podrás verificar que implementaste correctamente la app de adaptador y de que la fuente del anuncio se publica según lo esperado.

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

Debes inicializar los anuncios de Google para celulares. SDK antes de usar la prueba de una fuente del anuncio individual.

Luego, puedes seleccionar una sola fuente del anuncio para probarla. Una vez seleccionada la fuente del anuncio, aparecerá la siguiente pantalla:

La configuración de prueba de fuente del anuncio única se aplica a todas las solicitudes de anuncios futuras que realice en en la misma sesión. Sin embargo, no se aplica a ningún anuncio previamente almacenado en caché de esa que todavía no se mostraron. Se recomienda forzar el reinicio de la app cuando se aplica una sola prueba de fuente del anuncio para invalidar cualquier anuncio almacenado en caché que en lugar de que la fuente del anuncio que eligió reciba una solicitud.

Después de reiniciar la app, todas las posiciones de las unidades de anuncios intentarán mostrar un anuncio desde el solo en la red seleccionada. Lanzamiento del inspector de anuncios cuando se realiza una prueba de una sola fuente del anuncio En estado activo, se muestra la fuente de anuncios de prueba activa:

En el modo de prueba de fuente del anuncio individual, todas las solicitudes de anuncios intentan completarse con la búsqueda fuente del anuncio, independientemente de si se configuró para establecer ofertas o mediación para la unidad de anuncios solicitada. Si la fuente del anuncio que está probando no está en la cascada de mediación de una unidad de anuncios, obtendrás el error "Sin relleno" mensaje de error.

En una prueba de fuente del anuncio individual, puedes presionar una unidad de anuncios para ver su registro de solicitudes del SDK. Esto le permite saber si la fuente del anuncio completó las solicitudes de anuncios realizadas después de esté habilitada la prueba de la fuente del anuncio individual. Si la fuente no carga un anuncio aparecerá un mensaje de error que describe el error.

Si agregaste varias instancias de la fuente del anuncio seleccionada a una mediación cascada, verás cada instancia de la llamada a la fuente del anuncio en la cascada hasta que se rellene el anuncio 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 cualquier anuncio almacenado en caché para la fuente del anuncio probada;

Copiar todos los resultados de depuración

El inspector de anuncios admite la copia de una cadena JSON que contiene información de depuración completa resultados de la herramienta, incluidos los detalles de tu Ad Manager la app, los estados de inicialización del adaptador y el 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 Anuncio copiado JSON del inspector de apps al portapapeles.