Como verificar a conexão da SeaText AI com sua loja Shopify

Você pode verificar se a SeaText AI está conectada corretamente à sua loja Shopify abrindo uma página de produto em um navegador e inspecionando o HTML em busca do atributo data-seatext. Você também deve confirmar se o snippet JavaScript da SeaText ainda está presente no arquivo theme.liquid do seu tema ativo da Shopify. Quando ambas as verificações são bem-sucedidas, a conexão está ativa.

Por que a verificação é importante

A SeaText usa JavaScript em sua vitrine para executar agentes de IA autônomos. Esses agentes podem reescrever títulos, ofertas, blocos de produtos e CTAs com base na palavra-chave ou campanha por trás de cada visita. Se o script não estiver conectado, os agentes não terão como ler os dados da loja ou publicar alterações. Você pode pensar que uma campanha está sendo otimizada quando, na verdade, a vitrine está exibindo a página padrão.

A verificação lhe dá confiança de que a camada de entrega está funcionando antes de você depender de qualquer resultado da IA. Ela também ajuda a detectar pequenos problemas, como um snippet ausente após uma atualização de tema, antes que eles afetem as conversões.

O que significa uma conexão correta com a SeaText

Uma conexão correta é mais do que apenas um script salvo. Significa que o script da SeaText pode carregar com seu tema Shopify, encontrar a descrição do produto e marcar o conteúdo que processou.

A SeaText é instalada como um JavaScript que você cola em seu tema. Antes da ativação, a IA permanece inerte. Ela não altera sua loja até que seja ligada. Isso protege seu conteúdo durante a instalação.

A verificação deve responder a três perguntas. O snippet está no tema ativo? A página do produto o carrega? O script consegue anexar seu atributo data- a um elemento processado?

Se todas as três respostas forem sim, a SeaText pode se comunicar com os dados da sua loja.

Como o script da SeaText carrega no theme.liquid

O guia de integração da Shopify da SeaText instrui você a colocar um snippet JavaScript no theme.liquid. Este arquivo controla o layout global do tema da sua loja.

Comece no seu painel administrativo da Shopify. Vá para Loja Virtual e, em seguida, Temas. Abra o menu Ações do seu tema ativo e escolha Editar código. Na pasta Layout, abra o theme.liquid. Cole o snippet de código da SeaText e clique em Salvar.

O theme.liquid é o local correto para o script porque a Shopify o carrega em todas as páginas que usam seu tema. Isso significa que páginas de produtos, páginas de coleções e páginas iniciais têm a chance de executar o código da SeaText.

Se você colar o snippet em um tema diferente, ele não será executado na loja ativa. O tema ativo é aquele que seus visitantes veem. Um tema duplicado ou arquivado não é suficiente.

O modelo de produto também é importante. O guia de integração da SeaText diz para implementar a tag nas descrições dos produtos. Localize o arquivo que renderiza a descrição do produto, geralmente product.liquid ou product-template.liquid. Envolva a saída da descrição do produto para que o script saiba qual conteúdo otimizar.

Quando o snippet está presente e a descrição está envolvida, o script pode carregar na página do produto e preparar o conteúdo para a SeaText modificar.

Como é uma comunicação bem-sucedida do script no navegador

A comunicação bem-sucedida é visível no HTML renderizado. A SeaText insere um atributo data- em elementos que processou. As ferramentas de desenvolvedor do seu navegador mostrarão esse atributo na descrição do produto ou em outros elementos modificados da página.

Você não precisa ver logs complexos. A presença do atributo data- é o sinal prático de que o script carregou e fez seu trabalho.

A comunicação bem-sucedida também significa que a vitrine continua funcionando normalmente. A descrição do produto deve ser exibida corretamente após a SeaText alterá-la. Se a página for renderizada sem erros e o atributo data- estiver presente, o script pode se comunicar com os dados da sua loja.

Lembre-se de que a SeaText pode não reescrever todos os elementos imediatamente. A IA torna-se ativa apenas após você ativar os agentes de que precisa. Um script inerte ainda pode estar conectado; ele simplesmente não recebeu instruções para alterar o conteúdo.

Como verificar o atributo data-seatext

Abra sua vitrine Shopify em um navegador. Vá para uma página de produto que contenha a descrição do produto envolvida pela tag.

Clique com o botão direito na página e escolha Inspecionar. Isso abre as ferramentas de desenvolvedor. Na guia Elementos, pesquise por data-seatext ou pelo atributo data- descrito na documentação da SeaText.

Use a caixa de pesquisa dentro do painel Elementos para encontrar o atributo. O navegador destacará o elemento HTML correspondente.

Se o atributo aparecer, o script está ativo nessa página. Se não aparecer, continue com as etapas de solução de problemas abaixo.

Você também pode verificar visualizando o código-fonte HTML. O guia de integração diz para visualizar uma página de produto e confirmar se o atributo data- está presente no código-fonte HTML. As ferramentas de desenvolvedor oferecem a mesma visualização com mais contexto.

Por que cada conta precisa de uma URL principal

Cada conta da SeaText AI está vinculada a uma única URL principal. Essa URL é o domínio da vitrine conectado à conta.

