Testar blocos de anúncios

Selecione a plataforma: Android (beta) Android iOS Unity Flutter

O Ad Inspector é compatível com os seguintes testes:

• Teste com contexto: carregue anúncios dos blocos de anúncios no seu app. Você pode abrir o Ad Inspector para conferir detalhes sobre as solicitações feitas pelos blocos.
• Teste sem contexto: teste seu bloco de anúncios diretamente no Ad Inspector sem precisar navegar até a interface do app. É possível testar vários blocos de anúncios de uma só vez, carregar e visualizar de forma assíncrona as solicitações de anúncios de teste e realizar testes com uma única origem de anúncios.

Ao executar um teste sem contexto, suas solicitações não incluem os parâmetros para execução na interface do app, como a configuração de tratamento para direcionamento a crianças, segmentação personalizada, extras de rede e tamanhos diferentes. Devido à limitação desses pedidos, recomendamos que você use testes com contexto na interface do seu app.

Pré-requisitos

Antes de continuar, faça o seguinte:

• Conclua todos os itens nos pré-requisitos iniciais para criar uma conta do AdMob, definir seu dispositivo de teste, inicializar Google Mobile Ads Unity Plugin, e instalar a versão mais recente.
• Inicie o Ad Inspector.

Solicitar um anúncio de teste

Para solicitar um anúncio de teste no Ad Inspector, siga estas etapas: Para mais detalhes, confira como usar o Ad Inspector no app.

• Com contexto:

  1. Em um dispositivo de teste, navegue até a interface do app e carregue um anúncio.
  2. Abra o Ad Inspector. Na guia Ad unit (Bloco de anúncios, em tradução livre), encontre o bloco em que você carregou o anúncio.
  3. Em SDK request log (Registro de solicitações do SDK), confira detalhes sobre o anúncio de teste solicitado.

• Out-of-context:

  1. Na guia Ad unit (Bloco de anúncios, em tradução livre), toque no bloco e clique em Solicitar anúncio de teste.
  2. Em SDK request log (Registro de solicitações do SDK), confira detalhes sobre o anúncio de teste solicitado.

Se o formato do bloco de anúncios mostrar Unknown (Desconhecido), a opção Request test ad (Solicitar anúncio de teste) vai aparecer esmaecida.

Personalizar um anúncio de teste

O Ad Inspector permite criar um anúncio de teste personalizado na página Configure custom ad request (Configurar solicitação de anúncio personalizada, em tradução livre). Essa página contém parâmetros que você usa para definir e solicitar um anúncio de teste personalizado. Para solicitar um anúncio de teste com as configurações padrão, siga as instruções em Solicitar um anúncio de teste.

Para criar um anúncio de teste personalizado, faça o seguinte:

1. Na guia Ad unit (Bloco de anúncios, em tradução livre), toque no bloco em que você quer criar um anúncio de teste personalizado.

2. Clique em editEditar:

   

   A página Configure custom ad request (Configurar solicitação de anúncio personalizada, em tradução livre) será exibida. O exemplo a seguir mostra a página Configure custom ad request (Configurar solicitação de anúncio personalizada, em tradução livre) para um anúncio de banner:

   

3. Insira a solicitação de anúncio e os detalhes nos seguintes campos:

   • Ad Request (Solicitação de anúncio, em tradução livre)
     • Content URL (URL do conteúdo, em tradução livre): o URL do conteúdo ao redor. Para mais detalhes, consulte URL do conteúdo.
     • URLs de conteúdo adjacente: o URL do conteúdo que aparece antes e depois de um anúncio. Para mais detalhes, consulte Mapeamento de conteúdo para aplicativos.
   • Dependendo do formato do anúncio, insira os seguintes detalhes do anúncio:
     • Banner Ads (Anúncios de banner, em tradução livre): insira a largura e a altura do anúncio. Para mais detalhes, consulte Anúncios de banner.
     • Native Ads:
       (Anúncios nativos, em tradução livre)
       • Media Aspect Ratio (Proporção da mídia, em tradução livre): selecione a proporção de mídia preferida.
       • Disable Image Loading (Desativar carregamento de imagens, em tradução livre): define se Google Mobile Ads Unity Plugin precisa carregar o conteúdo do recurso de imagem.
       • Custom Mute This Ad (Desativar este anúncio personalizado, em tradução livre): define se o recurso personalizado de desativação de anúncios será usado.
       • Preferred Ad Choices Position (Posição preferencial das Opções de Anúncios, em tradução livre): indica o local preferencial do ícone Opções de Anúncios.

   • Video Options (Opções de vídeo, em tradução livre):

     • Start Muted (Iniciar com o som desativado, em tradução livre): uma opção para desativar o som do conteúdo no início.
     • Click to Expand Requested (Clique para expandir solicitado, em tradução livre): define se o vídeo solicitado precisa ter o comportamento de clique para expandir.

