Instalação do SDK JavaScript

Resultado esperado: script carregado com a Public Key, visitas registradas e caminho pronto para vitrines e conversão.

Use o SDK quando a loja não usa o módulo PrestaShop, ou quando você controla o tema HTML diretamente.

Na PrestaShop, o caminho recomendado continua sendo o módulo oficial smartvitrines — Instalação PrestaShop.

O que você precisa

• Public Key pk_live_... (Dashboard → Configurações → Integração)
• Acesso para editar o layout global (antes de </head> ou equivalente)
• Feed XML configurado no painel para o catálogo

Passo 1 — Escolha o ambiente

Ambiente	URL do script
Produção	https://api.analytics.agti.eng.br/v1/sdk.min.js
Homologação	URL informada pela AGTI

O SDK fala com a mesma base de onde o script foi carregado.

Passo 2 — Cole o snippet

<script>
  (function (w, d, s, u) {
    w.SmartVitrines = w.SmartVitrines || { q: [] };
    w.SmartVitrines.init = function (c) {
      w.SmartVitrines.q.push(['init', c]);
    };
    var j = d.createElement(s);
    j.async = true;
    j.src = u;
    d.head.appendChild(j);
  })(window, document, 'script', 'https://api.analytics.agti.eng.br/v1/sdk.min.js');

  SmartVitrines.init({
    publicKey: 'pk_live_SUA_CHAVE_AQUI',
  });
</script>

O que acontece depois do init

1. O visitante recebe um identificador anônimo
2. Em páginas de produto (com dados estruturados adequados), a visita pode ser registrada automaticamente
3. A mesma página não conta visita duplicada na mesma sessão

Confirme em Dashboard → Eventos após navegar a PDP.

Compra confirmada

Na página de sucesso do pedido:

SmartVitrines.trackConversion('NUMERO-DO-PEDIDO');

Vitrines

Para exibir produtos sugeridos, veja Montando vitrines.

Checklist

1. Public Key correta
2. Feed sincronizado
3. URL da loja em Configurações (CORS)
4. Vitrines renderizadas + trackClick
5. Checklist do Dashboard

Referência de métodos: API → Métodos do SDK.