Como usar o inspetor de anúncios na sua app

O inspetor de anúncios começa a inspecionar automaticamente a publicação de anúncios na app assim que a abrir num dispositivo de teste registado. Pode ver detalhes dos seus pedidos de anúncios carregados durante a utilização da app ou carregar pedidos de anúncios através da apresentação de anúncios de teste no inspetor de anúncios.

Tenha em atenção que pode ter um conjunto de pedidos de anúncios mesmo no início da app se esta obtiver previamente anúncios.

Nesta página

• Veja pedidos de anúncios por bloco de anúncios
• Veja registos de pedidos do SDK
• Veja adaptadores de terceiros
• Teste origens de anúncios individuais

Veja pedidos de anúncios por bloco de anúncios

Depois de invocar o inspetor de anúncios no dispositivo de teste através de um gesto ou de uma chamada API personalizada, vê a página Blocos de anúncios que apresenta os blocos de anúncios da sua app ordenados de acordo com a atividade mais recente (se apresentaram ou não um anúncio).

Pode inspecionar os blocos de anúncios:

• Em contexto: pode navegar na app para testar os blocos de anúncios como se fosse o utilizador. Invoque o inspetor de anúncios nos ecrãs onde os anúncios são carregados. 
• Fora de contexto: pode testar os blocos de anúncios com anúncios de teste para não ter de navegar na app. Invoque o inspetor de anúncios em qualquer ecrã. Na página Blocos de anúncios, encontre o bloco de anúncios que quer testar. Em seguida, toque em Pedir anúncio de teste. 

Os blocos de anúncios fora de contexto são apresentados após os blocos de anúncios com atividade na página Blocos de anúncios.

Nota: recomendamos que inicialize o SDK de Anúncios para Dispositivos Móveis da Google antes de usar o inspetor de anúncios. Não vai poder ver a lista completa dos blocos de anúncios até inicializar o SDK. Saiba como inicializar o SDK de Anúncios para Dispositivos Móveis da Google (Android e iOS).

Além disso, se a sua app contiver blocos de anúncios que não estejam associados ao ID da app do AdMob, o bloco de anúncios só é apresentado se existir, pelo menos, um pedido concluído para esse bloco de anúncios.

Veja registos de pedidos do SDK  

Toque num bloco de anúncios para ver o respetivo registo de pedidos do SDK. O registo de pedidos do SDK detalha a hierarquia da mediação para os pedidos de anúncios mais recentes. Mostra as origens de anúncios que foram chamadas na hierarquia de publicação até o anúncio ter sido preenchido (ou que a hierarquia de publicação terminou sem preenchimento). Também indica as origens de anúncios que não foram pedidas após o preenchimento do anúncio.

Também pode ver detalhes mais específicos acerca das origens de anúncios de lances e origens de anúncios com hierarquia de publicação no registo de pedidos do SDK.

No registo de pedidos do SDK, toque em  e, de seguida, em Partilhar string de pedido para exportar o pedido de anúncio completo. Desta forma, pode resolver problemas mais detalhadamente ou partilhá-los com o Apoio técnico da Google para receber ajuda na depuração.

Detalhes sobre as origens de anúncios de lances

Nota: para ver os detalhes dos lances no inspetor de anúncios, tem de instalar a versão 20.2.0 ou superior para Android e a versão 8.5.0 ou superior para iOS.

No registo de pedidos do SDK, toque em  e, de seguida, em Ver todos os licitadores para ver todas as origens de anúncios de lances configuradas para esse bloco de anúncios.

Os resultados dos lances são apresentados na seguinte ordem:

1. A origem de anúncios que venceu o leilão.
2. As origens de anúncios com problemas. Saiba como resolver estes problemas.
3. As origens de anúncios que não devolveram um anúncio ou que não licitaram. Isto pode dever-se a um problema com a sua origem de anúncios de terceiros. Consulte a origem de anúncios diretamente para obter apoio técnico.
4. As origens de anúncios que perderam o leilão de lances.

Acerca dos detalhes do parâmetro de lances de terceiros