4. Clique em Request custom test ad (Solicitar anúncio de teste personalizado, em tradução livre). Se tudo der certo, o anúncio de teste personalizado vai aparecer em SDK request log (Registro de solicitações do SDK).

Testar uma única origem de anúncios

O Ad Inspector pode restringir as solicitações de anúncios no seu app para veicular anúncios de uma única origem de anúncios, seja por lances ou em hierarquia. Essa abordagem permite verificar se você fez a integração corretamente com o adaptador de terceiros e se a origem de anúncios está veiculando conforme o esperado.

Para testar uma única origem de anúncio, siga estas etapas:

1. Em Ad Inspector, clique na opção Single ad source test (Teste com uma única origem de anúncios, em tradução livre). Uma caixa de diálogo Single ad source test (Teste com uma única origem de anúncios, em tradução livre) vai aparecer:

2. Selecione uma origem de anúncios para testar. Depois disso, você verá a página Force restart app (Forçar reinicialização do app):

   

A configuração de teste com uma única origem de anúncios se aplica a todas as solicitações futuras. Esse teste não considera os anúncios que já foram armazenados em cache durante a sessão. Recomendamos que você force a reinicialização do app ao aplicar um teste com uma única origem de anúncios. Essa abordagem invalida os anúncios armazenados em cache que poderiam ser exibidos no lugar da origem de anúncios escolhida receber uma solicitação.

Depois de reiniciar o app, todas as posições de bloco de anúncios tentam mostrar um anúncio da origem de anúncios selecionada. Ao iniciar o Ad Inspector quando um teste com uma única origem de anúncios está ativo, a origem de anúncios desse teste é mostrada:

No modo de teste com uma única origem de anúncios, todas as solicitações tentam ser preenchidas com a origem selecionada, tenha sido ela configurada para lances ou hierarquia. Se a origem de anúncios que você está testando não estiver configurada para lances nem hierarquia no bloco de anúncios, você vai receber a seguinte mensagem de erro:

Ad Unit has no applicable adapter for single ad source testing on network: AD_SOURCE_ADAPTER_CLASS_NAME

Para verificar se a origem de anúncios preencheu as solicitações depois que você iniciou um teste com uma única origem, toque em um bloco de anúncios para ver o registro de solicitações do SDK. Se a origem de anúncios não carregar um anúncio, uma mensagem de erro vai aparecer descrevendo o erro, como Adapter failed to initialize.

Se você tiver adicionado várias instâncias da origem de anúncios selecionada a uma hierarquia, poderá conferir cada instância da chamada à origem. Esse processo é renderizado até que o anúncio seja preenchido ou a hierarquia termine sem um preenchimento.

Parar um teste de uma única origem de anúncios

Para interromper o teste, siga estas etapas:

1. Em Ad Inspector, desative a opção Single ad source test (Teste com uma única origem de anúncios, em tradução livre). É exibida a caixa de diálogo Stop single ad source test? (Parar o teste de uma única origem de anúncio?).

2. Toque em Stop test (Parar teste, em tradução livre).

   

   Se der tudo certo, uma mensagem de confirmação vai aparecer em Force restart app (Forçar reinicialização do app):

   

Para revogar os anúncios em cache da origem de anúncios testada, recomendamos forçar a reinicialização do app depois de interromper o teste.