Opções de anúncio nativo

O último parâmetro incluído na criação do GADAdLoader é um array opcional de objetos. Esta seção descreve essas opções.

Rápido

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

Objetivo-C

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

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions contém propriedades relacionadas a imagens em anúncios nativos. Os aplicativos podem controlar como um GADAdLoader lida com recursos de imagem criando um objeto GADNativeAdImageAdLoaderOptions , definindo suas propriedades ( disableImageLoading , preferredImageOrientation e shouldRequestMultipleImages ) e transmitindo-o durante a inicialização.

GADNativeAdImageAdLoaderOptions tem as seguintes propriedades:

disableImageLoading
Os recursos de imagem para anúncios nativos são retornados por meio de instâncias de GADNativeAdImage , que contém propriedades image e imageURL . Se disableImageLoading for definido como false , que é o padrão ( NO em Objective-C), o SDK buscará recursos de imagem automaticamente e preencherá as propriedades image e imageURL para você. Se estiver definido como true (ou YES em Objective-C), o SDK preencherá apenas imageURL , permitindo que você baixe as imagens reais a seu critério. Use a mainImage mainImage de GADMediaContent para definir a imagem para a exibição de mídia ao baixar imagens manualmente.
preferredImageOrientation

Alguns criativos têm várias imagens disponíveis para corresponder a diferentes orientações do dispositivo. Os aplicativos podem solicitar imagens para uma orientação específica definindo essa propriedade como uma das constantes de orientação:

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape
  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

    Se você usar preferredImageOrientation para especificar uma preferência para orientação de imagem de paisagem ou retrato, o SDK colocará as imagens correspondentes a essa orientação primeiro em matrizes de ativos de imagem e colocará imagens não correspondentes depois delas. Como alguns anúncios terão apenas uma orientação disponível, os editores devem garantir que seus aplicativos possam lidar com imagens de paisagem e retrato.

    Se esse método não for chamado, o valor padrão de GADNativeAdImageAdLoaderOptionsOrientationAny será usado.

shouldRequestMultipleImages

Alguns recursos de imagem conterão uma série de imagens em vez de apenas uma. Ao definir esse valor como true, seu aplicativo indica que está preparado para exibir todas as imagens de quaisquer ativos que tenham mais de uma. Ao defini-lo como false (o padrão), seu aplicativo instrui o SDK a fornecer apenas a primeira imagem para todos os ativos que contêm uma série.

Se nenhum objeto GADAdLoaderOptions for passado ao inicializar um GADAdLoader , o valor padrão para cada opção será usado.

GADNativeAdViewAdOptions

Os objetos GADNativeAdViewAdOptions são usados ​​para indicar preferências de como as visualizações de anúncios nativos devem representar anúncios. Eles têm uma única propriedade: preferredAdChoicesPosition , que você pode usar para especificar o local onde o ícone AdChoices deve ser colocado. O ícone pode aparecer em qualquer canto do anúncio e o padrão é GADAdChoicesPositionTopRightCorner . Os valores possíveis para esta propriedade são:

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

Veja um exemplo que mostra como colocar o ícone AdChoices no canto superior esquerdo de um anúncio:

Rápido

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 ... ])

Objetivo-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

Os objetos GADVideoOptions são usados ​​para indicar como os ativos de vídeo nativos devem ser exibidos. Eles oferecem uma única propriedade: startMuted .

Este booleano indica se os recursos de vídeo devem começar a ser reproduzidos sem som. O valor padrão é true .

GADMultipleAdsAdLoaderOptions

Os objetos GADMultipleAdsAdLoaderOptions permitem que os editores instruam um carregador de anúncios a carregar vários anúncios em uma única solicitação. Os anúncios carregados dessa maneira são exclusivos. GADMultipleAdsAdLoaderOptions tem uma única propriedade, numberOfAds , que representa o número de anúncios que o carregador de anúncios deve tentar retornar para a solicitação. Por padrão, esse valor é um e tem um limite máximo de cinco (mesmo que um aplicativo solicite mais anúncios, no máximo cinco serão retornados). O número real de anúncios retornados não é garantido, mas estará entre zero e numberOfAds .

GADNativeAdMediaAdLoaderOptions

Para usar esse recurso, inclua a classe GADNativeAdMediaAdLoaderOptions na matriz de opções de anúncio nativo na inicialização do GADAdLoader .

Os objetos GADNativeAdMediaAdLoaderOptions permitem que você selecione preferências de proporção de mídia. A opção é aplicada à imagem e ao vídeo. Essa classe tem uma propriedade: mediaAspectRatio , que você pode usar para especificar as proporções de mídia com suporte. Os valores possíveis para esta propriedade são:

Objetivo-C Rápido
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

Definir mediaAspectRatio como uma dessas opções fará com que apenas anúncios com mídia da proporção especificada sejam retornados. Se essa propriedade não for definida explicitamente, o valor padrão será GADMediaAspectRatioUnknown e nenhuma restrição nas proporções será aplicada.