Resolva problemas de pedidos de anúncios da Web

Este artigo explica como captar sessões de rede HTTP com as Ferramentas para programadores do Chrome de modo a resolver problemas de pedidos de anúncios da Web em tempo real. Reduza significativamente o tempo de resolução de problemas compreendendo como captar e interpretar estes dados e identificando os problemas.

Se precisar de encaminhar o problema para o apoio técnico do Google Ad Manager, é fundamental fornecer as informações precisas sobre as interações com o Google Ad Manager que vai aprender a encontrar aqui.

Nota: este guia é específico do tráfego de sessões da Web. Se precisar de informações sobre dispositivos móveis, pode saber como captar tráfego de sessões de dispositivos móveis.

Nesta página

• Práticas recomendadas para uma captação eficaz
• Capte a sua sessão de rede HTTP (gere um ficheiro HAR)
• Interprete o ficheiro HAR para resolver problemas de anúncios
• O que fazer depois de captar e interpretar

Práticas recomendadas para uma captação eficaz

Antes de começar a captar o tráfego de rede, siga estas práticas recomendadas para ajudar a garantir que o ficheiro HAR contém dados fiáveis e relevantes para uma resolução de problemas precisa:

• Use o Modo de navegação anónima: abra uma nova janela de navegação anónima no Chrome (Ctrl+Shift+N ou Cmd+Shift+N). Isto minimiza a interferência de extensões do navegador, dados em cache e sessões de início de sessão existentes, proporcionando um ambiente com menos interferências em termos de carregamento de anúncios.
• Limpe a cache e os cookies do navegador: mesmo no Modo de navegação anónima, é recomendável garantir um começo de raiz. Na janela de navegação anónima, abra as Ferramentas para programadores (F12 ou Ctrl+Shift+I ou Cmd+Option+I), clique com o botão direito do rato no botão de atualização junto à barra de endereço e selecione Empty Cache and Hard Reload.
• Desative os bloqueadores de anúncios e outras extensões que interfiram: desative temporariamente todas as extensões do navegador que possam bloquear anúncios, modificar o conteúdo da página ou interferir com pedidos de rede (por exemplo, bloqueadores de anúncios, VPNs e extensões de segurança). Estes podem impedir o carregamento de anúncios ou alterar o tráfego de rede, distorcendo os dados de resolução de problemas.
• Reproduza o problema de forma fiável: antes de iniciar a gravação, certifique-se de que consegue reproduzir de forma consistente o problema do anúncio que está a tentar diagnosticar. Isto pode envolver a atualização da página várias vezes, a navegação para secções específicas ou a interação com a página de uma determinada forma.

Capte a sua sessão de rede HTTP (gere um ficheiro HAR)

Um ficheiro de arquivo HTTP (HAR) é um ficheiro de arquivo no formato JSON que contém um registo da interação de um navegador de Internet com um site. Capta todos os pedidos e respostas, fornecendo uma linha cronológica detalhada da atividade da rede.

Para captar um ficheiro HAR no Chrome:

1. Abra as Ferramentas para programadores do Chrome

   1. Navegue para a página Web onde o problema com o anúncio está a ocorrer.
   2. Clique com o botão direito do rato em qualquer parte da página e selecione Inspecionar.

2. Aceda ao separador "Rede"

   • No painel Ferramentas para programadores, clique no separador Rede.

3. Certifique-se de que a gravação está ativa

   1. Procure um botão redondo "Gravar" (frequentemente vermelho ou cinzento). Se estiver a cinzento, clique uma vez no mesmo para iniciar a gravação. Um círculo vermelho indica que a gravação está ativa.
   2. Certifique-se de que a caixa de verificação "Preservar registo" está selecionada. Isto garante que o registo não é limpo quando navega para páginas diferentes ou atualiza.
   3. A caixa de verificação "Desativar cache" também pode ser útil, especialmente se não tiver feito uma "atualização forçada" inicialmente.

