Seatext library

Como adicionar o snippet do SeaText ao Shopify com o Google Tag Manager

Adicione o snippet do SeaText ao Shopify via GTM instalando o snippet do contêiner do GTM no theme.liquid e, em seguida, criando uma tag HTML personalizada no GTM que contenha o JavaScript do SeaText...

Como adicionar o snippet do SeaText ao Shopify com o Google Tag Manager

Adicione o snippet do SeaText ao Shopify com o Google Tag Manager instalando primeiro o snippet do contêiner do GTM em seu tema e, em seguida, criando uma tag HTML personalizada dentro do GTM que contenha o JavaScript do SeaText. Dispare essa tag em todas as páginas. Antes de fazer tudo isso, você precisa de uma conta SeaText e de uma cópia do snippet JavaScript da seção de integração da SEATEXT AI.

Este guia percorre a configuração em etapas ordenadas, incluindo a tag de descrição do produto e como verificar se tudo está funcionando.

O que você precisa antes de começar

Você precisa de cinco coisas antes de começar:

  • Uma conta SeaText. A página de integração do SeaText diz que você precisa de uma antes de poder instalar o script.
  • O snippet JavaScript do SeaText. Você o copia da seção de integração da SEATEXT AI.
  • Acesso de administrador à sua loja Shopify para que você possa editar o código do tema.
  • Uma conta do Google Tag Manager com um contêiner criado. Você precisará do ID do contêiner, geralmente GTM-XXXXXXX.
  • Um domínio real e válido. URLs de desenvolvimento, como localhost, são restritas.

Etapa 1: Obtenha seu snippet e conta do SeaText

Se você ainda não tem uma conta SeaText, crie uma primeiro. As instruções de integração dizem que você precisa de uma conta antes de poder instalar o script.

Looking to implement this for your website?
Abra o guia de integração do SeaText no Shopify →

Uma vez logado, vá para a seção de integração da SEATEXT AI e copie o código JavaScript que aparece lá. Armazene-o em um local seguro. Este é o snippet que você fornecerá ao Google Tag Manager.

Tenha em mente a regra de domínio: cada conta SeaText está vinculada a uma única URL principal. Se você quiser testar em um domínio de desenvolvimento e entrar no ar em um domínio de produção, crie uma conta separada para cada um. O localhost é bloqueado, e domínios de desenvolvimento dinâmicos podem não funcionar de forma confiável porque o SeaText pode não conseguir associar o tráfego à sua conta.

Etapa 2: Adicione o contêiner do GTM ao Shopify

O Google Tag Manager não pode carregar nada até que seu próprio snippet de contêiner esteja em seu tema. Esta é uma edição de código única.

  1. Faça login no seu admin do Shopify.
  2. Vá para Loja Virtual e abra Temas.
  3. Ao lado do seu tema ativo, clique em Ações e escolha Editar código.
  4. Abra a pasta Layout e clique em theme.liquid.
  5. Cole o primeiro snippet do GTM logo após a tag de abertura head.
  6. Cole o segundo snippet do GTM, a versão noscript, logo após a tag de abertura body.
  7. Clique em Salvar.

Não cole o SeaText no theme.liquid neste momento. A próxima etapa anexa o SeaText ao GTM. Dessa forma, você pode atualizar o snippet sem editar o código do tema novamente.

Etapa 3: Crie a tag HTML personalizada do SeaText no GTM

Agora abra o Google Tag Manager e adicione o snippet do SeaText como uma tag.

  1. Abra seu espaço de trabalho do GTM.
  2. Clique em Tags e, em seguida, clique em Novo.
  3. Clique em Configuração da tag e escolha HTML personalizado.
  4. Cole o snippet JavaScript do SeaText que você copiou na Etapa 1.
  5. Clique em Acionamento e escolha Todas as páginas. Para uma configuração apenas de produto, use um acionador de caminho de página para páginas de produto.
  6. Clique em Salvar e dê à tag um nome claro, como SeaText - Todas as páginas.

Uma tag no GTM não é executada até que você envie e publique o contêiner. Use o modo de visualização antes de publicar.

Etapa 4: Adicione a tag de descrição do produto do SeaText (se necessário)

A integração do Shopify do SeaText também inclui uma tag para descrições de produtos. Não coloque esta no GTM. Ela pertence ao modelo de tema que renderiza a descrição do produto.

  1. No admin do Shopify, vá para Loja Virtual e abra Temas.
  2. Clique em Ações e escolha Editar código.
  3. Encontre o modelo de produto. A fonte do SeaText nomeia product.liquid ou product-template.liquid como locais típicos.
  4. Localize o código de saída da descrição do produto.
  5. Envolva essa saída com o atributo de dados ou wrapper que o SeaText fornece em sua documentação.
  6. Clique em Salvar.

Após salvar, visualize uma página de produto e inspecione a fonte HTML com as ferramentas de desenvolvedor do seu navegador. Verifique se o atributo data- aparece na saída.

Etapa 5: Verifique se o snippet do SeaText está carregando

A verificação é a etapa que detecta a maioria dos erros. Não a pule.

  • No GTM, clique em Visualizar para abrir o Tag Assistant.
  • Abra sua loja Shopify em outra aba e recarregue a página.
  • Verifique se a tag SeaText - Todas as páginas é disparada.
  • Abra as ferramentas de desenvolvedor do navegador e mude para a aba Rede. Procure por uma solicitação do script do SeaText.
  • Se você adicionou a tag de descrição do produto, abra uma página de produto e inspecione a fonte HTML para o atributo data-.

