Ad Inspector

Ad Inspector é uma sobreposição no app que permite que dispositivos autorizados façam análises em tempo real de solicitações de anúncios de teste diretamente em um app para dispositivos móveis. Ele está incluído na versão 20.0.0 e mais recentes do SDK dos anúncios para dispositivos móveis do Google e pode ser ativado sem a necessidade de programação.

Com o Ad Inspector em versões do SDK de anúncios para dispositivos móveis anteriores à 20.2.0, é possível fazer o seguinte:

• Inspecionar seus blocos de anúncios
• Inspecionar os adaptadores de terceiros
• Verificar se os anúncios estão sendo preenchidos conforme o esperado
• Identificar erros e ver detalhes sobre como resolvê-los
• Visualizar os detalhes da mediação para cada rede de anúncios por solicitação
• Testar origens de anúncios de mediação de terceiros individuais
• Verifique se você configurou corretamente cada bloco de anúncios para a mediação em hierarquia
• Testar integrações de eventos personalizados

Na versão 20.2.0 e mais recentes do SDK de anúncios para dispositivos móveis, também é possível fazer o seguinte:

• Consultar os detalhes dos lances para cada rede de publicidade por solicitação
• Conferir os detalhes dos lances e da mediação em hierarquia para cada rede de publicidade por solicitação
• Testar origens de anúncios de mediação em hierarquia ou de lances de terceiros individuais

• Verifique se você configurou corretamente cada bloco de anúncios para os lances e a mediação em hierarquia.

Este guia demonstra como iniciar e usar os diferentes recursos no Ad Inspector.

Pré-requisitos

Para usar o Ad Inspector, é preciso fazer o seguinte:

• Crie uma conta da AdMob e configure um app.

• Leia o Guia explicativo.

• Use o SDK dos anúncios para dispositivos móveis do Google versão 20.0.0 ou mais recente.

• Adicione seu dispositivo como um dispositivo de teste. O Ad Inspector só é iniciado em dispositivos de teste.

Iniciar o Ad Inspector

Ele pode ser iniciado em qualquer lugar do app das seguintes maneiras:

1. Use o gesto selecionado na IU da AdMob ao registrar um dispositivo de teste.
2. De maneira programática, usando a API fornecida.
3. Usar o botão "Iniciar" no menu de depuração.

Iniciar usando gestos

Não é necessário fazer mudanças no app para iniciar o Ad Inspector com um gesto. Basta realizar o gesto (tocar ou balançar) que você configurou na AdMob para esse dispositivo de teste. Saiba mais

Depois de definir um gesto na interface da AdMob e aguardar 15 minutos para que ele seja propagado, seu app precisa fazer uma solicitação de anúncio para o SDK dos anúncios para dispositivos móveis do Google aprender sobre sua configuração de gestos. Se o gesto especificado não estiver funcionando, tente carregar um anúncio, reiniciar o app e testar o gesto novamente.

Iniciar programaticamente

O Ad Inspector também pode ser iniciado de maneira programática:

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

Essa API funciona para dispositivos de teste registrados de maneira programática ou na interface da AdMob.

Conferir e resolver problemas em blocos de anúncios

Depois do lançamento, a tela principal do Ad Inspector é exibida, com uma lista de todos os blocos de anúncios na interface da AdMob associada ao ID do app da AdMob que têm configurações de lances ou mediação:

Recomendamos inicializar o SDK dos anúncios para dispositivos móveis do Google antes de usar o Ad Inspector.

Conferir os detalhes da hierarquia de mediação de um bloco de anúncios

Toque em um bloco de anúncios para ver o registro de solicitação do SDK, que fornece detalhes sobre a hierarquia de mediação até o momento em que o anúncio foi preenchido (ou a hierarquia finalizada sem um preenchimento) para as solicitações de anúncios mais recentes.

Cada solicitação pode ser aberta usando o indicador de divulgação para mostrar os resultados da hierarquia de mediação da solicitação, além de qualquer erro e latência aplicável a ela.

