Resolver problemas com solicitações de anúncios na web

Neste artigo, mostramos como capturar sessões de rede HTTP usando as Ferramentas para Desenvolvedores do Chrome e resolver problemas com solicitações de anúncios da web em tempo real. Ao entender como capturar e interpretar esses dados, você pode acelerar significativamente o tempo de resolução ao identificar os problemas.

Se você precisar encaminhar o caso ao suporte do Google Ad Manager, forneça as informações precisas sobre as interações do Google Ad Manager que explicamos aqui como encontrar.

Observação: este guia é específico para o tráfego de sessões da Web. Se você precisar de informações sobre dispositivos móveis, saiba como capturar o tráfego de sessões em dispositivos móveis.

Nesta página

• Práticas recomendadas para uma captura eficaz
• Capturar sua sessão de rede HTTP (gerar um arquivo HAR)
• Interpretar o arquivo HAR para solução de problemas com anúncios
• O que fazer depois da captura e interpretação

Práticas recomendadas para uma captura eficaz

Antes de começar a capturar o tráfego de rede, siga estas práticas recomendadas para garantir que o arquivo HAR tenha dados confiáveis e relevantes para uma solução de problemas precisa:

• Usar o modo de navegação anônima: abra uma nova janela anônima no Chrome (Ctrl+Shift+N ou Cmd+Shift+N). Isso minimiza a interferência de extensões do navegador, dados armazenados em cache e sessões de login ativas, fornecendo um ambiente mais adequado para o carregamento de anúncios.
• Limpar o cache e os cookies do navegador: mesmo no modo de navegação anônima, isso é recomendável. Na janela anônima, abra as Ferramentas para Desenvolvedores (F12 ou Ctrl+Shift+I ou Cmd+Option+I), clique com o botão direito do mouse no botão de atualização ao lado da barra de endereço e selecione Esvaziar cache e recarregamento forçado.
• Desativar bloqueadores de anúncios e outras extensões que causam interferência: desative temporariamente todas as extensões do navegador que possam bloquear anúncios, modificar o conteúdo da página ou interferir em solicitações de rede (por exemplo, bloqueadores de anúncios, VPNs, extensões de segurança). Eles podem impedir o carregamento de anúncios ou alterar o tráfego de rede, distorcendo os dados para solução de problemas.
• Reproduzir o problema de modo confiável: antes de começar a gravação, verifique se você consegue reproduzir com consistência o problema do anúncio que está tentando diagnosticar. Atualize a página várias vezes, navegue até seções específicas ou interaja com a página de uma determinada maneira.

Capturar sua sessão de rede HTTP (gerar um arquivo HAR)

O arquivo HAR (arquivo HTTP) é do formato JSON e tem um registro da interação de um navegador da web com um site. Ele captura todas as solicitações e respostas, oferecendo uma linha do tempo detalhada da atividade da rede.

Para capturar um arquivo HAR no Chrome:

1. Abra as Ferramentas para Desenvolvedores do Chrome.

   1. Acesse a página da web em que o problema com o anúncio está ocorrendo.
   2. Clique com o botão direito do mouse em qualquer lugar da página e selecione Inspecionar.

2. Acesse a guia "Rede".

   • No painel "Ferramentas para Desenvolvedores", clique na guia Rede.

3. Confira se a gravação está ativa.

   1. Procure um botão circular "Gravar" (geralmente vermelho ou cinza). Se estiver cinza, clique nele uma vez para iniciar a gravação. Um círculo vermelho indica que está gravando.
   2. Confira se a caixa de seleção "Preservar registro" está marcada. Assim, o registro não será apagado quando você navegar para outras páginas ou atualizar.
   3. A caixa de seleção "Desativar cache" também pode ser útil, especialmente se você não fez um recarregamento forçado inicial.

4. Reproduza o problema do anúncio.

   1. Com as Ferramentas para Desenvolvedores abertas e gravando, realize as ações que causam o problema do anúncio. Por exemplo, atualize a página, role a tela para baixo, clique em um botão.
   2. Aguarde o carregamento completo da página e a tentativa (ou falha) de renderização anúncio. Continue gravando por alguns segundos depois que o problema aparecer.

5. Salve o arquivo HAR.

   1. Depois de reproduzir o problema e capturar o tráfego de rede relevante, clique no botão "Exportar HAR".
   2. Escolha um local no computador para salvar o arquivo HAR e dê a ele um nome descritivo (por exemplo, ad-blank-example.har).

Interpretar o arquivo HAR para solução de problemas com anúncios

A primeira etapa é capturar o arquivo HAR. É na interpretação que você pode realmente diagnosticar problemas com anúncios. Esta seção ajuda a identificar padrões comuns e pontos de dados importantes.

Padrões comuns de solicitações relacionadas a anúncios para investigar

Solicitações da Tag de publisher do Google (GPT)

Procure solicitações para www.googletagservices.com/tag/js/gpt.js. Essa é a biblioteca principal que busca anúncios. Verifique se ela carrega com o status 200 OK.

Saiba mais sobre as Tags de publisher do Google.

Chamadas do servidor de anúncios

Identifique as solicitações para o servidor de anúncios do Google Ad Manager. Elas costumam começar com securepubads.g.doubleclick.net/gampad/ads ou securepubads.g.doubleclick.net/gampad/ad.

Códigos de status HTTP:

