Ad Inspector

Ad Inspector é uma sobreposição no app que permite que dispositivos autorizados realizem análises em tempo real de solicitações de anúncios de teste diretamente em um app para dispositivos móveis. Ele pode ser ativado sem necessidade de programação.

Com o Ad Inspector, você pode:

  • Inspecionar seus blocos de anúncios
  • verificar se os anúncios estão sendo preenchidos conforme o esperado;
  • identificar erros e conferir detalhes sobre a resolução deles;
  • Mais detalhes de cada rede de publicidade do Bidding por solicitação
  • Conferir os detalhes da mediação de cada rede de publicidade por solicitação
  • Testar origens de anúncios de terceiros individuais da mediação em hierarquia ou de lances
  • Verifique se você configurou corretamente cada bloco de anúncios para lances e mediação em hierarquia

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

Pré-requisitos

Para usar o Ad Inspector, você precisa:

  • Use o Plug-in de anúncios para dispositivos móveis do Flutter versão 1.3.0 ou mais recente.

Abrir o Ad Inspector

É possível iniciar o Ad Inspector em qualquer lugar no app das seguintes maneiras:

  1. Use o botão de inicialização no menu de depuração.
  2. Use o gesto que você selecionou nas configurações do Ad Inspector.
  3. De forma programática, usando a API fornecida.

Iniciar usando o menu de depuração

Não é necessário fazer mudanças no app para iniciar o Ad Inspector pelo menu de depuração. Basta encontrar um anúncio veiculado pela sua rede do Ad Manager e tocar e manter o anúncio pressionado com dois dedos para abrir o menu de depuração. Em seguida, selecione Abrir o inspetor de anúncios.

Se você não vincular seu dispositivo, talvez seja necessário fazer login na sua conta do Ad Manager.

Também é possível selecionar Configurações do Ad Inspector nas configurações de depuração e escolher um gesto que possa abrir o Ad Inspector no futuro sem precisar acessar o menu de depuração.

Iniciar programaticamente

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