No caso de origens de anúncios terceirizadas, as mensagens de erro são enviadas diretamente delas. Se precisar de mais informações, consulte sua origem de anúncios terceirizada.

Mais detalhes dos lances de um bloco de anúncios

Pré-requisitos: SDK dos anúncios para dispositivos móveis do Google 20.2.0 ou superior

Se você não tem experiência com lances, leia a visão geral.

No registro de solicitação do SDK, é possível ver as bidding origens de anúncios chamadas na solicitação. Toque em um bloco de anúncios no registro de solicitações do SDK para conferir os detalhes de cada origem no bidding leilão.

Os resultados de bidding são classificados para aproximar os itens acionáveis mais próximos do topo da lista:

• No topo está a rede de publicidade que venceu o leilão.

• Em seguida, estão as redes de publicidade com problemas. Siga as etapas de solução de problemas.

• Há também as redes de publicidade que não retornaram anúncios ou não deram lances. Esse é um indicador possível de vários problemas diferentes com a origem de anúncios, já que ela pode não ter um lance devido à configuração ou ao processo de tomada de decisão. Consulte o guia de configuração da origem de anúncios ou entre em contato diretamente com ela para receber suporte.

• Por fim, no fim da lista estão as redes de publicidade que perderam o leilão debidding .

  

A hierarquia de mediação pode posicionar a origem de anúncios que venceu o leilão debidding de acordo com o valor de eCPM dela.

Quando uma origem de anúncios é chamada na hierarquia de mediação, ela consegue veicular anúncios. Para saber mais sobre como os lances funcionam com a hierarquia de mediação, consulte o exemplo 2 e o exemplo 3 de origens de anúncios dos lances e em hierarquia em um grupo de mediação.

Depuração avançada de blocos de anúncios

Ao resolver problemas de blocos de anúncios, analise a solicitação e a resposta de anúncio para identificar onde algo está falhando ou compartilhar com o Suporte do Google para ajudar na depuração. Toque no ícone de menu na parte de cima da cadeia de hierarquia e selecione Compartilhar solicitação e resposta de anúncio para exportar a solicitação e a resposta de anúncio completas. Isso evita o trabalho de executar rastreamentos de rede no seu próprio app.

Além disso, é possível conferir os parâmetros de lances de terceiros decodificados tocando na opção Parâmetro de lances de terceiros no mesmo menu da string de solicitação. Isso fornece detalhes sobre quais parâmetros de lances de terceiros podem estar com problemas, ajudando você a depurar seu app ou validar se uma rede está coletando indicadores.

Conferir os adaptadores disponíveis

Clique na guia Adaptadores para conferir uma lista de todos os adaptadores de terceiros associados às origens de anúncios nas configurações de lances ou mediação no seu app. Em seguida, expanda os cards para conferir os status de inicialização e as versões do SDK deles. Além dos adaptadores de terceiros compatíveis, também é possível ver adaptadores de eventos personalizados. Com os eventos personalizados, os editores podem usar redes de publicidade incompatíveis com AdMob. Os eventos personalizados se distinguem dos adaptadores padrão de terceiros na lista de adaptadores pelos nomes de classe exclusivos. Além de fornecer informações de nome e status da classe, o Ad Inspector também mostra os rótulos atribuídos a esses eventos personalizados na interface da WebAdMob .

Caso o adaptador não seja encontrado ou falhe ao inicializar, consulte Resolver problemas encontrados com o Ad Inspector para mais informações.

Observação: em implementações anteriores de eventos personalizados, antes da versão v20.0.0 da API, essas subclasses descontinuadas de APIs não oferecem suporte à inicialização e aparecem como Problema encontrado no Ad Inspector. Se esse aviso aparecer no Ad Inspector, mesmo que sua integração de eventos personalizados esteja funcionando, verifique se o app está usando interfaces descontinuadas, como CustomEventBanner , e substitua-as pela nova classe Adapter .

Testar seus blocos de anúncios

Se você quiser testar o bloco de anúncios sem precisar navegar até ele na interface do app, o Ad Inspector oferece suporte diretamente na tela de detalhes do bloco de anúncios. Além disso, é possível testar vários blocos de anúncios ao mesmo tempo, carregar e ver de forma assíncrona suas solicitações de anúncios de teste e até realizar testes com uma única origem.

