Si utilizas el inspector de anuncios en versiones del SDK de anuncios para dispositivos móviles anteriores a la20.2.0, puedes hacer lo siguiente:
- Inspeccione sus unidades de anuncios
- Inspecciona los adaptadores de terceros
- Verificar si tus anuncios se están completando según lo esperado
- Identificar errores y ver detalles sobre cómo resolverlos
- Consulta los detalles de mediación para cada red de publicidad por solicitud
- Cómo probar fuentes de anuncios de mediación de terceros individuales
- Verifique si configuró correctamente cada unidad de anuncios para la mediación en cascada
- Prueba integraciones de eventos personalizados
En el caso de la versión del SDK de anuncios para dispositivos móviles 20.2.0 y posteriores, también puedes hacer lo siguiente:
- Consultar los detalles de la oferta de cada red de publicidad por solicitud
- Consultar los detalles de la licitación y la mediación en cascada para cada red de publicidad por solicitud
- Cómo probar fuentes de anuncios de licitación en cascada o de licitación de terceros individuales
Verificar si configuraste correctamente cada unidad de anuncios para las ofertas 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 20.0.0 del SDK de anuncios de Google para dispositivos móviles o una posterior.
- Agrega tu dispositivo como dispositivo de prueba. El inspector de anuncios solo se lanza en dispositivos 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 gesto seleccionado en la IU de AdMob cuando registres un dispositivo de prueba.
- De manera programática, con la API proporcionada
- Usa el botón de inicio en el menú de depuración.
Iniciar con gestos
No es necesario realizar cambios en tu app para iniciar el inspector de anuncios con un gesto. Solo debes realizar el gesto (girar doble o agitar) 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 a fin de que el SDK de anuncios de Google para dispositivos móviles obtenga información sobre tu configuración de gestos. Si el gesto especificado no funciona, carga un anuncio, reinicia la app y vuelve a probar el gesto.
Cómo iniciar de manera programática
El inspector de anuncios también se puede lanzar de manera programática:
Java
MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
public void onAdInspectorClosed(@Nullable AdInspectorError error) {
// Error will be non-null if ad inspector closed due to an error.
}
});
Kotlin
MobileAds.openAdInspector(context) { error ->
// Error will be non-null if ad inspector closed due to an error.
}
Esta API funciona para dispositivos de prueba registrados de manera programática o en la IU de AdMob.
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 anunciosen la IU de AdMob asociadas con el ID de la app de AdMob que tengan configuraciones de licitación o mediación:
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
Requisitos previos: SDK de anuncios de Google para dispositivos móviles 20.2.0 o superior
Si es la primera vez que utilizas las ofertas, lee 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 de anuncios en la bidding subasta.
Los resultados de 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.
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 comunicarte directamente con la fuente del anuncio para obtener asistencia.
Por último, en la parte inferior de la lista, se encuentran las redes de publicidad que perdieron la subasta debidding .
La cascada de mediación puede ubicar la fuente del anuncio que ganó la subasta debidding 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 ofertas con la cascada de mediación, consulta el ejemplo 2 y el ejemplo 3 de fuentes de anuncios de licitación y cascada en un grupo de mediación.
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 AdMob 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 webAdMob .
Si no se encuentra el adaptador o no se inicializa, consulta Cómo solucionar problemas con el inspector de anuncios 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 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 tuAdMob 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.