Ativar anúncios de teste

Este guia explica como ativar anúncios de teste para a integração de anúncios. É recomendado ativar os anúncios de teste durante o desenvolvimento para testar o comportamento de cliques sem afetar as estatísticas das campanhas de reserva ou gerar cobranças para anunciantes na Ad Exchange.

Pré-requisito

Demonstração de blocos de anúncios

A maneira mais rápida de realizar testes é usar blocos de anúncios de demonstração fornecidos pelo Google. Esses blocos não ficam associados à sua conta do Ad Manager. Portanto, não há risco de que ela gere tráfego inválido ao usar esses blocos.

Confira alguns blocos de anúncios de demonstração que apontam para criativos de teste específicos para cada formato:

Formato do anúncio ID do bloco de anúncios de demonstração
Abertura do app /21775744923/example/app-open
Banner adaptativo /21775744923/example/adaptive-banner
Banner de tamanho fixo /21775744923/example/fixed-size-banner
Intersticial /21775744923/example/interstitial
Anúncios premiados /21775744923/example/rewarded
Intersticial premiado /21775744923/example/rewarded-interstitial
Nativo /21775744923/example/native
Vídeo nativo /21775744923/example/native-video
Importante: esses blocos de anúncios de demonstração são configurados para veicular anúncios de venda direta no Ad Manager, e esses anúncios não retornam as Opções de anúncios.

Ativar dispositivos de teste

Se você quiser fazer testes mais rigorosos com anúncios de aparência de produção, configure seu dispositivo como de teste e use os próprios IDs de bloco de anúncios criados na interface do Ad Manager.

Siga as etapas abaixo para adicionar seu dispositivo como um dispositivo de teste.

Adicionar o dispositivo de teste de forma programática

Se você quiser testar anúncios no seu app durante o desenvolvimento, siga as etapas abaixo para registrar o dispositivo de teste de forma programática.

  1. Carregue o app integrado a anúncios e faça uma solicitação de anúncio.
  2. Verifique a saída do Logcat para ver uma mensagem semelhante à mostrada abaixo, que mostra o ID do dispositivo e como adicioná-lo como um dispositivo de teste:
    I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
    to get test ads on this device."
    Copie o ID do dispositivo de teste para a área de transferência.
  3. Modifique o código para chamar RequestConfiguration.Builder.setTestDeviceIds() e transmitir uma lista dos IDs dos dispositivos de teste.

    Java

    List<String> testDeviceIds = Arrays.asList("33BE2250B43518CCDA7DE426D04EE231");
    RequestConfiguration configuration =
        new RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build();
    MobileAds.setRequestConfiguration(configuration);
    

    Kotlin

    val testDeviceIds = Arrays.asList("33BE2250B43518CCDA7DE426D04EE231")
    val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()
    MobileAds.setRequestConfiguration(configuration)
    
    Você pode verificar isTestDevice() para confirmar se o dispositivo foi adicionado corretamente como um dispositivo de teste.
  4. Execute o app novamente. Se o anúncio for do Google, um rótulo Test Ad vai aparecer centralizado na parte de cima do anúncio (banner, intersticial ou vídeo recompensado):

    Para anúncios nativos avançados, o recurso de título é precedido pela string Anúncio de teste.

É seguro clicar em anúncios com esse rótulo Anúncio de teste. Solicitações, impressões e cliques em anúncios de teste não são exibidos nos relatórios da sua conta.

Observação: para ver o rótulo Anúncio de teste, você precisa usar a versão 11.6.0 ou mais recente do SDK.

Como testar com mediação

Os blocos de anúncios de amostra do Google só mostram anúncios do Google. Para testar a configuração de mediação, use a abordagem de ativar dispositivos de teste.

Os anúncios mediados NÃO renderizam um rótulo de anúncio de teste. Você é responsável por garantir que os anúncios de teste estejam ativados para cada uma das suas redes de mediação. Assim, essas redes não sinalizarão sua conta por atividades inválidas. Consulte o guia de mediação de cada rede para mais informações.

Caso você não tenha certeza se um adaptador de rede de publicidade de mediação é compatível com anúncios de teste, é mais seguro evitar clicar em anúncios dessa rede durante o desenvolvimento. Você pode usar o método getMediationAdapterClassName() em qualquer um dos formatos de anúncio para descobrir qual rede veiculou o anúncio atual.