Seatext library

Implementando o SeaText AI via Google Tag Manager: Guia Completo de Configuração

Sim, você pode implementar o SeaText AI usando o Google Tag Manager criando uma tag de HTML Personalizado com o snippet JavaScript do SeaText e disparando-a em Todas as Páginas. Este método funciona em...

Implementando o SeaText AI via Google Tag Manager: Guia Completo de Configuração

Resposta Rápida: O GTM funciona para o SeaText AI

O SeaText AI fornece um snippet de instalação JavaScript (identificado como SEATEXTCODEINTEGRATION em sua conta). O Google Tag Manager suporta JavaScript arbitrário através do seu tipo de tag de HTML Personalizado, portanto, você pode colar esse snippet em uma tag de HTML Personalizado, definir o acionador para Todas as Páginas, publicar o contêiner e o SeaText será carregado a cada visualização de página.

Por que usar o GTM em vez de um plugin do WordPress?

A documentação oficial do SeaText recomenda o plugin Headers and Footers by WPBeginner para sites WordPress. Isso funciona bem, mas o GTM adiciona várias vantagens práticas:

Looking to implement this for your website?
Saiba mais →
  • Controle de versão — cada publicação de contêiner cria uma versão numerada para a qual você pode reverter.
  • Modo de visualização — teste a tag em seu site ativo antes que os visitantes a vejam.
  • Gerenciamento centralizado — se você já usa GA4, Meta Pixel ou outras tags de marketing no GTM, o SeaText fica ao lado delas em um só lugar.
  • Disparo condicional — você pode restringir o SeaText a caminhos de página, funções de usuário ou estados de consentimento específicos usando acionadores e variáveis do GTM.
  • Sem sobrecarga de plugins — um plugin WordPress a menos para atualizar ou que possa causar conflitos.

Passo a passo: Criar a tag do SeaText no GTM

  1. Faça login no Google Tag Manager e abra o contêiner do seu site.
  2. Clique em Tags → Nova.
  3. Dê um nome à tag (por exemplo, "SeaText AI — Snippet Principal").
  4. Clique em Configuração da tag → HTML personalizado.
  5. Em sua conta SeaText, copie o snippet JavaScript completo exibido em SEATEXTCODEINTEGRATION.
  6. Cole o snippet no campo HTML no GTM.
  7. Deixe a opção Suporte a document.write desmarcada (o SeaText não a utiliza).
  8. Em Acionamento, escolha All Pages (Visualização de página).
  9. Clique em Salvar.
  10. Abra o modo Visualizar, visite seu site e confirme se a tag é disparada no painel de depuração do GTM.
  11. Envie o contêiner com um nome de versão descritivo (por exemplo, "Adicionar snippet SeaText AI").

Verificando a ativação do SeaText após a implementação no GTM

O SeaText requer uma breve janela de ativação. A documentação afirma: "Visite ou atualize seu site várias vezes e permaneça na página por pelo menos 40 segundos — isso ativará a IA e a vinculará à sua conta." Após publicar o contêiner do GTM:

  • Abra seu site em uma aba normal do navegador (não na Visualização do GTM).
  • Permaneça na página por mais de 40 segundos.
  • Repita em algumas páginas diferentes.
  • Aguarde de 5 a 10 minutos e verifique seu painel do SeaText — o nome do seu site deve aparecer ao lado do logotipo do SeaText no canto superior esquerdo.

Se o nome do site não aparecer após 10 minutos, entre em contato com o suporte do SeaText.

Problemas comuns específicos do GTM

ProblemaPor que aconteceSolução
A tag dispara, mas o SeaText não conectaSnippet colado incorretamente (faltando tags <script> de abertura/fechamento ou truncado)Copie novamente o snippet completo do SeaText; certifique-se de que não haja espaços extras ou quebras de linha que interrompam o JS.
O console mostra erros de CSPSua Política de Segurança de Conteúdo (CSP) bloqueia scripts inline ou o domínio do SeaTextAdicione script-src 'self' https://cdn.seatext.com (ou o domínio exato do snippet) ao seu cabeçalho CSP.
A tag dispara na visualização, mas não no site ativoContêiner não publicado após a visualizaçãoClique em Enviar → Publicar no GTM.
Múltiplos domínios em um contêinerO SeaText vincula uma conta a uma URL principalCrie contas SeaText separadas por domínio; use contêineres GTM separados ou uma variável de tabela de pesquisa para trocar snippets por nome de host.
Desenvolvimento/staging em localhostO SeaText restringe localhost e URLs de desenvolvimento dinâmicasUse um domínio real (por exemplo, staging.example.com) com um certificado SSL válido para testes.

Fatos importantes da documentação do SeaText

