Seatext library

Solução de Problemas de Conta SeaText em Múltiplos Domínios Odoo

As contas SeaText estão vinculadas a uma única URL primária, portanto usar uma conta em vários domínios Odoo causa mistura de dados, erros de rastreamento e conflitos de API. A solução é criar uma...

Solução de Problemas de Conta SeaText em Múltiplos Domínios Odoo

O SeaText não suporta múltiplos domínios Odoo em uma única conta. Cada conta SeaText está vinculada a uma única URL primária, então tentar compartilhar uma conta entre domínios leva à mistura de dados, rastreamento incorreto e possíveis violações do plano. A abordagem correta é criar uma conta SeaText separada para cada domínio Odoo que você opera — produção, staging ou sites de marcas separadas — e instalar o snippet JavaScript exclusivo em cada um.

Sintomas que indicam incompatibilidade de domínio-conta

Quando uma única conta SeaText é usada em mais de um domínio Odoo, os sintomas aparecem rapidamente. Você pode ver dados de visitantes de um domínio aparecendo no painel de outro domínio. Variantes de teste A/B podem vazar entre sites, então um teste de título em execução na sua loja de produção aparece subitamente no seu ambiente de staging. Eventos Conversion Relay (CAPI) podem disparar contra o pixel errado, corrompendo a otimização de anúncios do Meta e do Google. O agente de personalização de IA pode servir cópia treinada no público de uma marca para visitantes de uma marca completamente diferente. Esses não são bugs intermitentes — são o resultado direto de violar a arquitetura de uma conta por URL.

Sequência de diagnóstico: isolar a causa raiz

Looking to implement this for your website?
Ver o guia de integração do Odoo →
  1. Verifique o snippet instalado. Abra cada domínio Odoo em um navegador, veja o código-fonte e procure pelo JavaScript do SeaText. Cada domínio deve carregar um snippet que contenha seu próprio ID de conta. Se dois domínios carregam o mesmo snippet, você encontrou o problema.
  2. Verifique a URL primária nas configurações do SeaText. Faça login em cada conta SeaText e confirme se a URL primária corresponde exatamente ao domínio (incluindo subdomínio) onde o snippet é executado. Uma incompatibilidade aqui quebra a atribuição.
  3. Inspecione as solicitações de rede. Abra as ferramentas de desenvolvedor, filtre por "seatext" e confirme se as solicitações vão para o endpoint correto da conta. Solicitações do domínio A atingindo o endpoint da conta B confirmam contaminação cruzada.
  4. Revise os dados do painel. Observe as últimas 24 horas de sessões em cada painel SeaText. As sessões devem pertencer apenas ao domínio vinculado àquela conta. Qualquer sessão estrangeira significa que o snippet errado está instalado.
  5. Teste os eventos Conversion Relay. Dispare uma compra de teste em cada domínio e verifique se o evento aparece apenas na conta SeaText correspondente e no pixel correto da plataforma de anúncios.

Por que a regra de uma conta por URL existe

A arquitetura do SeaText vincula cada agente de IA — teste de cópia, personalização, tradução, detecção de bot, Conversion Relay — a uma única URL primária. Os agentes constroem modelos nos padrões de tráfego, comportamento do visitante e histórico de conversão desse domínio. Quando dois domínios compartilham uma conta, os modelos treinam em dados misturados, produzindo recomendações que não se adequam a nenhum dos sites. O modelo de segurança também depende do isolamento de domínio: URLs de desenvolvimento como localhost são explicitamente restritas, e domínios de desenvolvimento dinâmicos podem não funcionar de forma confiável porque o SeaText não consegue associar tráfego à conta de forma estável. Esse design previne vazamento de dados e garante que a otimização de cada site seja independente.

Como funciona a integração SeaText-Odoo

A instalação no Odoo segue um fluxo padrão de código de incorporação. Você faz login no Odoo, abre o módulo Website, edita a página alvo, arrasta um bloco "Embed Code" da seção Dynamic Content para a página, cola o snippet JavaScript do SeaText, salva e, opcionalmente, oculta o bloco no desktop. O snippet é um pequeno script assíncrono que carrega o runtime do SeaText e conecta à URL primária da sua conta. Como o snippet contém o identificador da conta, ele deve ser exclusivo por domínio. A página de integração do Odoo observa que você precisa de uma conta SeaText antes de copiar o snippet, e cada domínio requer sua própria etapa de criação de conta.

Erros comuns que criam problemas entre domínios

  • Copiar o mesmo snippet para múltiplos bancos de dados Odoo. Este é o erro mais frequente. As equipes frequentemente duplicam um banco de dados Odoo para staging e esquecem de trocar o snippet SeaText.
  • Usar uma única conta SeaText para uma instância Odoo multi-site. O recurso multi-site do Odoo permite executar vários domínios a partir de um banco de dados, mas o SeaText ainda exige uma conta por domínio.
  • Apontar um subdomínio de staging para a conta SeaText de produção. Mesmo subdomínios contam como URLs primárias separadas.
  • Compartilhar uma conta entre projetos de clientes. Agências que gerenciam múltiplos sites Odoo de clientes devem manter contas SeaText separadas por domínio de cliente.