MobileAds.instance.openAdInspector(
  (AdInspectorError? 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.

Conferir e resolver problemas com blocos de anúncios

Depois de ser iniciado, a tela principal do Ad Inspector aparece, contendo uma lista de todos os blocos de anúncios para os quais o dispositivo fez solicitações de anúncio desde que o Ad Inspector foi ativado durante essa sessão do app. A lista também contém blocos de anúncios com lances ativados, ordenados cronologicamente, com as solicitações mais recentes primeiro, e aqueles sem solicitações de anúncios concluídas (desativadas):

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 conferir o registro de solicitações do SDK, que mostra detalhes sobre a hierarquia de mediação até o ponto em que o anúncio foi preenchido (ou a hierarquia terminou sem um preenchimento) para as solicitações de anúncios mais recentes.

Cada solicitação pode ser expandida usando o indicador de divulgação para mostrar os resultados da cascata de mediação para essa solicitação, junto com 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 da origem. Se você precisar de mais informações, consulte sua origem de anúncios terceirizada.

Conferir os detalhes dos lances de um bloco de anúncios

Se você não tem experiência com lances, leia a introdução ao Open Bidding.

No registro de solicitação do SDK, você pode conferir as origens de anúncios dos lances que são chamadas na solicitação de anúncio. Toque em um bloco de anúncios no registro de solicitações do SDK para conferir os detalhes de cada origem de anúncios no leilão de lances.

Os resultados dos lances são classificados para aproximar os itens acionáveis do topo da lista:

  • Na parte de cima, está a rede de publicidade que venceu o leilão.

  • Em seguida, as redes de publicidade com problemas. Siga as etapas de solução de problemas no final das perguntas frequentes sobre lances.

  • Depois, há as redes de publicidade que não retornaram anúncios ou não deram lances. Esse é um indicador possível de muitos problemas diferentes com a origem de anúncios, já que ela pode não ter lances devido à configuração ou decisão de compra. Consulte o guia de configuração da fonte de anúncios ou as Perguntas frequentes sobre o Open Bidding para mais suporte.

  • Por fim, na parte de baixo da lista, estão as redes de publicidade que perderam o leilão de lances.

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

Uma hierarquia de mediação é o resultado de vários grupos de rendimento competindo pelo mesmo inventário. Você pode adicionar até 10 parceiros de rendimento terceirizados a um único grupo de rendimento, incluindo parceiros de rendimento de lances e de mediação para apps para dispositivos móveis.

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

Ao solucionar problemas com blocos de anúncios, pode ser útil analisar a solicitação de anúncio e a resposta 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 em cascata 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 problema de executar rastros 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 os indicadores com sucesso.

Android
iOS

Conferir os adaptadores disponíveis

Clique na guia Adaptadores para ver 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, abra os cards para conferir os status de inicialização e as versões do SDK. Além dos adaptadores de terceiros com suporte, você também pode conferir os adaptadores de eventos personalizados. Os eventos personalizados permitem que os editores usem redes de publicidade que não são compatíveis com o Ad Manager. Os eventos personalizados são distinguíveis dos adaptadores de terceiros padrão na lista de adaptadores pelos nomes de classe exclusivos. Além de fornecer informações sobre o nome e status da classe, o Ad Inspector também exibe os rótulos atribuídos a esses eventos personalizados na interface da Web do Ad Manager.

Caso o adaptador não seja encontrado ou não seja inicializado, consulte Inspecionar a exibição de anúncios em apps para dispositivos móveis para mais informações.

Android
iOS

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 direto na tela de detalhes do bloco. Além disso, é possível testar vários blocos de anúncios de uma só vez, carregar e visualizar suas solicitações de anúncios de teste de maneira assíncrona e até mesmo realizar testes com uma única origem de anúncios.

Teste de anúncios

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

Quando estiver tudo pronto para testar o bloco de anúncios, toque no botão Solicitar anúncio de teste na parte de cima da tela do Ad Inspector para acionar o teste. Os resultados do teste vão aparecer no registro de solicitação do SDK abaixo do cabeçalho Solicitado do Ad Inspector.

Saiba como usar o Ad Inspector no seu app

Teste de uma única origem de anúncios

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

Para ativar esse recurso, ative a opção Teste de uma única origem de anúncios na parte de baixo da tela. A caixa de diálogo de seleção de origem de anúncios abaixo é exibida:

É 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 é selecionada, a tela a seguir é exibida:

A configuração do teste de uma única origem de anúncios se aplica a todas as solicitações de anúncios futuras feitas na mesma sessão. No entanto, isso não se aplica a anúncios em cache anteriores nessa sessão que ainda não foram mostrados. É 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 podem ser veiculados em vez de a origem escolhida receber uma solicitação.

Depois de reiniciar o app, todos os canais de blocos de anúncios tentam mostrar um anúncio apenas da rede selecionada. Quando um teste de uma única origem de anúncios está ativo, o Ad Inspector mostra a origem de teste ativa:

No modo de teste de uma única origem de anúncios, todas as solicitações tentam preencher 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 conferir o registro de solicitações do SDK. Assim, você descobre se a origem preencheu as solicitações de anúncios feitas depois que o teste foi ativado. Se a origem do anúncio não conseguir carregar um anúncio, uma mensagem de erro vai aparecer descrevendo o problema.

Se você tiver adicionado várias instâncias da origem de anúncios selecionada a uma hierarquia de mediação, poderá conferir cada instância da chamada à origem na hierarquia até o preenchimento do anúncio ou o término da hierarquia sem que haja o preenchimento.

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

Para interromper o teste, desative a chave:

Uma mensagem de confirmação vai aparecer na tela de reinicialização a seguir:

Recomendamos a reinicialização forçada do app após a interrupção do teste para invalidar todos os anúncios armazenados em cache para a origem de anúncios testada.

Copiar saídas de depuração inteiras

O Ad Inspector oferece suporte à cópia de uma string JSON que contém saídas de depuração inteiras da ferramenta, incluindo detalhes do seu app do Ad Manager, status de inicialização do adaptador e os resultados de teste de todas as unidades de anúncio.

Para fazer isso, toque no ícone do app sete vezes até que a mensagem Copied ad inspector JSON to clipboard apareça.