4. Reproduza o problema do anúncio

   1. Com as Ferramentas para programadores abertas e a gravar, realize as ações que causam o problema do anúncio (por exemplo, atualize a página, desloque a página para baixo ou clique num botão).
   2. Permita que a página seja carregada completamente e que o anúncio tente ser renderizado (ou não seja renderizado). Continue a gravar durante alguns segundos após o problema se manifestar.

5. Guarde o ficheiro HAR

   1. Depois de reproduzir o problema e captar o tráfego de rede relevante, clique no botão "Exportar HAR".
   2. Escolha uma localização no computador para guardar o ficheiro HAR e atribua-lhe um nome descritivo (por exemplo, ad-blank-example.har).

Interprete o ficheiro HAR para resolver problemas de anúncios

A captação do ficheiro HAR é o primeiro passo. A interpretação do mesmo é onde pode realmente diagnosticar problemas de anúncios. Esta secção ajuda a identificar padrões comuns e pontos de dados importantes.

Padrões de pedidos relacionados com anúncios comuns a investigar

Pedidos da Etiqueta do Publicador Google (GPT)

Procure pedidos para www.googletagservices.com/tag/js/gpt.js. Esta é a biblioteca principal que obtém anúncios. Certifique-se de que é carregado com o estado 200 OK.

Saiba mais acerca das Etiquetas do Publicador Google.

Chamadas do servidor de anúncios

Identifique os pedidos ao seu servidor de anúncios do Google Ad Manager, que começam normalmente por securepubads.g.doubleclick.net/gampad/ads ou securepubads.g.doubleclick.net/gampad/ad.

Códigos de estado HTTP

• 200 OK: o pedido foi bem-sucedido e foi devolvido um anúncio ou uma resposta em branco (sem anúncio preenchido).
• 204 Sem conteúdo: indica frequentemente um pedido bem-sucedido, mas não foi publicado nenhum anúncio (por exemplo, sem preenchimento, problemas de segmentação).
• 302 Found ou 307 Temporary Redirect: indica um redirecionamento. Siga a cadeia de redirecionamento para ver onde o pedido acabou por ser direcionado.
• 4xx Client Error (por exemplo, 400 Bad Request, 404 Not Found): indica um problema com o pedido do lado do cliente. Muitas vezes, isto indica IDs de blocos de anúncios, parâmetros de segmentação ou configurações de rede inválidos.
• 5xx Server Error: indica um problema do lado do servidor de anúncios.

Cabeçalhos: no separador "Cabeçalhos" do pedido, verifique "URL do pedido", "Método" e "Código de estado". Em "Cabeçalhos do pedido", procure parâmetros como iu (bloco de anúncios), sz (tamanho) e correlator para garantir que correspondem à configuração esperada.

Resposta: no separador "Resposta", inspecione o conteúdo devolvido pelo servidor de anúncios. Para chamadas de anúncios bem-sucedidas, pode ver HTML para o criativo, XML VAST para anúncios de vídeo ou uma resposta em branco se não tiver sido preenchido nenhum anúncio. Procure mensagens de erro na resposta se o anúncio tiver falhado.

Carregamento de recursos do criativo

• Após uma chamada do servidor de anúncios, procure pedidos subsequentes para carregar os recursos do criativo reais (imagens, JavaScript, acompanhamentos de terceiros e ficheiros de vídeo). Normalmente, estes pedidos têm origem na resposta do servidor de anúncios.
• As origens comuns incluem pagead2.googlesyndication.com, vários URLs de RFC ou fornecedores de tecnologia de anúncios de terceiros.
• Verifique os respetivos códigos "Estado" e "Tempo" (latência). Uma latência elevada ou falhas nas carregamentos de criativos (404 para uma imagem, por exemplo) podem causar anúncios em branco ou de carregamento lento.

Cenários de resolução de problemas comuns de anúncios e o que procurar no ficheiro HAR

Cenário 1: o espaço de anúncio está em branco/vazio

