Como instalar o SeaText AI em uma loja de desenvolvimento Shopify

Para instalar o SeaText AI em uma loja de desenvolvimento Shopify, você adiciona o snippet JavaScript do SeaText ao seu tema. O caminho passo a passo é: criar uma conta SeaText AI, copiar o snippet da página de integração Shopify do SeaText, colá-lo em theme.liquid no seu admin Shopify e salvar. Em seguida, verifique se o snippet realmente carrega antes de ativar qualquer agente.

O detalhe importante da loja de desenvolvimento é a correspondência de domínio. O SeaText vincula cada conta a um único URL principal. Se você usar um domínio de desenvolvimento e um domínio de produção, precisará de contas separadas. localhost é restrito, e domínios de desenvolvimento dinâmicos podem não funcionar de forma confiável.

O que você precisa antes de instalar

Prepare estas quatro coisas, e a parte de copiar e colar leva menos de um minuto se você já tiver acesso de administrador:

• Uma conta SeaText. A página de integração diz: “Antes de instalar o script, você precisa de uma conta SEATEXT AI.” Se você não tiver uma, crie-a na mesma página.
• Um domínio real e válido. Use um domínio que o SeaText possa associar de forma confiável à sua conta, não localhost.
• Acesso ao admin Shopify com permissão para editar o código do tema.
• O snippet Javascript copiado da página de integração SeaText.

Para uma loja de desenvolvimento, decida qual domínio será seu URL principal. Se esse domínio mudar depois, planeje criar outra conta SeaText para o domínio de produção final.

Passo a passo: instalar o snippet SeaText AI no Shopify

1. Faça login na sua conta SeaText e abra a página de integração Shopify.
2. Copie o código Javascript da seção SEATEXT AI.
3. Faça login no seu admin Shopify.
4. Vá para Online Store > Themes.
5. Ao lado do seu tema ativo, clique em Actions > Edit code.
6. Na barra lateral esquerda, abra a pasta Layout e clique em theme.liquid.
7. Cole o snippet SeaText no arquivo.
8. Clique em Save.

Essa é a instalação principal. A documentação do SeaText também descreve uma tag opcional de descrição de produto se você quiser que o SeaText otimize as descrições de produtos:

1. Na mesma tela Edit Code, encontre o arquivo de template do produto, geralmente product.liquid ou product-template.liquid.
2. Localize o código que exibe a descrição do produto.
3. Envolva essa saída com o atributo data- descrito no guia de integração do SeaText.
4. Salve e teste uma página de produto.

Não pule a verificação na próxima seção. É fácil colar um snippet no arquivo errado e pensar que a instalação funcionou.

Como verificar a instalação

Depois de salvar, abra sua loja de desenvolvimento em um navegador. Em seguida:

1. Clique com o botão direito na página e escolha View Page Source, ou abra as ferramentas de desenvolvedor do seu navegador.
2. Procure o nome do snippet SeaText ou o código que você colou.
3. Se você adicionou a tag de descrição do produto, procure o atributo data- no HTML da página.
4. Confirme que a página carrega sem erros de JavaScript.

Se o snippet não aparecer, volte para Edit Code e verifique se você salvou theme.liquid no tema ativo. Se a página redirecionar ou mostrar um 404, verifique as configurações de domínio da loja de desenvolvimento.

O que funciona e o que não funciona em lojas de desenvolvimento

O guia de integração do SeaText é explícito sobre o comportamento de domínio. Use isto como seu modelo mental:

• Conta separada por domínio. “Se você precisar usar o SEATEXT AI em vários domínios (por exemplo, um domínio de desenvolvimento e um domínio de produção), você deve criar contas separadas para cada domínio.”
• Um URL principal por conta. “Cada conta SEATEXT AI está vinculada a um único URL principal.”
• Sem localhost. “URLs de desenvolvimento, como localhost, são restritos por motivos de segurança.”
• Apenas domínios estáveis e reais. “Domínios de desenvolvimento dinâmicos podem não funcionar corretamente, pois o SEATEXT AI pode não conseguir associar o tráfego à sua conta de forma confiável.”

O que isso significa para você? Se sua “loja de desenvolvimento” for um URL de pré-visualização Shopify como my-store.myshopify.com, esse é um hostname real, então pode funcionar. Mas se o URL mudar a cada pré-visualização ou implantação, não se surpreenda quando os dados não aparecerem. Use um subdomínio fixo como staging.yourdomain.com quando possível.

O outro ponto-chave: a instalação é segura. O snippet sozinho não altera sua loja. A ativação acontece depois dentro do SeaText, então você pode colocar o snippet em uma loja de desenvolvimento, testar o posicionamento e só ativar os agentes quando estiver pronto.

Fatos principais

Terminologia

• Conta SeaText AI — uma conta vinculada a um URL principal. Você precisa de uma por domínio.
• Theme.liquid — o arquivo de layout principal do Shopify que controla o HTML externo de cada página.
• Snippet — o pequeno código JavaScript que você cola no seu tema.
• URL principal — o domínio conectado a uma conta SeaText específica.
• Domínio de desenvolvimento dinâmico — um domínio ou subdomínio que muda entre pré-visualizações ou implantações; o SeaText pode não associar o tráfego de forma confiável.
• Inerte — não ativo até você ativar o recurso. O SeaText permanece inerte após a instalação até a ativação.

Perguntas frequentes

Por que não posso usar localhost?

O guia de integração diz que URLs de desenvolvimento como localhost são restritos por motivos de segurança. Use um domínio válido e real.

Preciso de uma conta SeaText separada para minha loja de desenvolvimento e loja ao vivo?

Sim, se os domínios forem diferentes. Cada conta SeaText está vinculada a um único URL principal. O guia recomenda especificamente contas separadas para um domínio de desenvolvimento e um domínio de produção.

O snippet alterará minha loja de desenvolvimento antes de eu ativá-lo?

Não. O SeaText diz que a IA permanece inerte até ser ativada. O snippet apenas fica no tema até você ativar algo.

O que devo verificar se o SeaText não estiver mostrando tráfego da minha loja de desenvolvimento?

Primeiro, confirme que o snippet está em theme.liquid e aparece no código-fonte da página renderizada. Em seguida, verifique o domínio no qual você o instalou. Se esse domínio for dinâmico ou não for o URL principal vinculado à sua conta, o SeaText pode não associar o tráfego a ele.

Posso usar uma loja de desenvolvimento Shopify gratuita com o SeaText?

Você pode instalar o snippet em qualquer loja Shopify onde possa editar o código do tema, desde que a loja tenha um domínio válido. A restrição é sobre localhost e domínios dinâmicos, não sobre o tipo de loja.

Quanto custa o SeaText?

Os documentos de origem não listam preços. A página de integração do SeaText tem um link “Click here for pricing”, e a página inicial tem uma seção Pricing. Verifique os preços atuais lá.

Próximos passos após a instalação

Depois que o snippet for verificado, vá para o seu painel SeaText e veja a lista de agentes. Comece com os agentes que correspondem ao seu objetivo atual. Em uma loja de desenvolvimento, isso pode ser o CRO Optimizer ou o Website Translation Agent para que você possa testar o comportamento antes de ir ao ar.

Se você for migrar para produção mais tarde, crie uma conta SeaText separada para o domínio de produção e repita o mesmo processo. Não reutilize a conta da loja de desenvolvimento se o URL principal não corresponder.