Para discutir e enviar feedback sobre nossos produtos, participe do canal oficial do Ad Manager no Discord no servidor da Comunidade de publicidade e medição do Google.

Anúncios nativos

Selecione a plataforma: Android (Beta)

Android iOS Flutter Unity

Os anúncios nativos são recursos de publicidade mostrados aos usuários por componentes de interface nativos da plataforma. Eles são exibidos usando as mesmas classes aplicadas aos seus storyboards e podem ser formatados para se integrarem ao design visual do seu app.

Quando um anúncio nativo é carregado, seu app recebe um objeto de anúncio que tem os recursos dele. O aplicativo, e não o Google Mobile Ads SDK, é o elemento responsável por mostrar esses recursos.

De modo geral, a implementação dos anúncios nativos é feita em duas etapas: carregar um anúncio usando o SDK e exibir o conteúdo do anúncio no app.

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

Pré-requisitos

Leia o guia para iniciantes.

Sempre usar 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 fazer isso é usando nosso ID de bloco de anúncios dedicado para testes com anúncios nativos no iOS:

/21775744923/example/native

Ele foi configurado especialmente para retornar anúncios de teste em todas as solicitações, e você pode usá-lo nos seus próprios apps durante a programação, os testes e a depuração. Substitua pelo ID do seu bloco de anúncios antes de publicar o app.

Para detalhes sobre os anúncios de teste do Google Mobile Ads SDK, consulte Ativar 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 personalizados de anúncios nativos, que podem ser usados em anúncios de venda direta. Com esses formatos, você pode transmitir 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. O código a seguir demonstra como inicializar um GADAdLoader:

Swift

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  // To receive native ads, the ad loader's delegate must
  // conform to the NativeAdLoaderDelegate protocol.
  adTypes: [.native],
  // Use nil for default options.
  options: nil)
// Set the delegate before making an ad request.
adLoader.delegate = selfNativeAdSnippets.swift

Substitua nativeAdUnitID pelo ID do seu bloco de anúncios.

Objective-C

self.adLoader =
    [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                       // The UIViewController parameter is optional.
                       rootViewController:self
                                  // To receive native ads, the ad loader's delegate must
                                  // conform to the NativeAdLoaderDelegate protocol.
                                  adTypes:@[ GADAdLoaderAdTypeNative ]
                                  // Use nil for default options.
                                  options:nil];
// Set the delegate before making an ad request.
self.adLoader.delegate = self;NativeAdSnippets.m

Substitua kNativeAdUnitID pelo ID do seu bloco de anúncios.

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

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

GADAdLoaderAdTypeNative

GADAdLoaderAdTypeCustomNative

Implementar o delegado do carregador de anúncios

O delegate do carregador de anúncios precisa implementar protocolos específicos ao seu tipo de anúncio. Para anúncios nativos, o protocolo GADNativeAdLoaderDelegate inclui uma mensagem enviada ao delegate quando eles são carregados.

Swift

func adLoader(_ adLoader: AdLoader, didReceive nativeAd: NativeAd) {
  // Set the delegate to receive notifications for interactions with the native ad.
  nativeAd.delegate = self

  // TODO: Display the native ad.
}NativeAdSnippets.swift

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // Set the delegate to receive notifications for interactions with the native ad.
  nativeAd.delegate = self;

  // TODO: Display the native ad.
}NativeAdSnippets.m

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

Swift

func adLoader(_ adLoader: AdLoader, didReceive customNativeAd: CustomNativeAd) {
  // To be notified of events related to the custom native ad interactions, set the delegate
  // property of the native ad
  customNativeAd.delegate = self

  // TODO: Display the custom native ad.
}NativeAdSnippets.swift

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  // To be notified of events related to the custom native ad interactions, set the delegate
  // property of the native ad
  customNativeAd.delegate = self;

  // TODO: Display the custom native ad.
}NativeAdSnippets.m

Solicitar anúncios

Depois que GADAdLoader for inicializado, chame o método loadRequest: dele para solicitar um anúncio:

Swift

adLoader.load(AdManagerRequest())NativeAdSnippets.swift

Objective-C

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

O método loadRequest: em GADAdLoader aceita os mesmos objetos GAMRequest que banners e intersticiais. É possível usar os objetos da solicitação para adicionar informações de segmentação do mesmo modo que você faria com outros tipos de anúncios.

Carregar vários anúncios (opcional)

Para carregar vários anúncios em uma única solicitação, defina o objeto GADMultipleAdsAdLoaderOptions ao inicializar um GADAdLoader.

Swift

