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:
- Completar la Guía de introducción.
- Usar el SDK de anuncios de Google para dispositivos móviles, versión 9.1.0 o posterior
- Agregar tu dispositivo como dispositivo de prueba. El inspector de anuncios solo se inicia en dispositivos de prueba.
Inicia el inspector de anuncios
El inspector de anuncios se puede iniciar desde cualquier lugar de tu app de las siguientes maneras:
- Con el gesto que seleccionaste en la IU de AdMob cuando registraste un dispositivo de prueba.
- De forma programática con la API proporcionada
- Con el botón de inicio del menú de depuración
Inicia la herramienta con un gesto
No es necesario realizar cambios en tu app para iniciar el inspector de anuncios con un gesto. Solo debes ejecutar el gesto (un giro doble de muñeca o la acción de agitar el dispositivo) 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 para que el SDK de anuncios de Google para dispositivos móviles conozca tu configuración de gestos. Si el gesto especificado no funciona, intenta cargar un anuncio, reiniciar tu app y volver a probar el gesto.
Inicia la herramienta de forma programática
El inspector de anuncios también se puede iniciar de forma programática:
Esta API funciona para los dispositivos de prueba registrados de forma programática o en la IU de AdMob.
Consulta y soluciona problemas de las unidades de anuncios
Una vez que se inicia, aparece la pantalla principal del inspector de anuncios, que contiene una lista de todas las unidades de anuncios de la IU de AdMob asociadas con el ID de tu app de AdMob que tienen 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.
Consulta los detalles de la cascada de mediación de una unidad de anuncios
Presiona una unidad de anuncios para ver tu 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 que se haya aplicado a esa solicitud.
En el caso de las fuentes de anuncios externas, los mensajes de error provienen directamente de la fuente de anuncios. Si necesitas más información, consulta tu fuente de anuncios externa.
Consulta los detalles de la licitación de una unidad de anuncios
Si es la primera vez que usas la licitación, lee la descripción general.
En el registro de solicitudes del SDK, puedes ver las fuentes de anuncios de licitación 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 licitación.
Los resultados de la licitación se ordenan para acercar los elementos prácticos 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.
Luego, se encuentran las redes de publicidad que no mostraron anuncios o no ofertaron. Este es un posible indicador de muchos problemas diferentes con la fuente de anuncios, ya que es posible que no haya ofertado debido a su configuración o toma de decisiones. Puedes consultar la guía de configuración de la fuente de anuncios o comunicarte directamente con ella para obtener asistencia.
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 licitación según su valor de eCPM.
Cuando se llama a una fuente de anuncios en la cascada de mediación, puede publicar anuncios. Para obtener más información sobre cómo funciona la licitación con la cascada de mediación, consulta el ejemplo 2 y el ejemplo 3 de las fuentes de anuncios de licitación y de cascada en un grupo de mediación.
Depuración avanzada de unidades de anuncios
Cuando se solucionan problemas de unidades de anuncios, puede ser útil analizar la solicitud de anuncio y la respuesta para identificar dónde falla algo o para compartirlo con el equipo de 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 de anuncio y la respuesta completas. Esto te evita tener que ejecutar seguimientos de red en tu propia app.
Además, puedes ver los parámetros de licitación externos decodificados si presionas la opción Third-party bidding parameter en el mismo menú que la cadena de solicitud. Esto proporciona detalles sobre qué parámetros de licitación externos podrían tener problemas, lo que te ayuda a depurar tu app o validar que una red recopile sus indicadores correctamente.
Consulta los adaptadores disponibles
Haz clic en la pestaña Adapters para ver una lista de todos los adaptadores externos 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 versiones del SDK. Además de los adaptadores externos compatibles, también puedes ver los adaptadores de eventos personalizados.
Los eventos personalizados permiten que los publicadores usen redes de publicidad que AdMob no admite. Los eventos personalizados se distinguen de los adaptadores externos 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 de AdMob.
En caso de que no se encuentre el adaptador o no se pueda inicializar, consulta Cómo solucionar problemas detectados por el inspector de anuncios para obtener más información.
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 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 una única fuente de anuncios.
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 básica y validar tu configuración de mediación cuando se usa con pruebas de una única fuente de anuncios.
Cuando estés listo para probar tu unidad de anuncios, presiona el botón Request test ad en la parte superior de la pantalla del inspector de anuncios para activar la prueba de anuncios del inspector de anuncios. Los resultados de la prueba aparecerán en el registro de solicitudes del SDK debajo del encabezado Requested from ad inspector.
Pruebas de una única fuente de anuncios
El inspector de anuncios tiene una función para restringir las solicitudes de anuncios en tu app para que solo se publiquen los anuncios desde una sola fuente de anuncios de licitación o de mediación en cascada. Esto te permite verificar que implementaste correctamente el adaptador externo y que la fuente de anuncios publica anuncios según lo previsto.
Para habilitar esta función, activa el botón Single ad source test en la parte inferior de la pantalla. Se mostrará el siguiente diálogo de selección de fuente de anuncios:
Antes de usar la prueba para fuentes de anuncios individuales, 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 de anuncios para probar. Una vez que se selecciona una fuente de anuncios, aparece la siguiente pantalla:
El parámetro de configuración de la prueba de una única fuente de anuncios se aplicará 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 hayan mostrado. Se recomienda forzar el reinicio de tu app cuando apliques la prueba de una única fuente de anuncios para invalidar los anuncios almacenados en caché que podrían publicarse en lugar de que la fuente de anuncios elegida reciba una solicitud.
Después de reiniciar la app, todas las posiciones de unidades de anuncios intentarán mostrar un anuncio solo desde la red seleccionada. Cuando está activa la prueba de una única fuente de anuncios y se inicia el inspector de anuncios, se muestra la fuente de la prueba activa:
En el modo de prueba de una única fuente de anuncios, todas las solicitudes de anuncios intentarán rellenarse con la fuente de anuncios seleccionada, independientemente de si esa fuente se configuró para la licitación o la mediación respecto 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 indica si la fuente de anuncios completó las solicitudes de anuncios que se hicieron después de que se habilitara la prueba de la fuente del anuncio individual. Si la fuente de anuncios no pudo cargar un anuncio, aparecerá un mensaje de error con la descripción correspondiente.
Si agregaste a una cascada de mediación varias instancias de la fuente de anuncios seleccionada, verás cada instancia de la llamada a la fuente de anuncios en la cascada hasta que se complete el anuncio o la cascada finalice sin relleno.
Detén la prueba de una fuente de anuncios individual
Para detener la prueba, desactiva el interruptor:
Luego, aparecerá un mensaje de confirmación en la siguiente pantalla de reinicio:
Te recomendamos que fuerces el reinicio de tu app después de detener la prueba para invalidar los anuncios almacenados en caché respecto de la fuente de anuncios sometida a prueba.
Depura la configuración de privacidad
Requisitos previos: SDK de anuncios de Google para dispositivos móviles versión 9.6.0 o posterior
- Se aplica el RGPD (
IABTCF_gdprApplies) - Cadena de CA (
IABTCF_AddtlConsent) - Cadena de TC (
IABTCF_TCString)
Después de cargar un anuncio o realizar pruebas de anuncios en el inspector de anuncios, presiona el ícono de menú en la solicitud en SDK request log. Luego, selecciona la opción Privacy signals.
En la pantalla Privacy signals , se muestran los indicadores de privacidad que se pasan en la solicitud de anuncio.
Para obtener más información sobre la cadena de CA, consulta la especificación técnica del Consentimiento adicional de Google. Para ver detalles de consentimiento detallados en la cadena de TC, como el ID de CMP y la lista de identificadores de proveedores con consentimiento asociados con IAB, haz clic en Decode para abrir el codificador / decodificador de GPP de IAB.
Si encuentras algún error, sigue los pasos que se indican en Comprende los problemas de privacidad para solucionar el problema.
Copia todos los datos de salida de depuración
El inspector de anuncios admite la copia de una cadena JSON que contiene todos los datos de salida de depuración de la herramienta, incluidos los detalles de tu app que se monetiza mediante AdMob, 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 Copied ad inspector JSON to clipboard.