Anúncios nativos

Os anúncios nativos são recursos apresentados aos usuários por meio de componentes de IU nativos da plataforma. Eles são mostrados com as mesmas classes que você já usa nos seus storyboards e podem ser formatados de acordo com o design visual do seu app.

Quando um anúncio nativo é carregado, seu app recebe um objeto de anúncio que contém os recursos dele, que é responsável por exibi-los, e não o SDK dos anúncios para dispositivos móveis do Google.

Em termos gerais, a implementação de anúncios nativos tem duas partes: carregar um anúncio usando o SDK e, em seguida, exibir o conteúdo do anúncio no app.

Nesta página, mostramos como usar o SDK para carregar anúncios nativos anúncios nativos.

Pré-requisitos

• Leia o Guia explicativo.

Sempre teste com anúncios de teste

Ao criar e testar seus apps, use anúncios de teste em vez de anúncios de produção ativos.

A maneira mais fácil de carregar anúncios de teste é usar nosso ID de bloco de anúncios de teste dedicado para anúncios nativos no iOS:

/6499/example/native

Ele foi configurado especialmente para retornar anúncios de teste para cada solicitação e pode ser usado nos seus próprios apps durante a programação, o teste e a depuração. Basta substituí-lo pelo seu próprio ID do bloco de anúncios antes de publicar o aplicativo.

Para mais informações sobre como funcionam os anúncios de teste do SDK dos anúncios para dispositivos móveis do Google, consulte Anúncios de teste.

Carregar anúncios

Os anúncios nativos são carregados com a classe GADAdLoader, que envia mensagens aos delegados de acordo com o protocolo GADAdLoaderDelegate.

Além do formato nativo definido pelo sistema, você também pode criar seus próprios formatos de anúncios nativos personalizados para usar em anúncios nativos de venda direta. Os formatos de anúncios nativos personalizados permitem que você transmita dados estruturados arbitrários para seu app. Esses anúncios são representados pela classe GADCustomNativeAd.

Inicializar o carregador de anúncios

Antes de carregar um anúncio, você precisa inicializar o carregador de anúncios. O código abaixo demonstra como inicializar um GADAdLoader:

Swift

adLoader = GADAdLoader(adUnitID: "/6499/example/native",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/6499/example/native"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

Você vai precisar de um ID de bloco de anúncios (é possível usar o ID de teste), constantes para transmitir na matriz adTypes para especificar quais formatos nativos você quer solicitar e as opções que você quer definir no parâmetro options. A lista de valores possíveis para o parâmetro options pode ser encontrada na página Como definir opções de anúncios nativos.

A matriz adTypes precisa conter uma ou mais das constantes abaixo :

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

Implementar o delegado do carregador de anúncios

O delegado do carregador de anúncios precisa implementar protocolos específicos para seu tipo de anúncio. Para anúncios nativos, o protocolo GADNativeAdLoaderDelegate inclui uma mensagem que é enviada ao delegado quando um anúncio nativo é carregado.

Swift

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

O protocolo GADCustomNativeAdLoaderDelegate inclui uma mensagem que é enviada ao delegado quando um anúncio de modelo personalizado é carregado.

Swift

func adLoader(_ adLoader: GADAdLoader,
  Receive customNativeAd: GADCustomNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;

Solicitar anúncios

Dica:é possível usar chamadas de carregamento de anúncios para criar um cache de anúncios pré-carregados antes da hora de exibi-los. Assim, eles podem aparecer com latência zero quando necessário. Como os anúncios expiram após uma hora, limpe o cache e recarregue com novos anúncios a cada hora.

Depois de inicializar o GADAdLoader, chame o método loadRequest: dele para solicitar um anúncio:

Swift

adLoader.load(GAMRequest())

Objective-C

[self.adLoader loadRequest:[GAMRequest request]];

O método loadRequest: no GADAdLoader aceita os mesmos objetos GAMRequest que banners e intersticiais. É possível usar objetos de solicitação para adicionar informações de segmentação, assim como faria com outros tipos de anúncios.

Observação: o Ad Manager não é compatível com o carregamento de vários anúncios com GADMultipleAdsAdLoaderOptions e retorna somente um anúncio se usado.

Determinar quando o carregamento foi concluído

Depois que um app chamar loadRequest:, ele poderá receber os resultados da solicitação usando chamadas para:

• adLoader:didFailToReceiveAdWithError: em GADAdLoaderDelegate
• adLoader:didReceiveNativeAd: em GADNativeAdLoaderDelegate

Uma solicitação para um único anúncio resultará em uma chamada para um desses métodos.

Como lidar com solicitações com falha

Os protocolos acima estendem o protocolo GADAdLoaderDelegate, que define uma mensagem enviada quando há falha no carregamento dos anúncios.

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

Aviso :não é recomendável tentar carregar um novo anúncio usando o método delegado adLoader:didFailToReceiveAdWithError:. Se for preciso carregar um anúncio de adLoader:didFailToReceiveAdWithError:, limite as tentativas de carregamento de anúncios para evitar solicitações de anúncios com falha contínua em situações como conectividade de rede limitada.

Receber notificações sobre eventos de anúncios nativos

Para receber notificações sobre eventos relacionados a interações com anúncios nativos, defina a propriedade delegada desse anúncio:

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

Em seguida, implemente GADNativeAdDelegate para receber as seguintes chamadas delegadas:

Swift

func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Objective-C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Práticas recomendadas

Siga estas regras ao carregar anúncios.

• Os apps que usam anúncios nativos em uma lista precisam pré-armazenar em cache a lista.

• Ao armazenar anúncios previamente em cache, limpe seu cache e recarregue após uma hora.

• Não chame loadRequest: novamente em um GADAdLoader até que a solicitação anterior termine o carregamento, conforme indicado por adLoaderDidFinishLoading:.

Exiba seu anúncio

Depois de carregar um anúncio, só falta exibi-lo aos usuários. Consulte o Guia de anúncios nativos avançados para saber como fazer isso.