Opções de anúncios nativos

Selecione a plataforma: Android iOS

Os anúncios nativos têm muitos recursos avançados que permitem fazer outras personalizações e oferecer a melhor experiência do anúncio possível. Este guia mostra como usar os recursos avançados dos anúncios nativos.

Pré-requisitos

• Integre o formato de anúncio nativo.

Controles de recursos

Nesta seção, detalhamos como personalizar os recursos de criativo nos seus anúncios nativos. Você pode especificar uma proporção preferida para recursos de mídia, além da forma como os recursos de imagem são baixados e mostrados.

Controles da proporção preferida de mídia

Com os controles de proporção de mídia, você pode especificar uma preferência para a proporção dos criativos de anúncio.

Importante: o uso dessa API não garante que todos os criativos vão atender à preferência especificada.

Defina GADNativeAdMediaAdLoaderOptions mediaAspectRatio com um GADMediaAspectRatio.

• Quando essas opções não são definidas, o anúncio retornado pode ter qualquer proporção de mídia.

• Quando definidos, você pode melhorar a experiência do usuário especificando o tipo de proporção da sua preferência.

O exemplo a seguir instrui o SDK a escolher uma imagem ou um vídeo com uma proporção específica.

Swift

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

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

Controle de download de imagens

Com o controle de download de imagens, você decide se o SDK vai retornar recursos de imagem ou apenas URIs.

Defina GADNativeAdImageAdLoaderOptions disableImageLoading com um valor BOOL.

• O controle fica desativado por padrão.

• Quando desativado, o SDK dos Anúncios para Dispositivos Móveis do Google preenche a imagem e o URI para você.

• Quando ativado, o SDK preenche apenas o URI, permitindo que você faça o download das imagens reais a seu critério.

O exemplo a seguir instrui o SDK a retornar apenas o URI.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Controles de payload de imagens

Alguns anúncios têm uma série de imagens em vez de apenas uma. Use esse recurso para indicar se o app está preparado para mostrar todas as imagens ou apenas uma.

• Os controles de payload de imagens ficam desativados por padrão.

• Quando desativados, o app instrui o SDK a fornecer apenas a primeira imagem de recursos que contêm uma série.

• Quando ativados, o app indica que está preparado para mostrar todas as imagens de recursos que têm mais de uma.

O exemplo a seguir instrui o SDK a retornar vários recursos de imagem.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Posições das Opções de Anúncios

Nesta seção, detalhamos como posicionar a sobreposição das Opções de Anúncios. Você pode colocá-la em um dos quatro cantos da imagem ou renderizar em uma visualização personalizada.

Controles de posições das Opções de Anúncios

Com os controles de posições das Opções de Anúncios, você escolhe em qual canto renderizar o ícone.

Defina GADNativeAdViewAdOptions preferredAdChoicesPosition com um valor GADAdChoicesPosition.

• Se a posição do ícone Opções de Anúncios não for definida, ele será exibido no canto superior direito.

• Se a posição for definida, o ícone será exibido na posição personalizada escolhida.

O exemplo a seguir demonstra como definir uma posição personalizada para a imagem das Opções de Anúncios.

Swift

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Visualização personalizada das Opções de Anúncios

Aviso: o acesso a esse recurso é limitado. Para solicitá-lo, entre em contato com seu gerente de contas.

Com o recurso de visualização personalizada das Opções de Anúncios, é possível colocar o ícone em um local personalizado. Isso é diferente dos controles de posição das Opções de Anúncios, que permitem especificar apenas um dos quatro cantos.

Defina a propriedade GADNativeAd.adChoicesView com uma GADAdChoicesView antes da renderização. O conteúdo das Opções de Anúncios será renderizado dentro da GADAdChoicesView.

O exemplo a seguir demonstra como definir uma visualização personalizada das Opções de Anúncios. O ícone é renderizado dentro de GADAdChoicesView:

Swift

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}
NativeAdOptionsSnippets.swift

Objective-C

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}
NativeAdOptionsSnippets.m

Controles de vídeo

Nesta seção, detalhamos como personalizar a experiência de reprodução dos anúncios em vídeo. Você pode definir o estado inicial como silenciado e implementar controles personalizados.

Comportamento de iniciar sem som

Com o comportamento de iniciar sem som, você pode ativar ou desativar o áudio inicial de um vídeo.