Importante: quando você executa um desses testes do Ad Inspector, as solicitações não contêm vários parâmetros que seriam acionados na interface do app, incluindo configuração de tratamento para direcionamento a crianças, segmentação personalizada, extras de rede, tamanhos diferentes e muito mais. Devido à natureza mais limitada dessas solicitações, recomendamos testar usando a IU do seu app quando possível.

Teste de anúncios

Os testes de anúncios do Ad Inspector descritos nesta seção são uma ótima ferramenta para verificar a experiência de anúncios base e validar a configuração de mediação quando usados com testes de uma única origem.

Quando estiver tudo pronto para testar o bloco de anúncios, toque no botão Request test ad na parte de cima da tela do Ad Inspector para acionar o teste. Os resultados do teste aparecem no registro de solicitações do SDK, abaixo do cabeçalho Requested from Ad Inspector.

Saiba como usar o Ad Inspector no app

Teste de uma única origem de anúncios

O Ad Inspector tem um recurso para restringir solicitações de anúncios no seu app para veicular anúncios apenas de uma única origem bidding ou de mediação em hierarquia. Isso permite verificar se você implementou corretamente o adaptador de terceiros e se a origem de anúncios está sendo veiculada conforme o esperado.

Para ativar esse recurso, alterne a chave Teste de uma única origem de anúncios na parte de baixo da tela. A seguinte caixa de diálogo de seleção da origem de anúncios vai aparecer:

É necessário inicializar o SDK dos anúncios para dispositivos móveis do Google antes de usar o teste de uma única origem.

Em seguida, selecione uma única origem de anúncios para testar. Depois que uma origem de anúncios é selecionada, a tela a seguir aparece:

A configuração de teste de uma única origem se aplica a todas as solicitações futuras que você fizer na mesma sessão. No entanto, ela não se aplica a anúncios armazenados anteriormente na sessão que ainda não foram exibidos. É recomendável forçar a reinicialização do app ao aplicar um único teste de origem de anúncios para invalidar todos os anúncios em cache que pudem ser veiculados em vez de a origem escolhida receber uma solicitação.

Depois que o app é reiniciado, todas as posições de blocos de anúncios tentam mostrar um anúncio somente da rede selecionada. Quando um teste de uma única origem está ativo, a inicialização do Ad Inspector mostra qual delas está ativa:

No modo de teste de uma única origem de anúncios, todas as solicitações tentam preencher os dados com a origem selecionada, independentemente de ela ter sido configurada para lances ou mediação no bloco de anúncios solicitado. Se a origem de anúncios em teste não estiver na hierarquia de mediação de um bloco de anúncios, você vai receber uma mensagem de erro "Sem preenchimento".

Ao testar uma única origem, é possível tocar em um bloco de anúncios para ver o registro de solicitações do SDK. Isso permite saber se a origem preencheu as solicitações de anúncios feitas após a ativação do teste de uma única origem. Se a origem não carregar um anúncio, será exibida uma mensagem descrevendo o erro.

Se você tiver adicionado várias instâncias da origem de anúncios selecionada a uma hierarquia de mediação, vai notar cada instância da chamada à origem na hierarquia até que o anúncio seja preenchido ou a hierarquia termine sem um preenchimento.

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

Para interromper o teste, alterne a chave para a posição de desativação:

Uma mensagem de confirmação aparecerá na seguinte tela de reinicialização:

Recomendamos que você force a reinicialização do app após a interrupção do teste para invalidar os anúncios armazenados em cache para a origem testada.

Copiar todas as saídas de depuração

O Ad Inspector é compatível com a cópia de uma string JSON que contém todas as saídas de depuração da ferramenta, incluindo detalhes do seu appAdMob , status de inicialização do adaptador e os resultados dos testes de todos os blocos de anúncios.

Para isso, toque no ícone do app sete vezes até ver a mensagem Copiado JSON do Ad Inspector para a área de transferência.