• Verifique as chamadas da GPT: certifique-se de que a gpt.js é carregada corretamente.
• Verifique as chamadas do servidor de anúncios (g.doubleclick.net/gampad/ads)
  • Existe um pedido para o bloco de anúncios específico?
  • O estado é 204 Sem conteúdo? Normalmente, isto significa que não foi encontrado nenhum anúncio para preencher o espaço (problemas de segmentação, inventário ou preços).
  • O estado é um erro 4xx? Isto indica um problema com o próprio pedido (por exemplo, caminho do bloco de anúncios incorreto).
• Verificar resposta: se ocorrer uma resposta 200 OK, inspecione o separador "Resposta". Está vazio? Contém uma mensagem de erro do servidor de anúncios ou um criativo vazio?

Cenário 2: o anúncio está a carregar lentamente

• Selecione a coluna "Hora": ordene os pedidos de rede pela coluna "Hora" (ou pela vista "Hierarquia de publicação").
• Identifique chamadas lentas do servidor de anúncios: as chamadas g.doubleclick.net/gampad/ads estão a demorar muito tempo (centenas de milissegundos ou mais)?
• Identifique carregamentos de criativos lentos: as chamadas subsequentes para recursos do criativo (imagens, JavaScript de terceiros) estão a demorar demasiado tempo? Isto pode indicar tamanhos de ficheiros de criativos grandes ou recursos de terceiros com carregamento lento.

Saiba mais acerca da análise de hierarquia da rede na documentação das Ferramentas para programadores do Chrome.

Cenário 3: o anúncio não está a ser apresentado corretamente (por exemplo, foi recortado ou tem o tamanho errado)

• Verifique a resposta da chamada do servidor de anúncios: inspecione o separador "Resposta" da chamada do servidor de anúncios. O criativo devolvido corresponde ao tamanho e formato esperados?
• Procure erros de JavaScript: verifique se existem erros de JavaScript relacionados com a renderização de anúncios ou scripts de terceiros no separador "Consola" das Ferramentas para programadores.
• Conflitos de CSS: embora não estejam diretamente na HAR, os conflitos de CSS na sua página podem afetar a renderização. Consulte o separador "Elementos" e os estilos calculados do espaço de anúncios.

Colunas principais e o que procurar

• Nome: o URL do recurso pedido.
• Estado: o Código de estado HTTP da resposta (por exemplo, 200 OK ou 404 Not Found).
• Tipo: o tipo MIME do recurso (por exemplo, "document", "script", "image" ou "xhr").
• Iniciador: o recurso ou o script que iniciou o pedido.
• Tamanho: o tamanho do recurso transferido.
• Hora: a duração total do pedido.

O que fazer depois de captar e interpretar

Depois de captar e fazer uma revisão inicial do ficheiro HAR, pode:

Fazer o autodiagnóstico e resolver: se identificou um problema evidente (por exemplo, um código de resposta 404 num recurso do criativo, um código de resposta 204 devido a parâmetros de segmentação específicos), pode resolvê-lo autonomamente ajustando a configuração no Google Ad Manager ou modificando o código da página Web.

Forneça as seguintes informações ao apoio técnico do Google Ad Manager:

• O próprio ficheiro HAR.
• Uma descrição clara do problema: o que esperava que acontecesse vs. o que aconteceu realmente.
• Passos para reproduzir o problema: o URL, o navegador e as ações exatos.
• Indicação de tempo do problema: tome nota da data e hora exatas (incluindo o fuso horário) em que o problema ocorreu no ficheiro HAR. Isto ajuda a identificar os eventos relevantes.
• IDs de blocos de anúncios, IDs de encomendas, IDs de elementos publicitários ou IDs de criativos que suspeita estarem envolvidos.
• Quaisquer conclusões iniciais da análise do ficheiro HAR.

Os ficheiros HAR podem conter informações confidenciais, incluindo conteúdo da página, cookies e tokens de autenticação. Quando os partilhar, tenha em atenção os dados que está a fornecer.