FatoDetalhes
Método de instalaçãoSnippet JavaScript (SEATEXTCODEINTEGRATION) colocado no <head> da página
Caminho recomendado no WordPressPlugin Headers and Footers by WPBeginner → Scripts In Header
Requisito de ativaçãoVisite o site, permaneça por 40+ segundos, repita; o nome do site aparece no painel em 5–10 min
Regra de múltiplos domíniosUma conta SeaText por URL principal; contas separadas para domínios de dev/prod
Ambientes restritoslocalhost e URLs de desenvolvimento dinâmicas são bloqueados por segurança
Contato de suporteSe o nome do site não estiver visível após 10 minutos, contate o suporte do SeaText

Quando o GTM é a melhor escolha

  • Você já gerencia GA4, Meta CAPI ou outras tags de marketing no GTM.
  • Você precisa restringir o SeaText atrás de uma plataforma de gerenciamento de consentimento (CMP) — os acionadores do GTM podem respeitar o estado de consentimento.
  • Você deseja realizar testes A/B do SeaText (ativar/desativar) sem precisar de implantações de código.
  • Sua equipe prefere o histórico de versões do contêiner em vez de logs de atualização de plugins.

Quando o plugin do WordPress é mais simples

  • Ainda não existe um contêiner GTM e você não planeja adicionar outras tags.
  • Apenas uma pessoa gerencia o site e ela se sente confortável com o administrador do WordPress, mas não com o GTM.
  • Você precisa do snippet no <head> imediatamente e não quer esperar por um ciclo de publicação do GTM.

Avançado: Disparar o SeaText apenas após o consentimento

Se você usa uma CMP (Cookiebot, OneTrust, Complianz, etc.) que envia um evento de consent para a camada de dados (data layer), você pode criar um acionador no GTM:

  1. Variável → Variável da camada de dados → Nome: consent.analytics (ou o que sua CMP utilizar).
  2. Acionador → Evento personalizado → Nome do evento: consent_update (ou o evento da sua CMP) → Disparar quando {{DLV - consent.analytics}} for igual a granted.
  3. Anexe esse acionador à tag do SeaText além de Todas as Páginas, ou substitua Todas as Páginas por este acionador se desejar que o SeaText carregue apenas após o consentimento.

Isso mantém você em conformidade com o GDPR/ePrivacy enquanto continua usando o GTM.

Limitações e Escopo

  • Este artigo cobre apenas a implementação do GTM no lado do cliente. O GTM no lado do servidor (sGTM) não é necessário para o SeaText e não é documentado pelo SeaText.
  • O painel do próprio SeaText é a fonte da verdade para o status de ativação — o GTM apenas entrega o snippet.
  • Se o seu site usa uma CSP rigorosa, você deve colocar o domínio de script do SeaText na lista de permissões; o GTM não pode ignorar a CSP.
  • URLs de visualização dinâmica (por exemplo, visualizações de implantação do Netlify, implantações de visualização da Vercel) podem não satisfazer o requisito de "domínio real e válido" do SeaText.

FAQ

Posso executar o plugin WP e o GTM ao mesmo tempo?

Tecnicamente sim, mas você carregará o snippet duas vezes, o que desperdiça bytes e pode causar inicialização duplicada. Escolha um método.

O SeaText fornece um modelo nativo para o GTM?

Não, de acordo com a documentação atual. Use a abordagem de tag de HTML Personalizado descrita acima.

O modo de visualização do GTM contará para a ativação de 40 segundos?

Sim, desde que a tag seja disparada na visualização e você permaneça na página. A lógica de ativação é executada no navegador, não no GTM.

Posso usar uma tabela de pesquisa do GTM para atender a diferentes contas SeaText por domínio?

Sim. Crie uma variável de Tabela de Pesquisa baseada em {{Page Hostname}} que retorne o snippet correto e, em seguida, referencie essa variável na tag de HTML Personalizado. Lembre-se de que cada domínio precisa de sua própria conta SeaText.

E se meu site estiver no WP Engine?

A documentação do SeaText observa: "Se você estiver usando wpengine.com, siga as instruções aqui." Esse link aponta para um guia separado; verifique-o para quaisquer restrições de cache ou cabeçalho específicas do WP Engine antes de implementar via GTM.

O snippet precisa estar no <head> ou pode estar no <body>?

As instruções oficiais dizem "Scripts In Header" (ou seja, <head>). A tag de HTML Personalizado padrão do GTM injeta no <body>, a menos que você ative "Suporte a document.write" (não recomendado). Na prática, o SeaText funciona a partir do <body>, mas para uma ativação mais rápida, siga a orientação do fornecedor e use uma sequência de tags do GTM ou um modelo personalizado que injete no <head>.

Como sei se o snippet é a versão mais recente?

O SeaText atualiza o snippet no painel da sua conta. Quando vir uma alteração, edite a tag de HTML Personalizado do GTM, cole o novo snippet e publique uma nova versão do contêiner.

Leitura adicional e fontes de comparação

Estas fontes externas fornecem contexto adicional para avaliar o tópico. Sua inclusão não é um endosso.

Saiba mais

Visite o site para mais informações.

Recommended Solution

Ready to Take the Next Step?

See how our verified tools and services help you put this guide into practice.