Opciones de anuncios nativos

El último parámetro incluido en la creación del objeto GADAdLoader es una matriz opcional de objetos. En esta sección te describimos dichas opciones.

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective‑C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions contiene propiedades relacionadas con las imágenes de los anuncios nativos avanzados. Las aplicaciones pueden controlar cómo gestiona GADAdLoader los recursos de imagen de este tipo de anuncios. Para ello, crea un objeto GADNativeAdImageAdLoaderOptions, define sus propiedades (disableImageLoading, preferredImageOrientation y shouldRequestMultipleImages) y lo transfiere durante la inicialización.

GADNativeAdImageAdLoaderOptions tiene las siguientes propiedades:

disableImageLoading

Los recursos de imagen de los anuncios nativos se devuelven mediante instancias de GADNativeAdImage, que contiene las propiedades image y imageURL. Si disableImageLoading se define como false, que es el valor predeterminado (o NO en el caso de Objective‑C), el SDK obtendrá los recursos de imagen y rellenará las propiedades image e imageURL automáticamente. Si se define como true (o YES en Objective‑C), el SDK solo rellenará imageURL y podrás descargar las imágenes como mejor te convenga. Para definir la imagen que tendrá la vista multimedia al descargar imágenes manualmente, se puede usar la propiedad mainImage de GADMediaContent.

preferredImageOrientation

Algunas creatividades tienen varias imágenes para adaptarse a las distintas orientaciones de los dispositivos. Las aplicaciones pueden solicitar imágenes de una orientación concreta definiendo esta propiedad como una de las constantes de orientación:

GADNativeAdImageAdLoaderOptionsOrientationAny
GADNativeAdImageAdLoaderOptionsOrientationLandscape
GADNativeAdImageAdLoaderOptionsOrientationPortrait

Si usas preferredImageOrientation para especificar una preferencia de orientación de imagen vertical u horizontal, el SDK situará en primer lugar las imágenes con esa orientación en las matrices de recursos de imagen y, a continuación, las que no coincidan. Asegúrate de que tus aplicaciones puedan reconocer imágenes tanto en horizontal como en vertical, ya que algunos anuncios solo tienen una orientación.

Si no se llama a este método, se usará el valor predeterminado GADNativeAdImageAdLoaderOptionsOrientationAny.

shouldRequestMultipleImages

Algunos recursos de imagen incluyen una serie de imágenes, no solo una. Si defines este valor como "true", la aplicación indicará que está preparada para mostrar todas las imágenes de cualquier recurso que tenga más de una imagen. Si se define como "false" (valor predeterminado), la aplicación indicará al SDK que proporcione solo la primera imagen de cualquier recurso que incluya una serie.

Si no se transfiere ningún objeto GADAdLoaderOptions al inicializar GADAdLoader, se usará el valor predeterminado de cada opción.

GADNativeAdViewAdOptions

Los objetos GADNativeAdViewAdOptions sirven para indicar las preferencias sobre cómo se deben representar los anuncios en las vistas de anuncios nativos. Tienen una sola propiedad, preferredAdChoicesPosition, que se puede utilizar para especificar dónde debe situarse el icono de Gestión de anuncios. Dicho icono puede aparecer en cualquier esquina del anuncio y su valor predeterminado es GADAdChoicesPositionTopRightCorner. Los posibles valores de esta propiedad son los siguientes:

GADAdChoicesPositionTopRightCorner
GADAdChoicesPositionTopLeftCorner
GADAdChoicesPositionBottomRightCorner
GADAdChoicesPositionBottomLeftCorner

Aquí tienes un ejemplo de cómo puedes situar el icono de Gestión de anuncios en la esquina superior izquierda de un anuncio:

Swift

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective‑C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

Los objetos GADVideoOptions se utilizan para indicar cómo deben mostrarse los recursos de vídeo nativos. Tienen una única propiedad: startMuted.

Este valor booleano indica si los recursos de vídeo deben empezar a reproducirse silenciados. El valor predeterminado es true.

GADMultipleAdsAdLoaderOptions

Los objetos GADMultipleAdsAdLoaderOptions permiten a los editores indicar a un cargador de anuncios que cargue varios anuncios con una única solicitud. Los anuncios cargados de esta forma serán forzosamente únicos. GADMultipleAdsAdLoaderOptions tiene una propiedad única, numberOfAds, que representa el número de anuncios que el cargador debe intentar devolver tras recibir la solicitud. El valor predeterminado es uno y está limitado a un máximo de cinco (aunque una aplicación solicite más, solo se devolverán cinco a lo sumo). El número real de anuncios devueltos no está garantizado, pero oscilará entre cero y numberOfAds.

GADNativeAdMediaAdLoaderOptions

Para usar esta función, incluye la clase GADNativeAdMediaAdLoaderOptions en la matriz de opciones de anuncios nativos correspondiente a la inicialización de GADAdLoader.

Los objetos GADNativeAdMediaAdLoaderOptions te permiten seleccionar las preferencias de relación de aspecto de los recursos multimedia. Dichas preferencias se aplican tanto a los recursos de vídeo como a los de imagen. Esta clase tiene una única propiedad, mediaAspectRatio, que puedes utilizar para especificar las relaciones de aspecto compatibles de los recursos multimedia. Los posibles valores de esta propiedad son los siguientes:

Objective‑C	Swift
`GADMediaAspectRatioAny`	`.any`
`GADMediaAspectRatioLandscape`	`.landscape`
`GADMediaAspectRatioPortrait`	`.portrait`
`GADMediaAspectRatioSquare`	`.square`

Si se configura mediaAspectRatio como una de estas opciones, solo se devolverán los anuncios que tengan recursos multimedia con la relación de aspecto especificada. Si esta propiedad no se configura específicamente, el valor predeterminado será GADMediaAspectRatioUnknown y no se aplicarán restricciones sobre la relación de aspecto.