Si utilizas el inspector de anuncios, podrás hacer lo siguiente:
- Inspeccione sus unidades de anuncios
- Verificar si tus anuncios se están completando según lo esperado
- Identificar errores y ver detalles sobre cómo resolverlos
- Cómo consultar los detalles de cada red de publicidad de Open Bidding por solicitud
- Consulta los detalles de mediación para cada red de publicidad por solicitud
- Prueba fuentes de anuncios de mediación en cascada o de Open Bidding de terceros individuales
- Verificar si configuraste correctamente cada unidad de anuncios para Open Bidding 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, debe hacer lo siguiente:
- Completa la Guía de introducción.
- Usa la versión 8.10.0 del SDK de anuncios de Google para dispositivos móviles o una posterior.
- Habilita el modo de prueba o vincula tu dispositivo a Ad Manager. El inspector de anuncios solo se lanza 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:
- Usa el botón de inicio en el menú de depuración.
- Usa el gesto que seleccionaste en la configuración del inspector de anuncios.
- De manera programática, con la API proporcionada
Iniciar con el menú de depuración
No es necesario realizar cambios en tu app para iniciar el inspector de anuncios mediante el menú de depuración. Simplemente 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 el dispositivo, es posible que se te solicite que accedas a tu cuenta de Ad Manager.
También puedes seleccionar la configuración del inspector de anuncios en la configuración de depuración y elegir un gesto que permita abrir el inspector de anuncios en el futuro sin tener que ir al menú de depuración.
Cómo iniciar de manera programática
El inspector de anuncios también se puede lanzar de manera 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 manera programática.
Asegúrate de que el controlador de vista que se pasa a esta API ya sea completamente visible en la pantalla (se llamó a viewDidAppear:). Si el controlador de vista pasado está en proceso de mostrarse, como cuando se llama a la API en la función viewDidLoad del controlador de vista, fallará la presentación del inspector de anuncios.
Cómo ver unidades de anuncios y solucionar problemas relacionados
Una vez que se haya lanzado, aparecerá la pantalla principal del inspector de anuncios, con una lista de todas las unidades de anuncios el dispositivo realizó solicitudes de anuncios desde que se habilitó el inspector de anuncios durante la sesión de esta app. La lista también contiene unidades de anuncios con Open Bidding habilitadas, ordenadas cronológicamente con las solicitudes que se completaron más recientemente primero y aquellas sin solicitudes de anuncios completadas (atenuadas):
Te recomendamos que inicialices 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, que proporciona 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.
Cada solicitud se puede 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 aplicables a ella.
En el caso de las fuentes de anuncios de terceros, los mensajes de error se envían directamente desde la fuente de anuncios. Si necesitas más información, consulta a tu fuente de anuncios de terceros.
Cómo ver los detalles de la oferta de una unidad de anuncios
Si es la primera vez que usas Open Bidding, lee la introducción a Open Bidding.
En el registro de solicitudes del SDK, puedes ver las Open 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 de anuncios en la Open Bidding subasta.
Los resultados de Open Bidding se ordenan para acercar los elementos accionables a la parte superior de la lista:
En la parte superior, se encuentra la red de publicidad que ganó la subasta.
A continuación, se encuentran las redes de publicidad con problemas. Puedes seguir los pasos para solucionar los problemas de pasos para solucionar problemas al final de las Open Bidding Preguntas frecuentes.
Luego, se incluyen las redes de publicidad que no tuvieron anuncios o no realizaron ofertas. Este es un posible indicador de muchos problemas diferentes con la fuente del anuncio, ya que es posible que no haya ofertado debido a su configuración o decisión. Puedes consultar la guía de configuración de la fuente del anuncio o Preguntas frecuentes sobre Open Bidding para obtener más asistencia.
Por último, en la parte inferior de la lista, se encuentran las redes de publicidad que perdieron la subasta deOpen Bidding .
La cascada de mediación puede ubicar la fuente del anuncio que ganó la subasta deOpen Bidding 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 Open Bidding y los socios de rendimiento de mediación para aplicaciones para dispositivos móviles.
Depuración avanzada de unidades de anuncios
Cuando soluciones problemas con unidades de anuncios, puede ser útil analizar la solicitud de anuncio y la respuesta para identificar dónde falla algo, o puedes compartirlas con la Atención al cliente de Google para facilitar 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 completa y la respuesta. Esto te ahorra el problema de tener que ejecutar registros de red en tu propia app.
Además, puedes ver los parámetros de ofertas de terceros decodificados presionando la opción Parámetro de ofertas de terceros en el mismo menú que la cadena de solicitud. Proporciona detalles sobre qué parámetros de ofertas de terceros podrían tener problemas, lo que te permite depurar tu app o validar que una red recopile sus indicadores correctamente.
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 licitación o mediación en tu app. Luego, expande las tarjetas para ver sus estados de inicialización y versiones de SDK. Junto con los adaptadores de terceros compatibles, también puedes ver adaptadores de eventos personalizados. Los eventos personalizados permiten a los publicadores usar redes de publicidad que Ad Manager no son compatibles. Los eventos personalizados se distinguen 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 webAd Manager .
Si no se encuentra el adaptador o no se inicializa, consulta Cómo inspeccionar la publicación de anuncios en apps para dispositivos móviles para obtener más información.
Cómo probar 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 admitirá 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.
Prueba de anuncios
Las pruebas de anuncios del inspector de anuncios que se describen en esta sección son una excelente herramienta para verificar la experiencia del anuncio base y validar la configuración de mediación cuando se usa con pruebas de fuentes de anuncios individuales.
Cuando tengas todo listo para probar tu unidad de anuncios, presiona el botón Request test ad que se encuentra en la parte superior de la pantalla del inspector de anuncios para activar esa prueba. Luego, los resultados de las pruebas aparecen en el registro de solicitudes del SDK debajo del encabezado Solicitado al inspector de anuncios.
Prueba de fuente del anuncio única
El inspector de anuncios tiene una función para restringir las solicitudes de anuncios en tu app de modo que solo publiquen anuncios de una única fuente Open Bidding o de una fuente de anuncios de mediación en cascada. Esto te permite verificar si implementaste correctamente el adaptador de terceros y que la fuente del anuncio 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 fuentes del anuncio:
Debes inicializar el SDK de anuncios de Google para dispositivos móviles antes de poder usar pruebas de fuentes de anuncios individuales.
Luego, puedes seleccionar una sola fuente del anuncio para probar. Una vez que se selecciona una fuente del anuncio, aparece la siguiente pantalla:
La configuración de prueba de fuente del anuncio única se aplica a cualquier solicitud de anuncio futura que realices en la misma sesión. Sin embargo, no se aplica a ningún anuncio de esa sesión que se haya almacenado en caché antes y que aún no se mostró. Se recomienda forzar el reinicio de la app cuando aplicas una sola prueba de fuente del anuncio para invalidar los anuncios almacenados en caché que podrían publicarse, 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 se inicia el inspector de anuncios cuando una sola prueba de fuente del anuncio está activa, se muestra 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, sin importar si esa fuente se configuró para ofertas o mediación para la unidad de anuncios solicitada. Si la fuente del anuncio que estás probando no se encuentra en la cascada de mediación de una unidad de anuncios, verás el mensaje de error "Sin relleno".
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 realizadas después de que se habilitó la prueba de la fuente del anuncio individual. 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 del anuncio seleccionada a una cascada de mediación, verás cada instancia de la llamada a la fuente del anuncio en la cascada hasta que el anuncio se llene o la cascada finalice sin relleno.
Cómo detener la prueba de una fuente del anuncio única
Para detener la prueba, desactiva el interruptor de la siguiente manera:
Luego, aparecerá un mensaje de confirmación en la siguiente pantalla de reinicio:
Te recomendamos forzar el reinicio de la app después de detener la prueba a fin de invalidar los anuncios almacenados en caché para la fuente del anuncio que se probó.
Cómo 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 tuAd Manager app, 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 Se copió el archivo JSON del inspector de anuncios en el portapapeles.