Defina GADVideoOptions startMuted com um valor BOOL.

• O comportamento de iniciar sem som está ativado por padrão.

• Quando desativado, o app solicita que o vídeo comece com áudio.

• Quando ativado, o app solicita que o vídeo comece sem áudio.

O exemplo a seguir mostra como iniciar o vídeo com o áudio ativado.

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Controles de mídia personalizados

Aviso: o acesso a esse recurso é limitado. Para solicitá-lo, entre em contato com seu gerente de contas.

Isso permite solicitar controles personalizados de entrada de vídeo para reproduzir, pausar ou silenciar o vídeo.

Defina GADVideoOptions customControlsRequested com um valor BOOL.

• Os controles personalizados de mídia ficam desativados por padrão.

• Quando desativados, seu vídeo vai mostrar controles de entrada renderizados pelo SDK.

• Quando os controles estiverem ativados, você poderá usar GADVideoController play, GADVideoController pause e GADVideoController setMute para controlar o anúncio em vídeo.

Se o anúncio tiver conteúdo de vídeo e os controles personalizados estiverem ativados, mostre-os, já que o anúncio não vai exibir nenhum controle por conta própria. Em seguida, os controles podem chamar os métodos relevantes no

GADVideoController.

O exemplo a seguir mostra como solicitar um vídeo com controles de mídia personalizados.

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Verificar se os controles personalizados estão ativados

Como não se sabe no momento da solicitação se o anúncio retornado vai permitir controles de vídeo personalizados, verifique se eles estão ativados.

Swift

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}
NativeAdOptionsSnippets.swift

Objective-C

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}
NativeAdOptionsSnippets.m

Renderizar controles de vídeo personalizados

Renderize controles de vídeo personalizados usando estas práticas recomendadas:

1. Renderize os controles personalizados como um elemento filho da visualização de anúncio nativo. Com essa abordagem, os cálculos de visibilidade da medição aberta consideram os controles personalizados como uma obstrução amigável.
2. Evite renderizar uma sobreposição invisível em toda a visualização de mídia. As sobreposições bloqueiam os cliques na visualização, afetando negativamente a performance dos anúncios nativos. Crie uma pequena sobreposição que seja grande o suficiente para caber nos controles.

Observação: para informações sobre provedores de medição e verificação comprometidos com o desenvolvimento do padrão de visibilidade de medição aberta, consulte o Grupo de trabalho de medição aberta.

Gestos de clique personalizados

Aviso: o acesso a esse recurso é limitado. Para solicitá-lo, entre em contato com seu gerente de contas.

O recurso de gestos de clique personalizados dos anúncios nativos permite registrar cliques quando a pessoa desliza os dedos em visualizações de anúncios. Ele foi projetado para funcionar com apps que usam gestos de deslizar para navegar pelo conteúdo. Neste guia, mostramos como ativar gestos de clique personalizados nos seus anúncios nativos.

Inicialize uma instância GADNativeAdCustomClickGestureOptions com a direção de deslizar selecionada. Também é necessário indicar se você quer que os toques sejam entendidos como cliques.

• Os gestos de clique personalizados ficam desativados por padrão.

• Quando eles estiverem desativados, apenas toques serão contados como cliques.

• Porém, se eles forem ativados, os gestos de deslizar serão contabilizados como cliques, e você poderá especificar se os toques também serão.

Confira no exemplo a seguir como implementar um gesto de deslizar personalizado para a direita e como preservar o comportamento normal de toque.

Swift

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];
NativeAdOptionsSnippets.m

Aviso: se a sua conta não estiver ativada para gestos de clique personalizados, as solicitações de anúncios vão retornar sem preenchimento.

Detectar eventos de gestos de deslizar

Quando um clique do tipo gesto de deslizar é registrado, o SDK dos Anúncios para Dispositivos Móveis do Google invoca o método delegado nativeAdDidRecordSwipeGestureClick: em GADNativeAdDelegate, além do método delegado nativeAdDidRecordClick: atual.

Swift

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}
NativeAdOptionsSnippets.swift

Objective-C

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}
NativeAdOptionsSnippets.m

Mediação

Gestos de clique personalizados só funcionam em anúncios nativos renderizados pelo SDK dos anúncios para dispositivos móveis do Google. As origens de anúncios que exigem SDKs de terceiros para renderização não respondem à configuração de instruções de clique personalizado.