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 las opciones disponibles.

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. Las aplicaciones pueden controlar cómo gestiona GADAdLoader los recursos de imagen creando un objeto GADNativeAdImageAdLoaderOptions, definiendo sus propiedades (disableImageLoading, preferredImageOrientation y shouldRequestMultipleImages) y transfiriéndolo durante la inicialización.

GADNativeAdImageAdLoaderOptions tiene las siguientes propiedades:

disableImageLoading
Los recursos de imagen de los anuncios nativos se devuelven mediante instancias de la clase GADNativeAdImage, que contienen las propiedades image y imageURL. Si se asigna a disableImageLoading el valor false, la opción predeterminada (o NO en Objective-C), el SDK obtendrá los recursos de imagen y rellenará las propiedades image y imageURL automáticamente. Si se le asigna el valor true (o YES en Objective‐C), el SDK solo rellenará el campo imageURL y podrás descargar las imágenes que quieras. Usa la propiedad mainImage de GADMediaContent para definir la imagen que tendrá la vista multimedia al descargar imágenes manualmente.
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 de 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 le das el valor false (valor predeterminado), la aplicación indica al SDK que proporcione solo la primera imagen de los recursos que incluyan una serie.

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

GADNativeAdViewAdOptions

Los objetos GADNativeAdViewAdOptions se usan 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 usar para especificar dónde debe situarse el icono de Gestión de anuncios. El 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 que se cargan de esta forma serán forzosamente únicos. GADMultipleAdsAdLoaderOptions tiene una sola propiedad (numberOfAds), que representa el número de anuncios que debe intentar cargar el cargador de anuncios para responder a las solicitudes. El valor predeterminado es uno y está limitado a un máximo de cinco (aunque una aplicación solicite más anuncios, 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‑CSwift
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

Si se configura mediaAspectRatio como una de estas opciones, solo se devolverán 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.