Como o SeaText se integra ao seu site: etapas de implementação, controle e verificação

O SeaText conecta-se ao seu site por meio de um snippet JavaScript leve que você cola uma vez — normalmente no <head> ou via Google Tag Manager. Após o carregamento do snippet, você ativa o agente de Landing Page do Google Ads (ou outros agentes) no painel do SeaText. O agente lê o parâmetro de palavra-chave que o Google Ads anexa à URL da sua página de destino (por exemplo, ?keyword=office+space), faz a correspondência com uma lista de palavras-chave aprovada por você e reescreve o conteúdo da página antes que o visitante a veja. Você mantém controle total: cada versão reescrita aparece no painel para revisão, você pode editar a saída da IA manualmente, adicionar instruções para o modelo ou desativar a otimização para qualquer palavra-chave.

Como a integração funciona de ponta a ponta

A integração possui três partes móveis: o snippet, o painel e a lógica do agente. O snippet é uma única tag <script> que carrega de forma assíncrona e adiciona menos de 50 KB compactados (gzipped). Ele não bloqueia a renderização. Uma vez presente, ele aguarda o carregamento da página, extrai parâmetros de consulta (termos UTM, gclid, parâmetros de palavra-chave personalizados) e os envia para a função de borda (edge function) do SeaText. A função de borda procura a palavra-chave na sua lista aprovada, busca a variante pré-gerada (ou gera uma instantaneamente se for a primeira visita para essa palavra-chave) e retorna um patch JSON que o snippet aplica ao DOM — trocando títulos, textos do corpo, ofertas, blocos de produtos e CTAs. A página original permanece inalterada no seu CMS; os visitantes veem a versão personalizada apenas enquanto a sessão corresponder a uma palavra-chave aprovada.

Implementação passo a passo

1. Crie uma conta no SeaText e abra o painel. O painel é onde você gerencia agentes, listas de palavras-chave e revisa textos reescritos.
2. Copie o snippet de instalação. No painel, você encontrará uma linha única <script src="https://cdn.seatext.com/..." async></script>. Cole-a no <head> global do seu site ou adicione-a por meio do Google Tag Manager / Segment / Tealium como uma tag HTML personalizada. O snippet funciona em qualquer plataforma — WordPress, Webflow, Shopify, HTML estático, React, Next.js, Vue — porque ele apenas lê a URL e altera o DOM renderizado.
3. Verifique se o snippet carrega. Abra seu site com ?seatext_debug=1 anexado a qualquer URL. O console registrará "SeaText snippet loaded" e mostrará os parâmetros detectados. Se você usar uma CSP, adicione https://cdn.seatext.com e https://api.seatext.com ao script-src e connect-src.
4. Ative o agente de Landing Page do Google Ads. No painel, alterne o agente "Google Ads Landing Page AI" para Ativo. Este agente foi criado especificamente para tráfego de pesquisa paga; outros agentes (Tradução, Personalização, Teste A/B, etc.) podem ser ativados independentemente.
5. Conecte sua conta do Google Ads (opcional, mas recomendado). Vincular permite que o SeaText extraia automaticamente sua estrutura de campanha/palavra-chave e sugira quais palavras-chave personalizar. Você também pode fazer upload de um CSV de palavras-chave manualmente.
6. Crie sua lista de palavras-chave. Para cada palavra-chave que deseja personalizar, clique em Adicionar palavra-chave, insira o termo exato (por exemplo, "estadia de curta duração") e aprove a reescrita gerada pela IA. O painel mostra uma comparação lado a lado: original vs. reescrito. Edite a reescrita se necessário, adicione orientações como "enfatize o checkout flexível" e salve.
7. Defina a alocação de tráfego. Por padrão, 100% do tráfego correspondente vê a reescrita. Você pode reduzir isso para executar um teste sombra (por exemplo, 10%) enquanto monitora os dados de conversão.
8. Entre no ar. Clique em Publicar. O próximo visitante que clicar em um anúncio para uma palavra-chave aprovada verá a página personalizada.

Pré-requisitos antes de começar

• Acesso de administrador ao <head> do seu site ou ao gerenciador de tags. Você precisa colar o snippet uma vez.
• Campanhas do Google Ads usando inserção de palavra-chave ou parâmetros de rastreamento de palavra-chave explícitos. O SeaText lê a palavra-chave da URL da página de destino. Se seus anúncios usam apenas gclid sem um parâmetro de palavra-chave, ative a "Marcação automática" no Google Ads e adicione {keyword} ao sufixo da sua URL final (por exemplo, ?kw={keyword}).
• Uma lista de palavras-chave nas quais você realmente dá lances. Personalizar para palavras-chave nas quais você não dá lances desperdiça tempo de revisão e pode confundir visitantes orgânicos.
• Conteúdo que pode ser trocado com segurança. O agente reescreve nós de texto e valores de atributos (títulos, rótulos de botões, meta descrições). Ele não reestrutura o HTML, move contêineres ou executa JavaScript personalizado. Se sua página depende de um layout rígido onde mudanças no tamanho do texto quebram o design, defina restrições de comprimento de caracteres nas configurações da palavra-chave.
• Consentimento para personalização sob sua política de privacidade. O snippet define um cookie primário (seatext_session) para manter a consistência da variante durante a sessão. Divulgue isso em seu aviso de cookies.