• 200 OK: a solicitação foi bem-sucedida, e um anúncio ou uma resposta em branco (sem anúncio preenchido) foi retornado.
• 204 Sem conteúdo: geralmente indica que uma solicitação foi bem-sucedida, mas nenhum anúncio foi veiculado (por exemplo, não houve preenchimento, problemas de segmentação).
• 302 Encontrado ou 307 Redirecionamento temporário: indica um redirecionamento. Siga a cadeia de redirecionamento para saber onde a solicitação foi parar.
• 4xx Erro do cliente (por exemplo, 400 Solicitação inválida, 404 Não encontrado): indica um problema com a solicitação do lado do cliente. Isso geralmente indica IDs de blocos de anúncios incorretos, parâmetros de segmentação ou configurações de rede inválidas.
• 5xx Erro de servidor: indica um problema no servidor de anúncios.

Cabeçalhos: na guia "Cabeçalhos" da solicitação, confira "URL" da solicitação, "Método" e "Código de status". Em "Cabeçalhos da solicitação", procure parâmetros como iu (bloco de anúncios), sz (tamanho) e correlator para garantir que eles correspondam à configuração esperada.

Resposta: na guia "Resposta", inspecione o conteúdo retornado pelo servidor de anúncios. Para chamadas de anúncios bem-sucedidas, você poderá ver HTML para o criativo, XML VAST para anúncios em vídeo ou uma resposta em branco se nenhum anúncio for preenchido. Procure mensagens de erro na resposta se o anúncio tiver falhado.

Carregamento de recursos do criativo

• Depois de uma chamada do servidor de anúncios, procure solicitações subsequentes para carregar os recursos do criativo (imagens, JavaScript, rastreadores de terceiros, arquivos de vídeo). Essas solicitações costumam ter origem na resposta do servidor de anúncios.
• As origens comuns incluem pagead2.googlesyndication.com, vários URLs de CDN ou fornecedores de tecnologias de publicidade de terceiros.
• Verifique os códigos de "Status" e "Tempo" (latência). A alta latência ou falhas no carregamento do criativo (404 para uma imagem, por exemplo) podem causar anúncios em branco ou com carregamento lento.

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

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

• Verificar as chamadas da GPT: verifique se o gpt.js é carregado corretamente.
• Verifique as chamadas do servidor de anúncios (g.doubleclick.net/gampad/ads).
  • Há uma solicitação para o bloco de anúncios específico?
  • O status é 204 Sem conteúdo? Geralmente, isso significa que nenhum anúncio foi encontrado para preencher o slot (problemas de segmentação, inventário ou preços).
  • O status é um erro 4xx? Isso indica um problema com a solicitação (por exemplo, caminho incorreto do bloco de anúncios).
• Verificar a resposta: se uma resposta 200 OK ocorrer, inspecione a guia "Resposta". Há informações sobre conteúdo vazio? O status contém uma mensagem de erro do servidor de anúncios ou um criativo vazio?

Cenário 2: o anúncio está carregando lentamente

• Verificar a coluna "Tempo": ordene as solicitações de rede pela coluna "Tempo" ou pela visualização "Cascata".
• Identifique chamadas lentas do servidor de anúncios: as chamadas g.doubleclick.net/gampad/ads estão demorando muito (centenas de milissegundos ou mais)?
• Identificar carregamentos lentos de criativos: as chamadas subsequentes para recursos do criativo (imagens, JavaScript de terceiros) estão demorando muito? Isso pode indicar tamanhos de arquivo de criativos grandes ou recursos de terceiros com carregamento lento.

Saiba mais sobre a análise de cascata de rede na documentação das Ferramentas para desenvolvedores do Chrome.

Cenário 3: o anúncio não aparece corretamente (por exemplo, cortado ou com tamanho incorreto)

• Verificar a resposta da chamada do servidor de anúncios: inspecione a guia "Resposta" da chamada do servidor de anúncios. O criativo retornado corresponde ao tamanho e formato esperados?
• Procure erros de JavaScript: verifique se há erros de JavaScript relacionados à renderização do anúncio ou scripts de terceiros na guia "Console" nas Ferramentas para desenvolvedores.
• Conflitos de CSS: embora não estejam diretamente no HAR, os conflitos de CSS na sua página podem afetar a renderização. Confira a guia "Elementos" e os estilos computados para o espaço do anúncio.

Colunas principais e o que procurar

• Nome: o URL do recurso solicitado.
• Status: o código de status 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: qual recurso ou script iniciou a solicitação.
• Tamanho: o tamanho do recurso transferido.
• Tempo: a duração total da solicitação.

O que fazer depois da captura e interpretação

Depois de capturar e realizar uma análise inicial do arquivo HAR, você poderá:

Fazer o autodiagnóstico e resolver: se você identificar um problema claro (por exemplo, um código de resposta 404 em um recurso do criativo ou um código de resposta 204 devido a parâmetros de segmentação específicos), poderá resolver por conta própria ajustando a configuração do anúncio no Google Ad Manager ou modificando o código da página da Web.

Envie as seguintes informações ao suporte do Google Ad Manager:

• O próprio arquivo HAR.
• Uma descrição clara do problema: o que você esperava que acontecesse e o que realmente aconteceu.
• Etapas para reproduzir o problema: o URL, o navegador e as ações exatas.
• Carimbo de data/hora do problema: anote a data e a hora exatas (incluindo o fuso horário) em que o problema ocorreu no arquivo HAR. Isso ajuda a identificar os eventos relevantes.
• IDs de blocos de anúncios, pedidos, itens de linha ou criativos que você suspeita que estejam envolvidos.
• As descobertas iniciais da análise do arquivo HAR.

Os arquivos HAR podem ter informações sensíveis, incluindo conteúdo da página, cookies e tokens de autenticação. Ao compartilhar, preste atenção nos dados que você está fornecendo.