Native Ads Options

Puedes utilizar el objeto NativeAdOptions para personalizar aún más tus anuncios nativos. En esta guía, aprenderás a usar NativeAdOptions.

Opciones de configuración

withNativeAdOptions()
La última función incluida al crear el AdLoader es withNativeAdOptions(), otro método opcional:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native")
    .forUnifiedNativeAd(new UnifiedNativeAd.OnUnifiedNativeAdLoadedListener() {
        @Override
        public void onUnifiedNativeAdLoaded(UnifiedNativeAd unifiedNativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(int errorCode) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(new NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/6499/example/native")
    .forUnifiedNativeAd { ad : UnifiedNativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(errorCode: Int) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build()

El objeto NativeAdOptions permite que las aplicaciones asignen opciones específicas al hacer solicitudes. Su clase Builder ofrece los siguientes métodos, que se pueden usar al crear una instancia.

setReturnUrlsForImageAssets()
Los recursos de imagen de los anuncios nativos se devuelven mediante instancias de NativeAd..Image, que contienen un elemento Drawable y otro Uri. Si esta opción es "false" (su valor predeterminado), el SDK de anuncios de Google para móviles obtiene los recursos de imagen automáticamente y rellena tanto el Drawable como el Uri. Sin embargo, si es "true", el SDK solo rellena el campo Uri, por lo que puedes descargar las imágenes que quieras.
setImageOrientation()

Algunas creatividades tienen varias imágenes para adaptarse a las distintas orientaciones del dispositivo. Al llamar a este método con una de las constantes de orientación de NativeAdOptions (ORIENTATION_PORTRAIT, ORIENTATION_LANDSCAPE, ORIENTATION_ANY), se solicitan las imágenes de una orientación concreta. Si no se llama a este método, se utiliza el valor predeterminado de ORIENTATION_LANDSCAPE.

setRequestMultipleImages()

Algunos recursos de imagen incluyen una serie de imágenes en vez de una sola. Al configurar este valor como "true", la aplicación indica que está preparada para mostrar todas las imágenes de cualquier recurso que tenga más de una. Al definirlo como "false" (valor predeterminado), la aplicación indica al SDK que proporcione solo la primera imagen de cualquier recurso que incluya una serie.

Si no se llama a withNativeAdOptions al crear un AdLoader, se utiliza el valor predeterminado de cada opción.

setAdChoicesPlacement()

De forma predeterminada, la superposición de Gestión de anuncios aparece en la esquina superior derecha. Para elegir la esquina que prefieras, asigna uno de los siguientes valores a esta propiedad:

  • ADCHOICES_TOP_LEFT
  • ADCHOICES_TOP_RIGHT
  • ADCHOICES_BOTTOM_RIGHT
  • ADCHOICES_BOTTOM_LEFT
setVideoOptions()

Las aplicaciones pueden usar este método para definir las opciones de los recursos de vídeo devueltos como parte de un anuncio nativo. Para obtener más información, consulta la sección Anuncios de vídeo nativos de la guía sobre los anuncios nativos avanzados.

setMediaAspectRatio()

Este método establece la relación de aspecto de los recursos de imagen y vídeo que se devuelven para el anuncio nativo. Si se configura con una de las siguientes constantes, solo se devolverán anuncios que tengan recursos multimedia con la relación de aspecto especificada:

  • NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE
  • NATIVE_MEDIA_ASPECT_RATIO_PORTRAIT
  • NATIVE_MEDIA_ASPECT_RATIO_SQUARE
  • NATIVE_MEDIA_ASPECT_RATIO_ANY

Si no se asigna ninguna constante a NativeMediaAspectRatio, se devolverán anuncios con cualquier relación de aspecto.

Enviar comentarios sobre...

Mobile Ads SDK for Android
Mobile Ads SDK for Android
Si necesitas ayuda, visita nuestra página de asistencia.