Como verificar se o script SeaText carrega após um redesenho ou migração

Lista de verificação rápida

Abra o site em um navegador, inicie o DevTools (F12) e execute estas cinco etapas em ordem. Cada etapa captura um modo de falha diferente para que você não dependa de um único sinal.

1. Confirme que o snippet existe no HTML entregue. Veja o código-fonte da página (não o painel Elements) e pesquise por seatext ou seu ID de projeto. Se a tag estiver ausente, o pipeline de implantação a descartou.
2. Verifique a aba Console em busca de erros. Procure por mensagens vermelhas referenciando seatext, SEATEXTCODEINTEGRATION ou scripts bloqueados. Violações de Content Security Policy e erros de origem cruzada aparecem aqui primeiro.
3. Verifique se a requisição de rede é concluída. Mude para a aba Network, filtre por "JS" ou "Script", recarregue e confirme uma resposta 200 para o carregador SeaText. Um 404 ou 403 significa que o caminho do CDN ou o ID do projeto mudou.
4. Inspecione o localStorage para o ID SeaText. Na aba Application (ou Storage), expanda Local Storage, selecione sua origem e procure por uma chave contendo seatext. A ausência significa que o script nunca executou ou o localStorage está bloqueado.
5. Valide o comportamento visível. Dispare uma tradução, variante de personalização ou evento de detecção de bot e confirme que o DOM é atualizado. Use o modo de pré-visualização do painel SeaText ou acrescente ?seatext_preview=1 para forçar uma variante.

Por que a verificação pós-migração é importante

Um redesenho frequentemente reescreve os pontos de injeção do head ou body, muda de HTML renderizado no servidor para um framework SPA, ou adiciona uma nova Content Security Policy. Qualquer uma dessas mudanças pode silenciosamente descartar a tag de script assíncrona, bloquear o domínio do CDN ou impedir o acesso ao localStorage. Como o SeaText reescreve títulos, ofertas e traduções em tempo de execução, um script ausente reverte cada página para o idioma base e a oferta base — perdendo o aumento de conversão e a evidência de reembolso de bot que a plataforma fornece.

Pré-requisitos antes de começar

• Acesso ao ambiente de staging que espelha o pipeline de build de produção.
• Familiaridade com o DevTools do navegador (abas Console, Network, Application).
• ID do projeto SeaText e hostname esperado do CDN do guia de integração.
• Permissão para editar cabeçalhos CSP ou regras de proxy se o script estiver bloqueado.
• Uma URL de teste que exercite tradução, personalização ou detecção de bot para que você possa observar a mudança no DOM.

Verificação passo a passo no staging

1. Presença do snippet na saída do build

Execute o build de produção localmente (npm run build ou equivalente) e abra o index.html gerado. Pesquise pelo snippet exato fornecido pelo SeaText. Em projetos React, Vue ou Angular, o snippet pertence ao public/index.html ou ao template raiz do framework. Se seu CI/CD usa template HTML, confirme que a variável que injeta o snippet resolve corretamente.

2. Inspeção de Console e Network

Implante no staging, abra a URL e pressione F12. Recarregue com a aba Network aberta. O carregador SeaText deve aparecer como uma requisição de script com o atributo async. Clique na requisição; a aba Response deve retornar JavaScript, não uma página de erro HTML. No Console, filtre por "seatext" — deve haver zero erros. Uma violação de CSP aparece como "Recusado a carregar o script" com a diretiva que o bloqueou.

3. Confirmação de gravação no localStorage

Após o script executar, abra Application → Local Storage → sua origem. Você deve ver uma chave como seatext_visitor_id ou similar. Se a chave estiver ausente, verifique se o site roda em um iframe com sandbox, usa uma política de cookies restritiva ou serve páginas de múltiplos subdomínios sem armazenamento compartilhado.

4. Teste funcional de fumaça

Escolha uma página que use tradução ou o agente do Google Ads. Acrescente ?seatext_preview=1 (ou use o link de pré-visualização do painel) e verifique se títulos, botões ou blocos de produto mudam. Para detecção de bot, visite a página com um user-agent de teste conhecido ou a ferramenta de teste SeaText e confirme que o painel registra uma sessão.

Verificações de go-live em produção

Repita a mesma lista de verificação de cinco etapas imediatamente após o corte de DNS. Propagação de CDN, cache de borda ou uma variável de ambiente ausente podem fazer a produção se comportar de forma diferente do staging. Agende uma janela de 15 minutos pós-lançamento para executar as verificações enquanto o tráfego está baixo. Se você usa feature flags, habilite o SeaText para uma pequena porcentagem de usuários primeiro e monitore o painel para eventos ao vivo.

Padrões comuns de falha e correções

Teste de regressão automatizado que você pode adicionar ao CI

Adicione uma etapa de navegador headless (Playwright, Cypress ou Puppeteer) que carregue o index.html construído, aguarde a requisição de rede SeaText, afirme que localStorage.getItem('seatext_visitor_id') existe e verifique se um atributo de dados conhecido (por exemplo, data-seatext-variant) aparece em um elemento alvo. Falhe o build se qualquer asserção falhar. Isso captura regressões antes que cheguem ao staging.

Fatos-chave

Limitações

Esta lista de verificação cobre apenas o carregamento no lado do cliente. Ela não verifica caminhos de renderização no servidor, reescritas de edge-worker ou personalização no nível de API que o SeaText possa introduzir em versões futuras. Se sua stack mover a renderização para a borda, adicione uma verificação de log de borda correspondente. As etapas também assumem que você controla a entrega do HTML; se uma plataforma de terceiros injeta o snippet, coordene o ciclo de lançamento deles.

FAQ

Como sei qual domínio de CDN permitir no CSP?

Abra a aba Network em uma página funcional, clique na requisição do script SeaText e copie o hostname da URL da requisição. Essa é a origem exata para colocar na lista de permissões.

Posso verificar o script sem o DevTools do navegador?

Sim. Execute um monitor sintético (por exemplo, Datadog, Pingdom ou um script Playwright personalizado) que afirme que a URL do script retorna 200 e que o corpo da resposta contém SEATEXTCODEINTEGRATION.

E se o site usar um CSP estrito com nonces?

Gere um nonce no momento da renderização e adicione-o à tag do script SeaText: <script nonce="{{nonce}}" src="..." async></script>. O nonce deve corresponder ao cabeçalho CSP para essa resposta.

O atributo async atrasa a tradução?

O script carrega assincronamente, mas o SeaText reescreve o DOM após executar. Para conteúdo acima da dobra, considere adicionar fetchpriority="high" à tag do script ou incluir um pequeno bootstrap que inicie o carregador mais cedo.

Com que frequência devo reexecutar essas verificações?

Após cada implantação que toque no template HTML, cabeçalhos CSP, estrutura de domínio ou políticas de cookie/armazenamento. Um teste sintético mensal agendado é uma boa rede de segurança.

Onde encontro o snippet atual se ele mudou?

Entre no painel SeaText, abra Instalação → Integração Geral e copie o snippet rotulado como "SEATEXTCODEINTEGRATION".

Próximos passos

Adicione o teste de regressão de CI nesta sprint. Agende uma janela de verificação de 15 minutos pós-lançamento para a próxima migração. Mantenha a lista de verificação em seu runbook para que qualquer engenheiro possa executá-la sem conhecimento tribal.