Avançar para o conteúdo
Ajuda
Design e configurações do editor

Como adiciono JavaScript personalizado a toda a minha loja?

Adicione o seu próprio JavaScript a todas as páginas da loja com o separador Javascript personalizado do construtor. Quando o código é executado, porque não volta a ser executado em cada página, os erros, e porque as tags de acompanhamento e os códigos de verificação devem ir para apps.

3 min de leitura

O separador Javascript personalizado executa o seu próprio JavaScript na sua loja. Use-o para pequenos comportamentos que as configurações do construtor e as apps não cobrem.

Onde o encontrar

Abra o construtor, clique no ícone da roda dentada e abra o separador Javascript personalizado. A caixa chama-se Código Javascript: Aplica-se a toda a loja. Cole o seu código sem as tags <script>. Escreva apenas JavaScript simples.

Quando o código é executado

  • É executado uma vez quando um cliente abre a loja, depois de a página aparecer.
  • Não volta a ser executado em cada página. Quando um cliente passa para outra página da loja, a página muda sem recarregar por completo, por isso o seu código não é executado uma segunda vez. Se o código altera elementos de uma página, faça-o lidar com as mudanças de página, ou use antes uma secção Código personalizado nessa página.
  • Na pré-visualização do construtor, o código também é executado, e volta a ser executado quando o altera.
  • O seu código é executado num espaço próprio, por isso os nomes que declara não entram em conflito com a loja. Se o código der um erro durante a execução, o erro é apanhado e não estraga a loja. O erro fica escondido, por isso se nada acontecer, teste o código passo a passo.

Use antes uma app quando puder

Muitos scripts que os lojistas colam aqui têm uma app própria que faz o trabalho melhor:

Estas apps enviam por si eventos como as compras no momento certo.

Código para toda a loja ou uma secção Código personalizado

  • Separador Javascript personalizado: todas as páginas, executado uma vez por visita.
  • Secção Código personalizado: uma página, com o seu próprio HTML, CSS e JavaScript, executado sempre que essa secção é mostrada. Veja Código personalizado.

Dicas

  • Nunca cole chaves secretas nem palavras-passe. Qualquer pessoa pode ler este código no navegador.
  • Teste na loja ao vivo, num telemóvel e num computador, depois de publicar.
  • Os scripts de terceiros podem tornar a loja mais lenta. Adicione só o que precisa.
  • Se algo deixar de funcionar, esvazie a caixa, publique e volte a adicionar o código aos poucos.
  • Um assistente de IA ligado à sua loja precisa da sua permissão para alterar o código personalizado. Veja Como revejo, restrinjo ou desligo um assistente de IA.

Bom saber

O Javascript personalizado pertence ao mercado que está a editar. Repita-o em cada mercado que precisar dele. As alterações ficam ativas quando clica em Publicar.

Ainda precisa de ajuda?

Escreva-nos e nós respondemos.

Contacte-nos