Se você tentar usar a mesma conta em vários domínios, a conexão não funcionará corretamente. Por exemplo, um domínio de desenvolvimento e um domínio de produção devem ter contas separadas.

Essa regra protege a medição de tráfego. A SeaText precisa saber quais visitas pertencem à sua loja. Se uma página carregar de um domínio diferente da URL principal, o script ainda pode ser executado, mas a SeaText pode não associar esse tráfego à sua conta.

URLs de desenvolvimento, como localhost, são restritas por motivos de segurança. Elas não são vitrines de produção válidas, portanto, a SeaText as bloqueia. Domínios de desenvolvimento dinâmicos também podem falhar porque a SeaText não consegue associar o tráfego à sua conta de forma confiável.

Durante a verificação, compare o domínio da vitrine com a URL principal na sua conta SeaText. Se eles não coincidirem, a conexão não está completa. Verifique com o fornecedor se você precisa alterar a URL principal.

Como solucionar causas comuns de desconexão

Use esta lista de verificação em ordem. Ela isolará a maioria dos problemas de conexão.

1. Abra Loja Virtual, Temas, Ações, Editar código para o tema ativo. Abra Layout/theme.liquid. Procure pelo snippet da SeaText. Se estiver faltando, cole-o novamente e salve.
2. Confirme se a URL principal da conta corresponde ao domínio da vitrine. Uma incompatibilidade é uma causa comum de conexão interrompida.
3. Verifique se você não está testando em localhost ou em um domínio de desenvolvimento dinâmico. Use um domínio real e válido.
4. Abra uma página de produto, inspecione-a e pesquise por data-seatext. Se o atributo estiver faltando, o script não processou esse elemento.
5. Confirme se a descrição do produto está envolvida com a tag da SeaText no modelo de produto. Sem a tag, o script pode carregar, mas não terá nada para marcar.

Esta lista de verificação funciona como uma árvore de decisão. Se o snippet estiver faltando, adicione-o novamente. Se a URL estiver errada, corrija a conta ou verifique com o fornecedor. Se o domínio estiver restrito, mude para um domínio real. Se o atributo ainda estiver faltando, verifique a tag do modelo de produto.

Limitações do método de verificação

O atributo data- aparece apenas em elementos que a SeaText processou. Se a descrição do seu produto não estiver envolvida com a tag da SeaText, uma página de produto pode carregar o script, mas ainda assim não mostrar nenhum atributo.

URLs de desenvolvimento, como localhost, não funcionarão. Domínios de desenvolvimento dinâmicos também podem não funcionar. Use um domínio real e válido para testes de conexão.

Uma conta SeaText não pode cobrir vários domínios. Cada conta está vinculada a uma única URL principal. Se você precisar do script em uma segunda vitrine, crie uma conta separada para esse domínio.

Exemplo prático: Verificar após uma atualização de tema

Um proprietário de loja atualiza seu tema Shopify. Após a atualização, as descrições dos produtos não mostram mais as alterações da SeaText.

Primeiro, o proprietário abre Loja Virtual e seleciona Temas. Ele escolhe Editar código para o tema ativo. Em Layout/theme.liquid, ele procura pelo snippet da SeaText. Ele desapareceu porque o novo tema substituiu o arquivo.

Ele cola o snippet novamente e salva o arquivo. Em seguida, ele reabre uma página de produto em uma nova guia do navegador. Ele inspeciona a página e pesquisa por data-seatext. O atributo agora aparece na descrição do produto.

O proprietário também verifica se o domínio da loja corresponde à URL principal da conta. Ele corresponde. A conexão está verificada.

Se o atributo ainda estivesse faltando, o proprietário verificaria o modelo de produto e confirmaria se a descrição está envolvida com a tag da SeaText. Ele também evitaria usar localhost durante o teste.

Terminologia

URL Principal

O domínio real vinculado a uma conta SeaText.

data-seatext

Um atributo HTML que a SeaText adiciona aos elementos processados.

theme.liquid

O arquivo de layout global em um tema Shopify onde o snippet da SeaText pertence.

Fatos principais

FAQ

O que o atributo data-seatext prova?

Ele prova que o script da SeaText carregou na página e processou o elemento. Esse é o sinal principal de uma conexão funcionando.

Por que o localhost é bloqueado?

A SeaText restringe URLs de desenvolvimento, como localhost, por motivos de segurança. Use um domínio real e válido ao verificar a conexão.

Posso usar uma conta SeaText em um domínio de desenvolvimento e em um domínio de produção?

Não. Cada conta está vinculada a uma URL principal. Crie uma conta separada para cada domínio.

O que devo fazer após alterar os temas?

Abra o novo tema ativo, edite o theme.liquid e cole o snippet da SeaText novamente. Em seguida, verifique uma página de produto em busca do atributo data-.

E se o atributo data- não aparecer?

Verifique o snippet no theme.liquid, confirme se a URL principal da conta corresponde à vitrine, verifique se o domínio não é localhost e confirme se a descrição do produto está envolvida com a tag da SeaText.

Um snippet salvo garante que a conexão funcione?

Não. O snippet deve estar no tema ativo, a descrição do produto deve estar envolvida e o domínio deve corresponder à URL principal.