Para ver detalhes acerca do parâmetro de terceiros enviado num pedido de anúncio, toque em  e, de seguida, em Parâmetro de lances de terceiros. A descodificação do parâmetro de lances de terceiros faculta as seguintes informações acerca da origem de lances de terceiros:

• Versão do SDK
• Versão do adaptador
• Dados gerados pelo comprador 
  Nota: para partilhar estes dados com a sua origem de anúncios de terceiros, toque em . Os dados gerados pelo comprador são recolhidos da sua origem de lances de terceiros através de sinais seguros. A Google não consegue interpretar estas informações e transmite estes dados diretamente aos licitadores externos.
• Nome da classe do adaptador
• Se for detetado um erro, é indicado o tipo e a descrição do erro. Saiba como resolver problemas com o parâmetro de lances.

Detalhes sobre as origens de anúncios com hierarquia de publicação

Pode expandir cada origem de anúncios com hierarquia de publicação que não preencheu um anúncio para ver detalhes acerca do erro de ausência de preenchimento.

No caso de origens de anúncios de terceiros, as mensagens de erro são enviadas diretamente a partir da origem de anúncios. Se precisar de mais informações, consulte a origem de anúncios de terceiros.

Veja adaptadores de terceiros

Depois de invocar o inspetor de anúncios, vai ver a página Adaptadores que apresenta os seus adaptadores do SDK de terceiros e o respetivo estado. Se existir um erro no seu adaptador, saiba como resolver problemas comuns do adaptador do SDK.

Teste origens de anúncios individuais

Com o inspetor de anúncios, pode testar a configuração de uma origem de anúncios individual com hierarquia de publicação de terceiros. Isto permite-lhe confirmar se implementou corretamente o adaptador de mediação de terceiros e se a origem de anúncios está a publicar conforme previsto.

Nota: tem de inicializar o SDK de Anúncios para Dispositivos Móveis da Google antes de poder usar o teste de origens de anúncios individuais.

Para iniciar o teste de uma origem de anúncios individual, ative a opção Testar origem de anúncios individual na parte inferior da app. Em seguida, selecione a origem de anúncios que quer testar. Quando o inspetor de anúncios está ativado para testar uma origem de anúncios individual, todos os pedidos de anúncios futuros vão tentar apresentar anúncios da origem de anúncios selecionada.

Nota: no modo de teste de origens de anúncios individuais, todos os pedidos de anúncios vão tentar o preenchimento a partir da origem de anúncios selecionada, independentemente de essa origem de anúncios estar ou não associada ao bloco de anúncios em questão. Isto significa que, se a origem de anúncios que estiver a testar não estiver na hierarquia da mediação para um determinado bloco de anúncios, é apresentada a mensagem de erro "Sem preenchimento", que indica que o bloco de anúncios em questão não está configurado para a origem de anúncios.

No teste de uma origem de anúncios individual, pode tocar num bloco de anúncios para ver o respetivo registo de pedidos do SDK. Isto permite-lhe saber se a origem de anúncios preencheu os pedidos de anúncios feitos após a ativação do teste de origens de anúncios individuais. Se a origem de anúncios não tiver preenchido um pedido de anúncio, é apresentada uma mensagem de erro com detalhes sobre as causas do erro de ausência de preenchimento.

Se tiver adicionado várias instâncias da origem de anúncios selecionada a uma hierarquia da mediação, vai ver cada instância da chamada para a origem de anúncios na hierarquia de publicação até o anúncio ser preenchido ou a hierarquia de publicação terminar sem um preenchimento.

O teste de origem de anúncios individual expira automaticamente após 60 minutos.

Como forçar o reinício

Quando ativar o teste de origens de anúncios individuais, tem de forçar o reinício da app. Como algumas apps colocam anúncios em cache no arranque, reiniciar a app garante que o teste de origens de anúncios individuais é aplicado a todos os pedidos de anúncios na sessão de teste.

No caso dos dispositivos Android, normalmente pode forçar o reinício de uma app através da app Definições do telemóvel. As definições podem variar consoante o telemóvel. Para ver mais informações, consulte o fabricante do dispositivo.

Saiba como forçar o reinício de uma app em dispositivos iOS.