Opções de anúncios nativos

Os anúncios nativos têm muitos recursos avançados que permitem fazer outras personalizações e ter a melhor experiência de 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

Controles de proporção de mídia preferidos

Os controles de proporção da mídia permitem especificar uma preferência para a proporção do criativos de anúncios.

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

Chamar NativeAdOptions.Builder.setMediaAspectRatio() com um NativeAdOptions.MediaAspectRatio .

• Se não for definido, o anúncio retornado poderá ter qualquer proporção de mídia.

• Quando definido, você poderá melhorar a experiência do usuário especificando o é o tipo preferido de proporção.

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                              .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
                              .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

Controle de download de imagens

O controle de download de imagens permite decidir se os recursos de imagem ou apenas URIs retornados pelo SDK.

Chamar NativeAdOptions.Builder.setReturnUrlsForImageAssets() com um valor boolean.

• O controle de download de imagens 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.

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setReturnUrlsForImageAssets(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .forNativeAd(nativeAd -> {
                                List<Uri> imageUris = new ArrayList<>();
                                for (Image image : nativeAd.getImages()) {
                                  imageUris.add(image.getUri());
                                }
                              })
                              .build();

Controles de payload de imagem

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

Chame NativeAdOptions.Builder.setRequestMultipleImages() com um valor boolean.

• Os controles de payload de imagem estão desativados por padrão.

• Quando desativado, o app instrui o SDK a fornecer apenas a primeira imagem para todos os recursos que contêm uma série.

• Quando ativado, 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.

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setRequestMultipleImages(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

Controles de posição das Opções de anúncios

Com os controles de posição das Opções de anúncios, você escolhe em qual canto renderizar Ícone "Opções de anúncios".

Chamar NativeAdOptions.Builder.setAdChoicesPlacement() com um NativeAdOption.AdChoicesPlacement .

• Se não for definido, a posição do ícone da AdChoices será definida como canto superior direito.

• Se definidas, as Opções de anúncios são colocadas na posição personalizada conforme solicitado.

O exemplo a seguir demonstra como definir uma posição de imagem personalizada do AdChoices.

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

Visualização personalizada de Opções de anúncios

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

O recurso de visualização personalizada "Opções de anúncios" permite posicionar o ícone "Opções de anúncios" local personalizado. Isso é diferente dos controles de posição das Opções de anúncios, que só permite a especificação de um dos quatro cantos.

Chamar NativeAdView.setAdChoicesView() com um AdChoicesView .

O exemplo a seguir demonstra como definir uma visualização das Opções de anúncios com o parâmetro Ícone das Opções de anúncios renderizado no AdChoicesView.

public void onNativeAdLoaded(NativeAd ad) {
    NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
    AdChoicesView adChoicesView = new AdChoicesView(this);
    nativeAdView.setAdChoicesView(adChoicesView);
}

Controles de vídeo

Iniciar comportamento silenciado

O comportamento de início com som desativado permite desativar ou ativar o áudio inicial de um vídeo.

Chamar VideoOptions.Builder.setStartMuted() com um valor boolean.

• O comportamento de início silenciado é 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 com o áudio desativado.

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

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setStartMuted(false)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

Controles de mídia personalizados

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

Isso permite que você solicite controles de entrada de vídeo personalizados para reproduzir, pausar ou silenciar o vídeo.

Chamar VideoOptions.Builder.setCustomControlsRequested() com um valor boolean.

• O controle de reprodução personalizado fica desativado por padrão.

• Quando desativado, o vídeo mostra os controles de entrada renderizados pelo SDK.

• Se o anúncio tiver conteúdo de vídeo e controles personalizados estiverem ativados, você deverá exiba seus controles personalizados junto com o anúncio, já que ele não exibirá controla por conta própria. Os controles podem chamar os métodos relevantes no VideoController

O exemplo a seguir mostra como solicitar um vídeo com controles de reprodução personalizados.

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setCustomControlsRequested(true)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

Verificar se os controles personalizados estão ativados

Como não se sabe no momento da solicitação se o anúncio retornado permitirá controles de vídeo personalizados, você precisa verificar se os controles personalizados estão ativados.

Java

@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
  MediaContent mediaContent = nativeAd.getMediaContent();
  if (mediaContent != null) {
    VideoController videoController = mediaContent.getVideoController();
    boolean canShowCustomControls = videoController.isCustomControlsEnabled();
  }
}

Kotlin

NativeAd.OnNativeAdLoadedListener { ad ->
  val mediaContent = ad.mediaContent
  if (mediaContent != null) {
    val videoController = mediaContent.videoController
    val canShowCustomControls = videoController.isCustomControlsEnabled
  }
}

Renderizar controles de vídeo personalizados

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

1. Processa a visualização dos controles personalizados como filha da visualização do anúncio nativo. Essa abordagem garante que os cálculos de visibilidade do Open Measurement considerem os controles personalizados como uma obstrução amigável.
2. Evite renderizar uma sobreposição invisível sobre toda a visualização de mídia. As sobreposições bloqueiam os cliques na visualização de mídia, o que afeta negativamente a performance dos anúncios nativos. Em vez disso, crie uma sobreposição pequena o suficiente para caber os controles.

Observação: para informações sobre provedores de medição e verificação que se comprometeram a desenvolver o padrão de visibilidade do Open Measurement, consulte o Grupo de trabalho do Open Measurement.

Gestos de clique personalizados

Aviso: o acesso a este recurso é limitado. Para solicitar acesso, entre em contato com seu gerente de contas.

Os gestos de clique personalizados são um recurso de anúncios nativos que permite que as deslizadas em visualizações de anúncios sejam registradas como cliques no anúncio. Ele foi projetado para funcionar com apps que usam gestos de deslizar para navegar pelo conteúdo. Este guia mostra como ativar gestos de clique personalizados nos seus anúncios nativos.

Chamar NativeAdOptions.Builder.enableCustomClickGestureDirection() com um NativeAdOptions.SwipeGestureDirection e um boolean para indicar se você quer que toques sejam permitidos como cliques.

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

• Quando desativado, o app é compatível com o comportamento de clique normal.

• Quando ativado, o app é compatível com gestos de deslizar personalizados.

O exemplo a seguir implementa um gesto de deslizar personalizado para a direita e preserva o comportamento normal das guias.

NativeAdOptions adOptions = new NativeAdOptions
    .Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT,
            /* tapsAllowed= */ true)
    .build();

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
AdLoader.Builder builder = new AdLoader
    .Builder(this, 'ca-app-pub-3940256099942544/2247696110')
    .withNativeAdOptions(adOptions);

Aviso :se os gestos de clique personalizados não estiverem ativados na sua conta, as solicitações de anúncios não será preenchido.

Ouvir eventos de gestos de deslizar

Quando um clique de gesto de deslizar é registrado, o SDK dos anúncios para dispositivos móveis do Google invoca o método onAdSwipeGestureClicked() em AdListener, além do método onAdClicked().

AdLoader adLoader = builder
    .withAdListener(
      new AdListener() {
        // Called when a swipe gesture click is recorded.
        @Override
        public void onAdSwipeGestureClicked() {
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        // Called when a swipe gesture click or a tap click is recorded, as
        // configured in NativeAdOptions.
        @Override
        public void onAdClicked() {
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      })
    .build();

Mediação

Os gestos de clique personalizados só funcionam em anúncios nativos que o Google Mobile O SDK de anúncios é renderizado. As origens de anúncios que exigem SDKs de terceiros para renderização não respondem à configuração de instruções de clique personalizadas.