Como Adicionar o Snippet de IA SeaText ao Seu Site para Integração Geral
Copie o snippet de IA SeaText do seu painel e cole-o no <head> de cada página que deseja personalizar. Verifique se o script carrega, confirme que os agentes estão ativos e solucione problemas comuns.

Adicionar o snippet de IA SeaText ao seu site leva menos de um minuto. O snippet é uma pequena tag JavaScript que carrega de forma assíncrona, armazena um ID de visitante no localStorage e começa a reescrever textos, traduzir conteúdo ou corresponder páginas de destino a palavras-chave de anúncios, dependendo de quais agentes você ativar.
O que o snippet faz e por que isso importa
O snippet SeaText injeta um script de cliente leve (menos de 15 KB) na página. Quando o script é executado, ele lê parâmetros de URL, contexto do visitante e configurações de idioma. Em seguida, ativa os agentes de IA que você ativou no painel. Os agentes podem reescrever títulos, traduzir texto ou corresponder páginas de destino a palavras-chave de pesquisa paga.
Isso importa porque permite que uma única página canônica sirva muitas experiências personalizadas. Você evita criar dezenas de páginas de destino estáticas, reduz a taxa de rejeição e melhora as métricas de conversão.
Como o snippet se comporta no carregamento da página
O snippet inclui o atributo async, então o navegador o busca sem bloquear a renderização. De acordo com a documentação, o script é executado em menos de 15 ms antes da primeira pintura. Esse tempo garante nenhuma mudança visual (CLS = 0) e preserva as pontuações do PageSpeed.
No carregamento, o script grava um ID de visitante único no localStorage. O ID persiste entre visualizações de página e sessões, permitindo que os agentes mantenham continuidade para o mesmo usuário.
Se a página for um aplicativo de página única (SPA), o snippet é executado uma vez quando o shell HTML inicial carrega. Mudanças de rota subsequentes não recarregam o script, então os agentes continuam funcionando enquanto o SPA não recarregar a página.
Pré-requisitos antes de começar
Você precisa de uma conta SeaText e um projeto ativo. Faça login, abra o projeto e copie o snippet rotulado como SEATEXTCODEINTEGRATION da página de instalação. O snippet já inclui o atributo async, então não bloqueará a renderização da página. Seu site deve permitir scripts de terceiros e permitir acesso ao localStorage; caso contrário, o ID do visitante não pode persistir entre sessões.
Se o seu site abrange vários domínios ou subdomínios, confirme que o script pode carregar entre origens sem ser bloqueado por cabeçalhos de Política de Segurança de Conteúdo (CSP). A documentação observa que problemas de origem cruzada podem impedir que o snippet inicialize em domínios secundários.
Integração geral para sites tradicionais de várias páginas
- Abra o modelo HTML ou arquivo de layout que envolve cada página (geralmente
header.php,layout.htmlou um_Layout.cshtmlcompartilhado). - Cole o snippet dentro da tag
<head>, antes de qualquer outro script de terceiros. - Salve e implante a alteração em staging ou produção.
- Visite algumas páginas e abra as Ferramentas do Desenvolvedor (F12). Nas abas Console e Rede, você deve ver o script SeaText carregar sem erros.
Isso é tudo o que é necessário para sites padrão renderizados no servidor. O snippet será executado em cada visualização de página e aplicará os agentes ativos automaticamente.
Integração para aplicativos de página única (React, Vue, Angular)
SPAs montam uma vez e depois trocam visualizações no lado do cliente, então o snippet deve estar no shell HTML inicial ou no arquivo de bootstrap do framework.
React
- Localize
public/index.html(Create React App) ou seu ponto de entrada HTML personalizado. - Insira o snippet dentro da tag
<body>, logo antes do fechamento</body>. - Execute
npm startou seu comando de build e verifique no Console se o script carrega.
Vue.js
- Abra
index.htmlna raiz do projeto (Vite) oupublic/index.html(Vue CLI). - Coloque o snippet na seção
<body>. - Execute
npm run servee verifique na aba Rede a solicitação SeaText.
Angular
- Edite
src/index.html. - Adicione o snippet dentro de
<body>. - Execute
ng servee confirme que o script aparece no Console sem violações de CSP.
A documentação enfatiza identificar o ponto de entrada do SPA — tipicamente index.html ou o arquivo principal de bootstrap TypeScript — e inserir o snippet lá para que ele carregue antes da primeira rota renderizar.
Integração com gerenciadores de tags e ferramentas de consentimento
Se você usa o Google Tag Manager (GTM) ou outro gerenciador de tags, crie uma tag HTML personalizada que contenha o snippet SeaText. Configure a tag para disparar em Page View – All Pages e coloque-a no topo da sequência de tags. Isso garante que o script seja executado antes de outras tags de marketing.
Quando uma plataforma de gerenciamento de consentimento bloqueia localStorage ou scripts de terceiros, o snippet não pode armazenar o ID do visitante e pulará a personalização. Configure sua ferramenta de consentimento para permitir o domínio SeaText e o acesso ao localStorage após o usuário dar consentimento de marketing.
Considerações de desempenho e privacidade
O snippet tem menos de 15 KB e carrega de forma assíncrona, então adiciona largura de banda insignificante. O tempo de execução é medido em menos de 15 ms antes da primeira pintura, mantendo o Cumulative Layout Shift em zero (CLS = 0). Esse perfil de desempenho atende aos limites do Core Web Vitals.
Em termos de privacidade, o script apenas grava um identificador aleatório no localStorage. Nenhum dado pessoal é enviado até que um agente precise buscar conteúdo dos servidores da SeaText. Todas as chamadas de rede são feitas via HTTPS.
Se você opera sob regulamentações de privacidade rigorosas, pode desativar o snippet por meio de uma flag de camada de dados até que o usuário consinta. O snippet permanecerá ocioso e não criará o ID no localStorage.
Etapas de verificação que se aplicam a toda integração
- Compile e sirva seu aplicativo usando o comando padrão para sua stack.
- Abra as Ferramentas do Desenvolvedor (F12) e mude para as abas Console e Rede.
- Confirme que o script SeaText carrega com status 200 e sem mensagens de erro vermelhas.
- Verifique o localStorage: digite
localStorage.getItem('seatext_visitor_id')no Console. Um valor não nulo significa que o ID foi criado. - Verificação de funcionalidade: acione um agente ativo (por exemplo, adicione
utm_term=shoesà URL para testar correspondência de palavras-chave, ou mude o idioma do navegador para testar tradução).
Se qualquer etapa falhar, vá para a seção de solução de problemas.
Solução de problemas
- Bloqueios de CSP: Certifique-se de que sua Política de Segurança de Conteúdo inclua
script-src https://cdn.seatext.comeconnect-src https://api.seatext.com. Adicioneunsafe-inlineapenas se precisar permitir o snippet inline (o snippet fornecido é autocontido, então isso raramente é necessário). - Erros de origem cruzada: Verifique se a URL do script é acessível de todos os domínios. Se você hospedar o snippet em um CDN, coloque esse domínio na lista de permissões do seu CSP.
- localStorage indisponível: O modo privado/anônimo ou consentimento de cookies estrito pode desativar o localStorage. O console mostrará um aviso como “localStorage is not available”. Ajuste suas configurações de consentimento ou use sessionStorage como fallback.
- Snippet não disparando no GTM: Verifique se a tag HTML personalizada está configurada para disparar antes de outras tags. Use o modo de pré-visualização do GTM para ver a ordem das tags.
- Múltiplos domínios: Adicione cada domínio nas configurações do projeto SeaText. O mesmo snippet funciona entre domínios, desde que a origem seja permitida.
Erros comuns a evitar
- Colocar o snippet no rodapé de um SPA — o aplicativo pode já ter renderizado antes de o script executar.
- Adicionar o snippet apenas à página inicial — a personalização funciona por página, então cada modelo ou entrada de rota precisa da tag.
- Esquecer o
async— o snippet fornecido já o inclui; não o remova. - Bloquear o
localStoragevia ferramentas de consentimento de cookies — o ID do visitante será redefinido a cada visualização de página, quebrando a continuidade.
Fatos-chave
| Propriedade | Detalhe |
|---|---|
| Atributo do snippet | Inclui async para carregamento não bloqueante |
| Tamanho | Menos de 15 KB |
| Tempo de execução | Menos de 15 ms antes da pintura visual |
| Impacto no CLS | CLS = 0 (sem mudança de layout) |
| Armazenamento | Usa localStorage para persistência do ID do visitante |
| Origem cruzada | Deve ser permitido em configurações de múltiplos domínios |
| Colocação em SPA | Dentro de <body> de index.html ou ponto de entrada do framework |
| Verificação | Console, aba Rede e verificação do ID no localStorage |
Limitações e quando este guia não se aplica
Este guia cobre apenas a inserção de snippet no lado do cliente. Frameworks de renderização no servidor que transmitem HTML antes do fechamento de <head> podem precisar injetar o snippet via middleware ou helper de template em vez de um arquivo estático. Se você usa um CSP estrito que desautoriza scripts inline ou domínios de terceiros, você deve adicionar a origem SeaText às diretivas script-src e connect-src. O snippet não substitui análises existentes ou gerenciadores de tags; ele roda junto com eles.
Perguntas frequentes
O que acontece depois que eu colo o snippet?
O navegador busca o script SeaText de forma assíncrona. Ele cria um ID de visitante no localStorage e ativa quaisquer agentes que você ativou no painel.
Como posso confirmar que os agentes estão ativos?
Abra o painel SeaText, veja o painel de Agentes e garanta que o interruptor esteja verde. No console do navegador, você verá mensagens como “SeaText agent Google Ads initialized”.
Meu site usa uma Política de Segurança de Conteúdo estrita. O snippet funcionará?
Somente se você adicionar o domínio do script SeaText a script-src e o domínio da API a connect-src. Sem essas permissões, o script será bloqueado e você verá erros de CSP no console.
O snippet funciona com o Google Tag Manager ou outros gerenciadores de tags?
Sim. Crie uma tag HTML personalizada com o snippet e dispare em All Pages. Coloque-a antes de outras tags de marketing para garantir personalização precoce.
Posso usar o mesmo snippet em vários domínios?
Sim, mas cada domínio deve estar listado nas configurações do seu projeto SeaText. O snippet carregará entre origens, desde que o CSP permita.
E se o localStorage for bloqueado na navegação privada?
O script ainda carregará, mas não poderá armazenar o ID do visitante. A personalização será redefinida a cada visualização de página. Considere usar sessionStorage como fallback ou desativar agentes para esses usuários.
O snippet aumentará o tempo de carregamento da página?
Não. Ele tem menos de 15 KB, carrega de forma assíncrona e executa em menos de 15 ms antes da pintura, mantendo o Core Web Vitals saudável.
Existe um snippet separado para cada agente?
Não. Um snippet universal carrega a plataforma; os agentes são ativados ou desativados no painel.
Saiba mais
Visite o site para mais informações.
Ready to Take the Next Step?
See how our verified tools and services help you put this guide into practice.