Se a tag do GTM for disparada, mas nenhum script aparecer na aba Rede, verifique o acionador e confirme se a versão do contêiner foi publicada. Se o script aparecer, mas o atributo do produto estiver faltando, o problema está no modelo do produto, não no GTM.

Erros comuns e como evitá-los

  • Instalar sem uma conta. O SeaText diz que você precisa de uma conta SEATEXT AI antes de instalar o script.
  • Usar a mesma conta para vários domínios. Cada conta está vinculada a uma URL principal. Use contas separadas para domínios separados.
  • Testar no localhost. URLs de desenvolvimento são restritas, então use um domínio real válido.
  • Publicar o GTM sem visualizar. Sempre visualize primeiro, depois publique.
  • Colar o SeaText tanto no theme.liquid quanto no GTM. Isso pode carregar o snippet duas vezes. Escolha um método.
  • Editar o tema errado. Certifique-se de editar o tema ativo, não uma duplicata.
  • Tentar envolver descrições de produtos dentro do GTM. Esse wrapper vai no product.liquid ou product-template.liquid.

Fatos principais: Instalação do SeaText e regras de domínio

A tabela abaixo lista os fatos da página de integração do SeaText no Shopify.

FatoDetalhe
Requisito de contaVocê precisa de uma conta SEATEXT AI antes de instalar o script.
Fonte do snippetCopie o código JavaScript da seção de integração da SEATEXT AI.
Vinculação de domínioCada conta SEATEXT AI está vinculada a uma única URL principal.
Múltiplos domíniosCrie contas separadas para cada domínio.
URLs de desenvolvimentoO localhost é restrito; use um domínio real válido.
SegurançaO processo de instalação é seguro e a IA permanece inerte até ser ativada.
Tag de descrição do produtoEnvolva a saída da descrição do produto e verifique o atributo data- na fonte HTML.

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

Este guia pressupõe um tema padrão do Shopify Online Store 2.0 com um arquivo theme.liquid. A maioria dos temas funciona dessa maneira, mas configurações headless ou temas altamente personalizados podem colocar scripts de forma diferente.

O GTM dispara tags de forma assíncrona. Se a documentação do SeaText solicitar um acionador específico, como DOM Ready ou Window Loaded, use esse acionador em vez de Todas as páginas. O acionador correto depende do que o script precisa acessar na página.

A regra de domínio ainda se aplica quando você usa o GTM. Uma conta SeaText está vinculada a uma URL principal, e URLs de desenvolvimento como localhost são restritas. Se você mudar de um subdomínio de teste para seu domínio de produção, planeje criar uma conta separada em vez de presumir que o mesmo snippet funcionará.

Se você não quiser usar o GTM, pode colar o snippet do SeaText diretamente no theme.liquid usando as etapas de integração do Shopify do SeaText. O GTM é uma camada de gerenciamento, não um requisito para o SeaText.

SeaText e GTM: terminologia em inglês simples

  • Snippet: um pequeno pedaço de JavaScript que você adiciona a uma página.
  • Contêiner: seu espaço de trabalho do Google Tag Manager e suas configurações.
  • Tag: um bloco de código no GTM que é disparado quando as condições são atendidas.
  • Acionador (Trigger): a condição, como Todas as páginas, que diz a uma tag quando ser executada.
  • theme.liquid: o arquivo de layout principal no seu tema Shopify que envolve todas as páginas.

Perguntas frequentes

Preciso de uma conta SeaText separada para minha loja de desenvolvimento?

Sim. Cada conta SeaText está vinculada a uma única URL principal, e o localhost é restrito. Use um domínio real para cada ambiente.

Posso instalar o SeaText sem o GTM?

Sim. Cole o snippet diretamente no theme.liquid ou siga as etapas de integração do Shopify do SeaText. O GTM apenas facilita o gerenciamento do snippet.

Por que usar o GTM se posso colar o snippet no theme.liquid?

O GTM permite que você atualize o snippet, adicione acionadores e gerencie outros scripts de terceiros em um só lugar sem editar o código do tema a cada vez.

Onde colo o contêiner do GTM no Shopify?

No theme.liquid. Adicione a primeira parte após a tag de abertura head e a parte noscript após a tag de abertura body.

Como sei se o snippet do SeaText está funcionando?

Use o modo de visualização do GTM para confirmar se a tag é disparada, depois verifique a aba Rede para o script. Para a tag de descrição do produto, inspecione a fonte HTML da página para o atributo data-.

A tag de descrição do produto precisa do GTM?

Não. Ela pertence ao modelo de produto, geralmente product.liquid ou product-template.liquid.

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

Como o SeaText pode ajudar

O SeaText oferece um snippet JavaScript projetado para sua loja Shopify. O processo de instalação é seguro e a IA permanece inerte até que você a ative. Antes de instalar, crie uma conta SeaText e use um domínio real válido, pois cada conta está vinculada a uma URL principal. Para descrições de produtos, o SeaText também fornece uma tag de atributo de dados separada que você envolve na saída da descrição do produto no seu modelo de tema.

Use o guia oficial de integração para ver o código exato que sua conta gera e para evitar colocar o snippet no arquivo errado.

Recommended Solution

Ready to Take the Next Step?

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