Com o Ad Inspector, é possível:
- Inspecionar seus blocos de anúncios
- Verifique se os anúncios estão sendo preenchidos conforme esperado
- Identificar erros e visualizar detalhes sobre como resolvê-los
- Ver os detalhes de cada rede de publicidade do Open Bidding por solicitação
- Confira os detalhes de mediação de cada rede de publicidade por solicitação
- Testar origens de anúncios terceirizadas individuais do Open Bidding ou da mediação em hierarquia
- Verifique se você configurou corretamente cada bloco de anúncios para o Open Bidding e mediação em hierarquia
Este guia demonstra como lançar e usar os diferentes recursos de anúncios inspetor.
Pré-requisitos
Para usar o Ad Inspector, faça o seguinte:
- Leia o Guia explicativo.
- Use o SDK dos anúncios para dispositivos móveis do Google versão 8.10.0 ou mais recente.
- Ativar teste mode ou link seu dispositivo para o Ad Manager. O Ad Inspector só é iniciado em dispositivos de teste ou vinculados.
Abrir o Ad Inspector
É possível iniciar o Ad Inspector em qualquer lugar no app das seguintes maneiras:
- Use o botão de inicialização no menu de depuração.
- Use o gesto selecionado nas configurações do Ad Inspector.
- De forma programática, usando a API fornecida.
Iniciar usando o menu de depuração
Nenhuma mudança é necessária no app para iniciar o Ad Inspector pela depuração. Menu basta encontrar um anúncio veiculado pela sua rede do Ad Manager e tocar e segurar o anúncio com dois dedos para abrir no menu de depuração. Em seguida, selecione Abrir o Ad Inspector.
Se você não vinculou seu dispositivo, talvez seja necessário para fazer login na sua conta do Ad Manager.
Também é possível selecionar Configurações do Ad Inspector nas configurações de depuração. escolha um gesto que abra o Ad Inspector no futuro sem precisar no menu de depuração.
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.
}];
Esta API funciona em dispositivos de teste registrado programaticamente.
Verifique se o controlador de visualização transmitido para essa API já está totalmente visível no
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 o dispositivo fez solicitações de anúncios desde que o Ad Inspector foi ativado durante essa sessão no app. A lista também contém blocos de anúncios com Open Bidding ativado, ordenados cronologicamente, com as solicitações mais concluídas primeiro e aquelas com nenhuma solicitação de anúncio concluída (esmaecida):
Recomendamos inicializar os anúncios para dispositivos móveis do Google SDK 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 ver o registro de solicitação do SDK, que fornece detalhes sobre o hierarquia de mediação até o momento em que o anúncio foi preenchido (ou a hierarquia) terminar 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 hierarquia de mediação dessa solicitação, com todos os erros e latências que era aplicável à solicitação em questão.
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.
Visualizar detalhes dos lances de um bloco de anúncios
Caso você não tenha experiência com o Open Bidding, leia a introdução ao Open Bidding Lances.
No registro de solicitação do SDK, é possível conferir as Open Bidding origens de anúncios que são chamados na solicitação de anúncio. Toque em um bloco de anúncios no registro de solicitações do SDK para visualizá-lo os detalhes de cada origem de anúncios no Open Bidding leilão.
Os Open Bidding resultados são classificados 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. Você pode seguir etapas de solução de problemas no final das Open Bidding perguntas frequentes.
Depois, 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 dado lances devido à configuração ou decisões dele. Você pode consultar o anúncio no guia de configuração da origem ou Perguntas frequentes sobre o Open Bidding para mais suporte.
Finalmente, na parte inferior da lista estão as redes de anúncios que perderam a Open Bidding .
A hierarquia de mediação pode posicionar a origem de anúncios que venceu o Open Bidding de acordo com o valor de eCPM.
Uma hierarquia de mediação é o resultado de vários grupos de rendimento competindo pela mesmo inventário. É possível adicionar até 10 parceiros de rendimento terceirizados a uma grupo de rendimento, incluindo os parceiros de rendimento do Open Bidding e a mediação para dispositivos móveis parceiros de rendimento de apps.
Depuração avançada de bloco de anúncios
Ao solucionar problemas com 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 o problema de executar traces de rede nos seus seu próprio app.
Além disso, é possível visualizar parâmetros de lances de terceiros decodificados tocando em A opção Parâmetro de lances de terceiros no mesmo menu da solicitação fio. Isso fornece detalhes sobre quais parâmetros de lances de terceiros podem ter problemas, ajudando você a depurar seu aplicativo ou a validar se uma rede está coletando seus sinais com sucesso.
Conferir 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 compatíveis, também é possível visualizar eventos e adaptadores. Eventos personalizados permitem os editores usam redes de publicidade que Ad Manager não suporta. É possível diferenciar eventos personalizados de eventos personalizados na lista de adaptadores pelos nomes de classe exclusivos. Além de fornecendo informações sobre o nome e o status da turma, o Ad Inspector também exibe a e rótulos atribuídos a esses eventos Ad Manager interface da Web.
Caso o adaptador não seja encontrado ou falhe ao inicializar, consulte Inspecionar a exibição de anúncios em apps para dispositivos móveis para mais informações.
Testar seus blocos de anúncios
Se você quiser testar seu bloco de anúncios sem ter que navegar até ele na 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 de uma só vez com carregamento assíncrono exibir solicitações de anúncios de teste e até mesmo 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. Testar os resultados aparecem no registro de solicitação do SDK abaixo do cabeçalho Solicitado do Ad Inspector.
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 um único Open Bidding anúncio de mediação em hierarquia fonte. Assim, você pode verificar se implementou corretamente o e se a origem de anúncios é veiculada como esperado.
Para ativar esse recurso, alterne a chave Teste de uma única origem de anúncios na parte inferior da tela. A seguinte caixa de diálogo de seleção da origem de anúncios vai aparecer:
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 para testar. Depois de selecionar uma origem, a seguinte tela é exibida:
A configuração de teste de origem de anúncios única se aplica a todas as solicitações de anúncios futuras que você fizer no na mesma sessão. No entanto, isso não se aplica a nenhum anúncio previamente armazenado em cache que ainda não foram exibidas. É recomendável forçar a reinicialização do app ao aplicar um único teste de origem de anúncios para invalidar os anúncios armazenados em cache que pode ser veiculado, 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. Como iniciar o Ad Inspector quando um único teste de origem de anúncios é "Ativo" mostra a origem de anúncios de teste ativa:
No modo de teste de uma única origem de anúncios, todas as solicitações de anúncios tentam preencher com o origem de anúncios, independentemente de ela ter sido configurada para lances ou mediação para o bloco de anúncios solicitado. Se a origem de anúncios que você está testando não estiver a hierarquia de mediação de um bloco de anúncios, a mensagem "Sem preenchimento" mensagem de erro.
Em um teste de uma única origem de anúncios, você pode tocar em um bloco de anúncios para ver o registro de solicitação 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 não carregar um anúncio, aparece uma mensagem descrevendo o erro.
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 único teste de 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 uma 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 que foi testada.
Copiar saídas de depuração inteiras
O Ad Inspector é compatível com a cópia de uma string JSON contendo toda a depuração resultados da ferramenta, incluindo detalhes Ad Manager , os status de inicialização do adaptador e o os resultados dos testes de todos os blocos de anúncios.
Para fazer isso, toque no ícone do aplicativo sete vezes até ver a mensagem Anúncio copiado. do inspetor JSON para a área de transferência.