La URL de transparencia del anuncio te permite personalizar el AdChoices que se muestra en ciertos anuncios. De forma predeterminada, ese ícono aparece a través de una experiencia de transparencia y control de anuncios (AT&C) renderizada por Google que incluye información para los usuarios (por ejemplo, sobre el anunciante y el anuncio en sí).
Para obtener la URL de transparencia del anuncio, puedes realizar una solicitud de anuncio al SDK de anuncios de Google para dispositivos móviles y recibir una respuesta con esa URL. Después de recibir la URL en tu app, puedes integrar un ícono personalizado que cumpla con el diseño de tus anuncios y presentar tu propia experiencia de AT&C a los usuarios.
En esta página, se explica cómo solicitar, analizar y validar la URL de transparencia del anuncio.
Requisitos previos
Antes de continuar, asegúrate de completar lo siguiente:
- Configura anuncios nativos en tu app. Para obtener más información sobre los anuncios nativos, consulta Anuncios nativos.
- Solicita acceso a esta función (lista de entidades permitidas). Para hacerlo, comunícate con tu administrador de cuentas.
- Si no tienes acceso, tus respuestas no mostrarán la URL de transparencia del anuncio, y el ícono predeterminado se renderizará según lo previsto.
Solicita la URL
Para que GMA Next-Gen SDK te muestre la URL de transparencia del anuncio, debes agregar un parámetro de solicitud adicional en tus solicitudes de anuncios nativos. Este parámetro indica que tu app está lista y preparada para controlar un ícono personalizado.
En tu solicitud, debes agregar la clave "ad_transparency_url_requested" con
el valor "1" a tu paquete de parámetros adicionales de la red. Para obtener más información sobre los parámetros adicionales de la red,
consulta
setGoogleExtrasBundle
.
En el siguiente ejemplo, se establecen esta clave y este valor para solicitar la URL de transparencia del anuncio:
Java
private void loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation.
Bundle extras = new Bundle();
extras.putString("ad_transparency_url_requested", "1");
NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
}
Kotlin
private fun loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation
val extras = Bundle()
extras.putString("ad_transparency_url_requested", "1");
val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
}
Reemplaza AD_UNIT_ID por tu ID de unidad de anuncios. Por ejemplo, ca-app-pub-3940256099942544/2247696110 para anuncios nativos.
Analiza la URL
Después de solicitar la URL, recibirás una respuesta de solicitud de anuncio con la URL de transparencia del anuncio en el objeto de información de esa respuesta. Para conocer los detalles sobre ese objeto, consulta Información de la respuesta.
Puedes acceder a la URL de transparencia del anuncio dentro de la clave "ad_transparency_url"
de los parámetros adicionales de la respuesta. En el siguiente ejemplo, se obtiene la URL de transparencia del anuncio en el objeto de información de la respuesta:
Java
nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");
Kotlin
nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")
Valida la URL
Para probar y validar la URL de transparencia del anuncio, verifica que no se muestre el ícono predeterminado proporcionado por Google en tu anuncio nativo, sino tu ícono personalizado. Haz clic en el ícono para ver la experiencia de AT&C.
Además, verifica que aparezca la URL de transparencia del anuncio de los parámetros adicionales de la respuesta en tu objeto de información de esa respuesta. Si no ves esa URL, se renderizará el ícono predeterminado de Google en lugar de tu ícono personalizado. El siguiente ejemplo muestra una URL de transparencia del anuncio:
https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID