Ad Inspector

Ad Inspector (em inglês) é uma sobreposição no app que permite aos dispositivos autorizados realizar operações em tempo real análise de solicitações de anúncios de teste diretamente em um app para dispositivos móveis. Ele está incluído no Anúncios para dispositivos móveis do Google versão 7.68.0 e mais recentes do SDK e pode ser ativado com sem precisar de programação.

Usar o Ad Inspector em versões do SDK dos anúncios para dispositivos móveis anteriores a 8.5.0, você pode:

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

Para a versão 8.5.0 e mais recente do SDK dos anúncios para dispositivos móveis, também é possível:

  • Conferir os detalhes do lance de cada rede de publicidade por solicitação
  • Confira os detalhes de lances e mediação em hierarquia para cada anúncio juntos rede por solicitação
  • Testar origens de anúncios individuais de lances de terceiros ou de mediação em hierarquia
  • 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 inspector de anúncios.

Pré-requisitos

Para usar o Ad Inspector, faça o seguinte:

  • Use o SDK dos anúncios para dispositivos móveis 7.68.0 ou mais recente.

Abrir o Ad Inspector

O Ad Inspector pode ser iniciado em qualquer lugar do seu app das seguintes maneiras:

  1. Use o gesto selecionado na interface da AdMob quando: registrar um dispositivo de teste.
  2. De forma programática, usando a API fornecida.
  3. Use o botão de inicialização no menu de depuração.

Iniciar usando gestos

Nenhuma mudança é necessária no app para iniciar o Ad Inspector com um gesto. acabei de faça o gesto (toque duplo ou agitação) que você configurou na AdMob para nesse dispositivo de teste. Saiba mais

Depois de definir um gesto na interface da AdMob (e esperar 15 minutos para que ele seja propagado), o app precisa fazer uma solicitação de anúncio para que o SDK dos anúncios para dispositivos móveis do Google saiba sobre a configuração do gesto. Se o gesto especificado não for está funcionando, tente carregar um anúncio, reiniciar o app e testar o gesto novamente.

Iniciar de forma programática

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

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

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

Verifique se o controlador de visualização transmitido a essa API já está totalmente visível na tela (viewDidAppear: foi chamado). Se o controlador de visualizações transmitido estiver no O processo de exibição, como quando a API é chamada na visualização a função viewDidLoad do controlador, depois a apresentação do Ad Inspector falhar.

Visualizar e resolver problemas de blocos de anúncios

Depois de iniciado, a tela principal do Ad Inspector aparece com uma lista de todos os elementos unidades na interface da AdMob associada ao ID do app AdMob que têm lances ou mediação. de configuração:

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

Conferir 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.

Para origens de anúncios de terceiros, as mensagens de erro são enviadas diretamente do origem de anúncios. 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

Pré-requisitos: SDK dos anúncios para dispositivos móveis do Google 8.5.0 ou mais alto

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

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 ver os detalhes do cada origem de anúncios no leilão do Bidding.

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

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

  • Em seguida, as redes de publicidade com problemas. Você pode seguir etapas de solução de problemas.

  • Além disso, há as redes de publicidade que não retornaram anúncios ou não deram lances. Isso é um possível indicador de muitos problemas diferentes com a origem de anúncios, já que ela pode não ter lances devido à configuração ou tomada de decisão. Consulte o guia de configuração da origem de anúncios ou entre em contato diretamente com a origem de anúncios para receber 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 posicionar a origem de anúncios que venceu o leilão dos lances de acordo com o valor de eCPM.

Quando uma origem de anúncios é chamada na hierarquia de mediação, ela pode 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 lances e origens de anúncios em hierarquia em um grupo de mediação.

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

Ao resolver problemas com os blocos de anúncios, pode ser útil analisar a solicitação de anúncio e resposta para identificar onde algo está falhando ou compartilhar com o Google Suporte para ajudar na depuração. Toque no ícone de menu na parte de cima da cachoeira. de anúncios e selecione Compartilhar solicitação e resposta de anúncio para exportar a solicitação de anúncio completa e resposta. Isso evita que você precise executar rastros de rede no seu 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. Ele 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.

Conferir os adaptadores disponíveis

Clique na guia Adaptadores para conferir uma lista de todos os adaptadores de terceiros associados com as origens de anúncios nas configurações de lances ou mediação do 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 AdMob não oferecem suporte. Os eventos personalizados são distinguíveis 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 ao usar o Ad Inspector para mais informações.

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 solicitações de anúncios de teste de forma assíncrona e até realizar testes de uma única origem de anúncios.

Teste de anúncio

Os testes de anúncio do Ad Inspector descritos nesta seção são uma ótima ferramenta para verificar sua experiência básica com anúncios e validar sua mediação quando usada com um único teste de origem de anúncios.

Quando você estiver pronto para testar seu bloco de anúncios, toque no botão Solicitar anúncio de teste na 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.

Aprenda a usar o Ad Inspector na sua 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 que sejam veiculadas apenas anúncios de uma única origem de anúncios de mediação em hierarquia ou dos lances. Assim, você pode verificar se você implementou corretamente o adaptador de terceiros e se a origem de anúncios é veiculado 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:

Você deve inicializar os anúncios para celular do Google SDK antes de usar o teste de uma única origem de anúncios.

Em seguida, selecione uma única origem de anúncios para testar. Depois que uma origem de anúncios é selecionada, a seguinte tela é 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 teste de uma única origem de anúncios para invalidar os anúncios em cache que poderiam ser veiculados em vez de a origem escolhida receber uma solicitação.

Depois de reiniciar seu aplicativo, todos os posicionamentos de blocos de anúncios tentam exibir um anúncio da apenas na 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 os blocos com a origem selecionada, independente de ela estar configurada para lances ou mediação para o bloco em questão. Se a origem de anúncios em teste não estiver na hierarquia de mediação de um bloco de anúncios, vai aparecer 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ê saberá se a origem preencheu as solicitações de anúncios feitas após o teste de uma única origem de anúncios está ativado. Se a origem de anúncios não conseguir carregar um anúncio, uma mensagem de erro vai aparecer descrevendo o problema.

Se você adicionou várias instâncias da origem de anúncios selecionada a uma mediação cada instância da chamada à origem de anúncios na hierarquia de anúncios 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, mude a chave para a posição de desativação:

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

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 appAdMob , 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.