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 avanzados. Las aplicaciones pueden controlar cómo gestiona GADAdLoader
los recursos de imagen de este tipo de anuncios 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 propiedadesimage
yimageURL
. Si se asigna adisableImageLoading
el valorfalse
, la opción predeterminada (oNO
en Objective-C), el SDK obtendrá los recursos de imagen y rellenará las propiedadesimage
yimageURL
automáticamente. Si se le asigna el valortrue
(oYES
en Objective‐C), el SDK solo rellenará el campoimageURL
y podrás descargar las imágenes que quieras. Usa la propiedadmainImage
deGADMediaContent
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 unGADAdLoader
, 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‑C | Swift |
---|---|
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.