let multipleAdOptions = MultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5
adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  adTypes: [.native],
  options: [multipleAdOptions])NativeAdSnippets.swift

Objective-C

GADMultipleAdsAdLoaderOptions *multipleAdOptions = [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdOptions.numberOfAds = 5;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                                   // The UIViewController parameter is optional.
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ multipleAdOptions ]];NativeAdSnippets.m

O limite por solicitação é de cinco, e não há garantia de que o SDK vai retornar o número exato de anúncios solicitados.

Todos os anúncios do Google retornados serão diferentes entre si, mas não há garantia de que os anúncios de inventário reservado ou compradores terceirizados sejam únicos.

Não use a classe GADMultipleAdsAdLoaderOptions se você estiver usando a mediação, porque as solicitações de vários anúncios nativos não funcionam para IDs de bloco de anúncios que foram configurados para mediação.

Determinar quando o carregamento foi concluído

Depois que um app chama loadRequest:, ele pode receber os resultados da solicitação usando chamadas para:

adLoader:didFailToReceiveAdWithError: no GADAdLoaderDelegate
adLoader:didReceiveNativeAd: no GADNativeAdLoaderDelegate

A solicitação de um único anúncio vai resultar em uma chamada para um desses métodos.

A solicitação de vários anúncios vai resultar em pelo menos um callback para os métodos acima, mas não mais do que o número máximo de anúncios solicitados.

Além disso, GADAdLoaderDelegate oferece o callback adLoaderDidFinishLoading. Esse método delegado indica que um carregador de anúncios terminou de carregar a publicidade e que nenhum outro anúncio ou erro será informado para a solicitação. Confira um exemplo de como usar esse método ao carregar vários anúncios nativos de uma só vez:

Swift

func adLoaderDidFinishLoading(_ adLoader: AdLoader) {
  // The adLoader has finished loading ads.
}NativeAdSnippets.swift

Objective-C

- (void)adLoaderDidFinishLoading:(GADAdLoader *)adLoader {
  // The adLoader has finished loading ads.
}NativeAdSnippets.m

Lidar com solicitações que têm falhas

Os protocolos estendem o GADAdLoaderDelegate, que define a mensagem enviada quando ocorre uma falha no carregamento dos anúncios.

Swift

func adLoader(_ adLoader: AdLoader, didFailToReceiveAdWithError error: any Error) {
  // The adLoader failed to receive an ad.
}NativeAdSnippets.swift

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didFailToReceiveAdWithError:(NSError *)error {
  // The adLoader failed to receive an ad.
}NativeAdSnippets.m

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

Para receber notificações sobre eventos relacionados às interações com anúncios nativos, defina a propriedade delegate do anúncio nativo:

Swift

nativeAd.delegate = selfNativeAdSnippets.swift

Objective-C

nativeAd.delegate = self;NativeAdSnippets.m

Em seguida, implemente GADNativeAdDelegate para receber as seguintes chamadas de delegate:

Swift

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

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

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

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

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

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

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.
}NativeAdSnippets.m

Práticas recomendadas

Siga estas regras ao carregar anúncios.

Os apps que usam anúncios nativos em uma lista precisam pré-armazenar a lista de anúncios em cache.
Quando você fizer isso, limpe e recarregue o cache depois de uma hora.
Não chame loadRequest: novamente em um GADAdLoader até que a solicitação anterior termine de carregar, conforme indicado por adLoaderDidFinishLoading:.
Limite o cache de anúncios nativos apenas ao que é necessário. Por exemplo, ao usar o pré-cache, armazene apenas os anúncios que estão imediatamente visíveis na tela. Os anúncios nativos têm um grande consumo de memória, e o armazenamento em cache sem destruição resulta em uso excessivo de memória.
Destrua os anúncios nativos quando eles não estiverem mais em uso.

Mostrar seu anúncio

Depois de carregar um anúncio, basta mostrá-lo aos usuários. Acesse nosso guia de anúncios nativos avançados para saber como fazer isso.

Anúncios nativos Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Pré-requisitos

Sempre usar anúncios de teste

Carregar anúncios

Inicializar o carregador de anúncios

Swift

Objective-C

Implementar o delegado do carregador de anúncios

Swift

Objective-C

Swift

Objective-C

Solicitar anúncios

Swift

Objective-C

Carregar vários anúncios (opcional)

Swift

Objective-C

Determinar quando o carregamento foi concluído

Swift

Objective-C

Lidar com solicitações que têm falhas

Swift

Objective-C

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

Swift

Objective-C

Swift

Objective-C

Práticas recomendadas

Mostrar seu anúncio

Anúncios nativos