Suporte/Solução de problemas
Solução de problemas

Script do Flowsery Analytics bloqueado pela Content Security Policy (CSP)

Se você adicionou o snippet de rastreamento do Flowsery Analytics e nenhum pageview está aparecendo, é muito provável que os cabeçalhos de Content Security Policy (CSP) do seu site estejam impedindo o carregamento.

Diagnosticar um problema de CSP

  1. Abra seu site no Chrome ou Firefox
  2. Abra as DevTools (F12 ou Cmd+Shift+I)
  3. Vá para a aba Console
  4. Procure um erro semelhante a:
Text
Refused to load the script 'https://cdn.flowsery.com/main.js' because it violates the following Content Security Policy directive: "script-src 'self'"

Se essa mensagem aparecer, as regras CSP estão impedindo a execução do script do Flowsery Analytics.

Entender a Content Security Policy

Uma CSP é um cabeçalho HTTP que instrui os navegadores sobre quais recursos externos (scripts, stylesheets, imagens, etc.) podem ser carregados em uma página. Quando cdn.flowsery.com não está incluído na política, o navegador bloqueia o script silenciosamente -- e nenhum dado é coletado.

Resolver o problema

Adicione cdn.flowsery.com à diretiva script-src dentro do seu cabeçalho CSP. Os passos específicos variam por plataforma.

Next.js

Atualize o cabeçalho Content-Security-Policy dentro do seu next.config.js:

JavaScript
const ContentSecurityPolicy = `
  script-src 'self' 'unsafe-inline' 'unsafe-eval' https://cdn.flowsery.com;
`;
 
module.exports = {
  async headers() {
    return [
      {
        source: '/(.*)',
        headers: [
          {
            key: 'Content-Security-Policy',
            value: ContentSecurityPolicy.replace(/\n/g, ''),
          },
        ],
      },
    ];
  },
};
JSON
{
  "headers": [
    {
      "source": "/(.*)",
      "headers": [{ "key": "Content-Security-Policy", "value": "script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;" }]
    }
  ]
}
Text
/*
  Content-Security-Policy: script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;

Tag meta HTML

Quando você não consegue modificar os cabeçalhos do servidor, uma tag meta dentro do <head> é uma alternativa:

HTML
<meta http-equiv="Content-Security-Policy" content="script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;" />

Observe que essa abordagem só tem efeito quando não há nenhum cabeçalho CSP no nível do servidor -- os cabeçalhos do servidor sempre substituem as tags meta.

Nginx

Nginx
add_header Content-Security-Policy "script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;" always;
APACHE
Header set Content-Security-Policy "script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;"

WordPress

Se você usa um plugin de segurança como WP Cerber, Sucuri ou Wordfence, vá até as configurações de CSP ou "HTTP headers" e adicione https://cdn.flowsery.com à lista de fontes de script permitidas.

Quando seu tema configura a CSP diretamente no functions.php:

PHP
header("Content-Security-Policy: script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;");

Executando atrás de um proxy?

Se você configurou um proxy para o Flowsery Analytics, o script é servido pelo seu próprio domínio. Nesse cenário, 'self' na sua CSP já o permite, então nenhuma alteração adicional deve ser necessária. Se os problemas continuarem com o proxy, verifique se o endpoint do proxy está no mesmo domínio que seu website.

Usando connect-src?

Se sua CSP também limita connect-src (que controla para onde o navegador pode enviar dados via fetch/XHR), inclua analytics.flowsery.com nessa diretiva também:

Text
Content-Security-Policy: script-src 'self' https://cdn.flowsery.com; connect-src 'self' https://analytics.flowsery.com;

Ainda com problemas?

  • Confirme que você está modificando o cabeçalho CSP ativo. Certos provedores de hospedagem ou CDNs podem substituir cabeçalhos.
  • Procure múltiplos cabeçalhos CSP -- os navegadores aplicam a combinação mais restritiva de todos os cabeçalhos presentes.
  • Limpe o cache do navegador e teste novamente em uma janela privada/anônima.
  • Quando usar um proxy, verifique se tanto script-src quanto connect-src incluem seu domínio de proxy.