Ações corretivas passo a passo

  1. Inventarie cada domínio. Liste todos os domínios Odoo (produção, staging, desenvolvimento, sites de clientes) que atualmente têm ou precisam de SeaText.
  2. Crie contas ausentes. Para cada domínio sem uma conta SeaText dedicada, cadastre-se em seatext.com e defina a URL primária para esse domínio exato.
  3. Gere e instale o snippet correto. Em cada nova conta, copie o snippet JavaScript e cole-o no domínio Odoo correspondente via bloco Embed Code. Salve e publique.
  4. Remova o snippet compartilhado antigo. Em cada domínio que estava usando a conta errada, exclua o bloco Embed Code antigo para que apenas o snippet correto permaneça.
  5. Verifique com a sequência de diagnóstico acima. Execute as cinco verificações para confirmar que o isolamento foi restaurado.
  6. Redefina dados corrompidos, se necessário. Se os painéis contêm dados históricos misturados, você pode precisar redefinir ou filtrar relatórios. O suporte SeaText pode aconselhar sobre limpeza de dados para as contas afetadas.

Fatos-chave

FatoDetalheFonte
Vínculo conta-URLCada conta SeaText está vinculada a uma única URL primáriaS1
Requisito multi-domínioContas separadas necessárias para cada domínio (produção, staging, etc.)S1
Restrição de URL de desenvolvimentoLocalhost e domínios de desenvolvimento dinâmicos são restritos por segurançaS1
Método de instalação OdooBloco Embed Code no módulo Website, cole o snippet JavaScriptS1
Exclusividade do snippetCada conta fornece um snippet JavaScript exclusivo contendo seu ID de contaS1
Isolamento de dadosAgentes constroem modelos por domínio; contas compartilhadas misturam dados e quebram otimizaçãoS1

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

Esta orientação se aplica a planos SeaText padrão usando a integração JavaScript no Odoo. Se você está em um acordo empresarial personalizado com uma implantação de borda dedicada (Cloudflare Workers), a arquitetura pode diferir — consulte seu engenheiro de soluções. A regra de uma conta por URL não muda para subdomínios: shop.example.com e blog.example.com são URLs primárias separadas e precisam de contas separadas. Localhost e domínios de desenvolvimento não públicos não podem ser usados como URLs primárias; você deve usar um domínio real e publicamente resolvível mesmo para staging. Se você gerencia centenas de domínios, entre em contato com as vendas SeaText para licenciamento por volume em vez de criar contas manualmente.

Terminologia

  • URL primária — O único domínio (incluindo subdomínio) ao qual uma conta SeaText está vinculada durante a configuração.
  • Snippet JavaScript — A tag de script assíncrona copiada de uma conta SeaText e colada em um bloco Embed Code do Odoo.
  • Conversion Relay (CAPI) — O encaminhador de eventos do lado do servidor do SeaText que envia eventos de compra verificados para as APIs de conversão do Meta e do Google.
  • Agentes de IA — Módulos autônomos (teste de cópia, personalização, tradução, detecção de bot, etc.) que executam por conta.
  • Bloco Embed Code — Um bloco do construtor de sites Odoo sob Dynamic Content usado para injetar HTML/JS bruto.

FAQ

Posso usar uma conta SeaText para um domínio de produção e seu subdomínio de staging?

Não. Um subdomínio (staging.example.com) é uma URL primária diferente do domínio raiz (example.com). Cada um precisa de sua própria conta SeaText.

O que acontece se eu ignorar a regra de uma conta?

Os dados de ambos os domínios se fundem em um painel. Os agentes de IA treinam em tráfego misto, produzindo variantes de cópia irrelevantes. O Conversion Relay envia eventos para os pixels de anúncios errados. Você também pode violar os termos de serviço do seu plano.

Eu pago por cada conta separada?

Sim. Cada conta SeaText tem sua própria assinatura. Descontos por volume estão disponíveis para agências e operadores de múltiplas marcas — entre em contato com as vendas para um orçamento personalizado.

Como movo um domínio de uma conta SeaText para outra?

Crie a nova conta com a URL primária correta, copie seu snippet, substitua o bloco Embed Code no domínio Odoo e verifique com a sequência de diagnóstico. Os dados históricos permanecem na conta antiga.

Posso gerenciar várias contas com um único login?

O painel do SeaText atualmente exige logins separados por conta. Agências frequentemente usam um gerenciador de senhas ou SSO para simplificar o acesso.

O recurso multi-site do Odoo muda alguma coisa?

Não. Mesmo se vários domínios rodam em um único banco de dados Odoo, cada domínio precisa de sua própria conta SeaText e snippet.

Onde obtenho o snippet JavaScript para uma nova conta?

Após criar a conta e definir a URL primária, o snippet aparece na seção de integração da conta. Copie-o e cole no bloco Embed Code do Odoo conforme descrito no guia de integração do Odoo.

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.

Como o SeaText pode ajudar

A integração do SeaText com Odoo é uma instalação simples de código de incorporação: crie uma conta, defina a URL primária para o seu domínio Odoo exato, copie o snippet JavaScript e cole-o em um bloco Embed Code na sua página do Website Odoo. Cada domínio tem sua própria conta, então os agentes de IA — teste de cópia, personalização, tradução, detecção de bot, Conversion Relay — treinam em dados limpos e isolados. Se você gerencia muitos domínios, fale com as vendas sobre licenciamento por volume em vez de criar contas uma a uma.

Recommended Solution

Ready to Take the Next Step?

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