← Casos Integração 21 out 2026 · PageBrick 1.11.0

Um campo que aceita um script e mais nada

O Path Ranker, uma ferramenta de diagnóstico de sites do mesmo autor, precisava do seu coletor de comportamento nos sites que rodam o PageBrick. A resposta foi um campo em Configurações que aceita esse script e mais nada, feito, testado e publicado no mesmo dia.

  • 1script aceito: uma tag, um endereço, uma chave
  • 11testes novos para o campo, numa suíte de 413
  • 28conferências num navegador de verdade: páginas públicas, painel, editor e pré-visualização
  • 34 / 34conferências na atualização da 1.10.0, contra o catálogo real

O problema

O coletor é um <script> que mede cliques, rolagem, formulários e erros de JavaScript de visitantes reais. Para alcançar todas as páginas ele precisa ser colocado em todas as páginas públicas, o que transforma o campo que o recebe num ponto de injeção: o que fosse colado ali sairia no site inteiro, para todo visitante.

A decisão

Uma caixa de código livre era o caminho fácil e foi recusada. O campo aceita exatamente uma tag <script>, sem nada antes, depois ou dentro dela. O endereço precisa ser https (http só para localhost) e terminar em /pr-collect.js; os únicos atributos são src, data-key, data-site, defer e async. O PageBrick tira os três valores, confere e escreve a tag de novo com cada atributo escapado. O que foi digitado nunca é devolvido, e os valores guardados são conferidos de novo cada vez que a tag é escrita, então um valor alterado por trás do painel não imprime nada.

A tag vai no <head> das páginas públicas de um site no ar, para quem não está logado; nunca no painel, no editor ou numa pré-visualização. Ela não espera o aviso de cookies porque o Path Ranker informa que o coletor não usa cookies e respeita Do Not Track e Global Privacy Control; a tela de Configurações diz isso e atribui a afirmação ao Path Ranker.

A prova

Os testes tentam as formas de dar errado: um segundo script ao lado do primeiro, um atributo onload, um type, outro endereço, //host, javascript:, uma query string, usuário e senha no endereço, uma chave com aspas, texto em volta da tag e um valor guardado alterado no banco. Num navegador de verdade a tag aparece uma vez, no <head>, com defer e quatro atributos, para o visitante; e não aparece para quem está logado, no painel, na pré-visualização ao lado do editor nem na pré-visualização de um rascunho. O Path Ranker confirmou que as chaves dele têm 32 caracteres hexadecimais minúsculos, dentro do que o campo aceita.

O resultado

Publicado como PageBrick 1.11.0 em 21 de outubro de 2026, no mesmo dia do pedido. A atualização da 1.10.0 foi conferida mais uma vez contra o catálogo real: 34 de 34. A mesma tela já tinha o Google Analytics e o pixel da Meta, então um site agora mede tráfego e comportamento sem mexer no tema.

O que ficou

Um campo que põe código em todas as páginas deve aceitar o mínimo que funciona e devolver só o que ele mesmo escreveu.