O que é reescrito (e o que não é)

Controle e verificação

Cada palavra-chave que você aprova recebe um histórico de versões no painel. Você pode:

• Visualizar a reescrita na sua URL ativa anexando ?seatext_preview=keyword-slug.
• Editar a saída da IA diretamente em uma visualização de diff de rich-text.
• Adicionar instruções como "Use ortografia do Reino Unido" ou "Mencione suporte 24/7" que o modelo seguirá na próxima regeneração.
• Pausar uma única palavra-chave sem desativar o agente.
• Exportar todas as reescritas como CSV para revisão de conformidade.

Para verificar se a integração está funcionando em produção, abra uma janela anônima, clique em um de seus próprios anúncios (ou simule com a URL final exata + parâmetro de palavra-chave) e confirme se o título muda. O painel "Visualização ao vivo" também mostra sessões em tempo real, a palavra-chave correspondente e a variante servida.

Cenários comuns de integração

Cenário A: Página de destino única, mais de 50 palavras-chave

Você executa uma página de destino genérica para uma campanha do Google Ads com 50 palavras-chave. Após a instalação do snippet, você ativa o agente do Google Ads, importa a lista de palavras-chave do Google Ads e aprova reescritas para as 20 principais palavras-chave por volume. As 30 palavras-chave restantes retornam à página original. Resultado: cada palavra-chave de alto volume recebe um título e oferta personalizados; palavras-chave de cauda longa mantêm a página genérica.

Cenário B: Múltiplas páginas de destino, campanhas diferentes

Você tem páginas separadas para "espaço de escritório", "coworking" e "escritório virtual". Instale o snippet globalmente. No painel, crie três grupos de palavras-chave mapeados para o caminho da URL de cada página. Ative o agente. Visitantes que clicam em anúncios de "coworking" chegam à página de coworking e veem reescritas específicas de coworking; cliques de "espaço de escritório" veem reescritas de espaço de escritório na página de espaço de escritório.

Cenário C: Headless / SPA (Next.js, React Router)

Como o snippet é executado a cada mudança de rota (ele escuta popstate e pushState), a personalização funciona na navegação do lado do cliente. Adicione data-seatext-ignore a qualquer componente que gerencie seu próprio texto via API de CMS para evitar reescrita dupla.

Limitações e quando este conselho não se aplica

• Sem parâmetro de palavra-chave na URL. Se seus anúncios usam apenas gclid e você não pode adicionar um parâmetro de palavra-chave, o SeaText não pode saber qual palavra-chave acionou o clique. Solução alternativa: ative a marcação automática do Google Ads e adicione {keyword} ao sufixo da URL final.
• Renderização pesada do lado do cliente sem texto no lado do servidor. Se a página inteira for construída a partir de JSON após o carregamento, o snippet pode reescrever tarde demais ou perder elementos. Use o atributo data-seatext-ignore ou renderize o texto crítico no lado do servidor.
• CSP estrita sem https://cdn.seatext.com e https://api.seatext.com. O snippet será bloqueado. Atualize sua política.
• Páginas atrás de login ou paywall. O agente só funciona em URLs públicas que o Google pode rastrear e que os visitantes podem acessar diretamente de um anúncio.
• Plataformas de anúncios que não sejam do Google sem parâmetros de palavra-chave. O agente do Google Ads espera o formato de parâmetro do Google. Para Meta, TikTok ou e-mail, use o agente de Reescritas de Origem do Visitante (ativação separada).

Fatos principais

FAQ

Preciso de ajuda de um desenvolvedor para instalar o snippet?

Geralmente não. Qualquer pessoa com acesso ao <head> do site ou ao Google Tag Manager pode colar a linha única. Se você usar uma CSP estrita, um desenvolvedor deve adicionar os dois domínios à política.

O snippet deixará minha página lenta?

O script carrega de forma assíncrona, tem menos de 50 KB compactados e é executado após o DOMContentLoaded. Ele não bloqueia a renderização ou os Core Web Vitals.

Posso usar o SeaText sem o Google Ads?

Sim. O agente de Reescritas de Origem do Visitante personaliza por referenciador (Meta, e-mail, orgânico, direto) em vez de palavra-chave. Ative esse agente em vez de (ou junto com) o agente do Google Ads.

O que acontece se a IA escrever algo impreciso?

Você revisa cada reescrita antes de publicar. Você pode editar o texto manualmente, adicionar instruções de correção ou pausar a palavra-chave. Nada entra no ar sem sua aprovação.

O SeaText altera o conteúdo do meu CMS?

Não. As reescritas acontecem no navegador via mutação do DOM. Seu CMS, banco de dados e HTML de origem permanecem exatamente como estão.

Posso fazer um teste A/B da versão personalizada contra a original?

Sim. Defina a alocação de tráfego abaixo de 100% para qualquer palavra-chave (por exemplo, 50%) para executar um teste dividido. O painel relata conversões por variante.

Existe um teste gratuito?

O SeaText oferece um piloto gratuito de 1 mês para o agente de Landing Page do Google Ads. Ative-o no painel após instalar o snippet.