Como corrigir visualizações em falta no Plausible
1. Identifique quais são as visualizações de página em falta
Comece por um URL que não esteja a ser registado. Anote o endereço da página, a hora a que fez o teste e se o relatório do Plausible mostra visitas a outras páginas do mesmo site. Se as visualizações de página não aparecem no Plausible, um exemplo concreto, como uma página de produto que não aparece enquanto a página inicial aparece, é mais útil do que dizer «as estatísticas não funcionam».
Compare a página em causa com outra cujo tráfego é registado corretamente. Verifique se ambas usam o mesmo modelo, são carregadas a partir do mesmo nome de anfitrião e aparecem no mesmo site do Plausible. Qualquer diferença nestes detalhes dá-lhe um ponto de partida para investigar antes de alterar o código.
Distinga as visitas diretas da navegação dentro do site. Abra o URL em causa num novo separador e, em seguida, aceda à página clicando numa ligação de outra página. Se as visitas diretas aparecerem no relatório, mas os cliques não, o problema pode estar relacionado com a forma como o site gere a navegação. Se não aparecer nenhuma das duas, comece por verificar o código de acompanhamento ou as condições do navegador.
Mantenha um registo breve dos testes. Anote o URL exato, o percurso seguido para chegar à página, o navegador e o resultado observado. Assim, poderá repetir o mesmo teste depois de fazer uma alteração, em vez de confiar na memória.
2. Verifique se o navegador envia um evento de visualização de página
Abra a página em causa e as ferramentas de programador do navegador. No painel Rede, volte a carregar a página e procure pedidos relacionados com o Plausible.
Se encontrar um pedido, analise os respetivos detalhes em vez de se ficar por «foi carregado». Verifique se o URL da página no pedido corresponde à página em causa, se o pedido foi concluído e se o navegador indica que foi bloqueado ou falhou. Se o pedido indicar a página inicial em vez de um percurso secundário, o problema poderá estar relacionado com o tratamento dos URL, e não necessariamente com a ausência do script.
Se não aparecer nenhum pedido, comece por verificar os filtros do painel Rede. Um filtro de texto pode ocultar o pedido que procura, e um registo preservado pode misturar a atividade de carregamentos anteriores com o teste atual. Limpe o filtro, volte a carregar a página uma vez e analise a nova atividade.
Use o painel Consola como segunda verificação. Um erro ao carregar um script, uma mensagem relativa à política de segurança de conteúdos ou uma exceção de JavaScript podem explicar por que motivo o pedido nunca é enviado. Copie a mensagem exata e o URL da página em causa antes de alterar o que quer que seja. Estes dois detalhes ajudam a distinguir um erro do site de um bloqueio do navegador.
Para perceber como corrigir a falta de registo de visualizações de página no Plausible, comece por confirmar se o navegador envia algum pedido de visualização de página. Esta observação simples restringe os passos seguintes: se não houver pedido, investigue a execução do script; se houver, analise o pedido e a configuração do relatório. Quando o Plausible não regista visitas a páginas, esta verificação ajuda a identificar se o problema está no envio do evento ou na apresentação dos dados.
3. Exclua bloqueios do navegador e do consentimento
Repita o teste num perfil de navegador limpo ou numa janela privada, com as extensões desativadas, se possível. Os bloqueadores de anúncios, a proteção contra rastreio e as extensões de privacidade podem impedir o envio de pedidos de análise. Por isso, o resultado num único navegador não basta para concluir que todos os visitantes enfrentam o mesmo problema.
Teste o fluxo de consentimento como faria um visitante. Carregue a página antes de fazer uma escolha, aceite o consentimento para análise, se o site o solicitar, e volte a carregar a página ou a aceder ao percurso em causa. Se o pedido só aparecer depois de dar o consentimento, verifique a configuração do gestor de consentimento e confirme que a respetiva categoria de análise está ligada ao script do Plausible.
Não considere, por si só, a recusa do consentimento para análise opcional como um erro. O importante é confirmar se o comportamento corresponde às regras de consentimento pretendidas para o site e à configuração utilizada. Para saber mais sobre opções de medição centradas na privacidade, consulte o que mudou nas ferramentas de análise centradas na privacidade.
Verifique na Consola se há erros que só aparecem depois de o aviso de consentimento ser carregado. Se o script do aviso falhar antes de ativar o script de análise, a página pode parecer normal, embora o pedido de acompanhamento continue ausente. Se o aviso estiver na origem do problema, teste se é possível interagir com os respetivos controlos através do teclado. Este guia explica como verificar se um site publica uma declaração de acessibilidade.
4. Compare o código de acompanhamento apresentado na página em causa
Inspecione a página tal como é apresentada no navegador, não apenas o ficheiro de origem ou a configuração do sistema de gestão de conteúdos. Para saber como verificar o código de acompanhamento do Plausible, compare o código apresentado num URL funcional com o de um URL em que o acompanhamento falha. Um modelo pode não incluir o código de acompanhamento num determinado tipo de página, ou um gestor de etiquetas pode inseri-lo apenas em certos percursos.
Procure o script do Plausible e o valor do site ou domínio associado. Um erro no domínio configurado ou um nome de anfitrião diferente daquele que está registado para o site pode levá-lo a procurar no relatório errado.
Verifique se o script está presente mais do que uma vez. Uma instalação duplicada pode complicar os testes e dificultar a interpretação dos resultados. Se as duas páginas forem diferentes, identifique o sistema que fornece o código — por exemplo, o modelo da página, o gestor de etiquetas ou um módulo — e faça a correção nesse local, em vez de adicionar outra cópia manualmente.
Ao comparar o código apresentado, tenha em conta o momento em que o script é carregado. Um gestor de consentimento ou de etiquetas pode adicionar o script depois de o HTML inicial ter sido carregado, pelo que uma consulta rápida ao código-fonte da página poderá não mostrar o estado final. Utilize em conjunto os painéis Elementos e Rede do navegador para ver se o elemento do script aparece e se o navegador faz o respetivo pedido.
5. Teste os carregamentos diretos separadamente da navegação do lado do cliente
Abra o percurso em causa diretamente num novo separador e, em seguida, navegue até ele a partir de outra página sem voltar a carregar o documento. Registe o resultado de cada percurso. Um site criado como aplicação de página única pode alterar o percurso apresentado sem que o navegador carregue um novo documento. Por isso, verifique se essa navegação gera uma visualização de página.
Se os carregamentos diretos forem contabilizados, mas os cliques dentro do site não, verifique se o router do site e a integração do Plausible suportam a navegação do lado do cliente. Consulte a documentação da integração para saber como são tratadas as alterações de percurso.
Se a navegação for contabilizada, mas o carregamento direto não, inspecione a resposta inicial da página e o modelo do percurso. O servidor pode fornecer um documento diferente ou omitir o código de acompanhamento nesse percurso. Compare o código apresentado e os detalhes do pedido do carregamento inicial com os registados após um clique.
Teste um percurso com parâmetros de consulta ou uma barra final apenas se os visitantes utilizarem realmente essas variantes. Nestes casos, o URL registado pelo navegador pode ser diferente daquele que espera encontrar no relatório. Anote o endereço exato, em vez de presumir que dois URL visualmente semelhantes são tratados da mesma forma.
6. Verifique o âmbito e os filtros do relatório do Plausible
Antes de considerar que a ausência de uma linha se deve a uma falha na recolha de dados, confirme se o painel mostra o site pretendido no Plausible. Um relatório de um domínio de teste, de um nome de anfitrião alternativo ou de um projeto com um nome semelhante não permite saber se a visualização de página de produção foi registada.
Defina um intervalo de datas que inclua o teste e reveja os filtros ou segmentos aplicados ao relatório. Um intervalo de datas demasiado restrito ou um filtro ativo pode ocultar uma página que foi registada. Se tiver feito o teste a uma hora conhecida, utilize essa hora para relacionar a verificação do relatório com o teste no navegador.
Pesquise ou consulte o relatório de páginas utilizando o mesmo percurso enviado pelo navegador, incluindo qualquer barra final ou cadeia de consulta relevante.
Distinga também uma visualização de página de um evento personalizado. Se a implementação enviar um evento com nome quando um percurso é carregado, verifique o pedido e procure esse evento na secção adequada do relatório, em vez de presumir que se trata de uma visualização de página normal.
7. Volte a testar a correção nos casos em que o problema ocorre
Altere uma coisa de cada vez. Se corrigiu um valor de domínio, volte a testar antes de também alterar as regras de consentimento ou o código do router. Uma única alteração permite perceber se o pedido começou a funcionar e evita que um segundo problema oculte o primeiro.
Repita os testes originais: carregue diretamente cada URL em causa, aceda a cada um através de uma ligação interna e compare ambos os resultados com os de uma página que funciona corretamente. Utilize as mesmas condições do navegador e a mesma opção de consentimento que registou anteriormente. Se o site utilizar vários modelos, inclua um exemplo com falhas de cada modelo afetado.
Em cada teste, confirme dois pontos: o navegador envia o pedido de visualização de página esperado para o URL correto e a nova visualização de página aparece no relatório do site pretendido no Plausible. Se o pedido estiver presente, mas o relatório continuar vazio, volte a verificar o site selecionado, o intervalo de datas e os filtros antes de alterar novamente o código do site.
Guarde o registo do teste bem-sucedido com a alteração ao código ou o pedido de assistência. Inclua os URL em causa, os resultados no navegador, os erros relevantes da Consola e o âmbito do relatório que verificou. Assim, a pessoa seguinte terá um teste que pode repetir, em vez de uma descrição vaga de visualizações de página em falta.
