Passar para o conteúdo principal

Como adicionar scripts JavaScript no seu site pela plataforma Agile?

Neste artigo você vai aprender a incluir códigos JS personalizados diretamente na sua loja virtual, usando os campos nativos disponíveis.

Atualizado há mais de 2 semanas

Como adicionar scripts JavaScript no seu site pela plataforma Agile?

Neste artigo, você vai aprender a incluir códigos JavaScript personalizados diretamente na sua loja virtual, usando os campos nativos disponíveis na plataforma Agile. Esses scripts permitem a personalização de comportamentos e funcionalidades, como integração com ferramentas externas, ajustes de layout, inserção de funcionalidades extras e muito mais.

Onde inserir os scripts?

A plataforma Agile oferece dois campos específicos para a inclusão de código JavaScript:

  • Head – Scripts adicionados antes do fechamento da tag <head> (ideal para scripts que precisam carregar junto com a página, como Google Tag Manager, Google Analytics etc).

  • Footer – Scripts adicionados antes do fechamento da tag <body> (ideal para scripts de comportamento, interações e funcionalidades customizadas).

Passo a passo para adicionar um script

1. Acesse o Admin do sistema

  • Vá até o menu: Integrações > Scripts

2. Escolha entre “Head” ou “Footer”

  • Clique na aba correspondente ao local onde deseja inserir seu script.

3. Insira o código JavaScript desejado

Exemplo simples de alerta:

alert("Bem-vindo à nossa loja!");

Ou um exemplo mais avançado para alterar o conteúdo de uma página:

document.addEventListener("DOMContentLoaded", function() {

document.querySelector(".banner h1").innerText="Super Oferta da Semana!";

});

4. Clique em Salvar

A alteração entra em vigor dentro de 10 minutos no site, sem necessidade de publicação manual.

O que é possível fazer com scripts JavaScript?

  • Inserir scripts de rastreamento como Meta Pixel, Google Ads, Tag Manager etc.

  • Fazer ajustes visuais dinâmicos (ex: esconder elementos, alterar textos, mudar botões).

  • Adicionar eventos personalizados, como cliques que disparam alertas, notificações, contadores e muito mais.

  • Conectar com APIs externas, webhooks ou automatizações personalizadas.

  • Ajustar ou enriquecer o comportamento de elementos nativos da loja, como banners, campos de formulário, botões de checkout etc.

⚠️ Cuidados ao adicionar scripts

  • Certifique-se de que o script é seguro e confiável.

  • Qualquer erro no código pode impactar o funcionamento da página.

  • Evite duplicar scripts como Google Analytics, pois isso pode gerar dados incorretos.

  • Teste em ambiente controlado sempre que possível antes de aplicar em produção.

Exemplo prático no painel Admin

Veja abaixo a área de edição de script:

Exemplo do campo Footer preenchido com JavaScript

Exemplo do campo Footer preenchido com JavaScript

Respondeu à sua pergunta?