Como instalar o AGTI Analytics no PrestaShop
Resultado esperado: módulo ativo, vitrines na PDP e no carrinho, e checklist avançando no Dashboard.
Este guia é para o back-office da loja. Compatível com PrestaShop 1.6 a 9.
O módulo oficial AGTI se chama smartvitrines. Combine-o com o feed XML no painel — esse é o caminho recomendado para lojas PrestaShop.
O que o módulo faz
Com o módulo instalado e configurado, a loja passa a:
- Carregar o rastreamento automaticamente nas páginas (visitas a produto e interações com as vitrines)
- Exibir recomendações na página do produto e no carrinho, com o visual do tema (Hummingbird ou Classic)
- Informar a confirmação de pedido para o aprendizado das recomendações e para a leitura de impacto no Dashboard
- Enviar ao AGTI Analytics os sinais de adicionar ao carrinho feitos na loja (não só cliques nas vitrines)
Detalhes dos recursos: Recursos do módulo.
Antes de começar
Você precisa de:
- Acesso de administrador à loja PrestaShop
- Conta no AGTI Analytics com Public Key (
pk_live_...) e Secret Key (sk_live_...) - Preferencialmente o feed XML já preparado (URL pública)
Passo a passo
1. Instale o módulo
- Baixe o ZIP da versão atual: smartvitrines-1.5.1.zip
(ou a release mais recente em Releases do módulo) - No back-office: Módulos → Gerenciador de módulos → Enviar um módulo
- Envie o ZIP e confirme a instalação
- Em Módulos, localize SmartVitrines e abra Configurar
2. Informe a Public Key
No dashboard AGTI Analytics: Configurações → Integração.
Copie a Public Key e cole no campo correspondente do módulo. Essa chave identifica a loja nas chamadas públicas (SDK e recomendações).
3. Informe a Secret Key
Copie a Secret Key no mesmo painel e cole no módulo.
A Secret Key fica só no servidor da loja (back-office). Ela autentica a comunicação segura entre a loja e o AGTI Analytics (por exemplo, na confirmação de pedido). Não publique em HTML ou JavaScript do tema.
4. API URL (só se necessário)
- Deixe vazio em produção — o módulo usa o endpoint oficial
- Preencha apenas em homologação ou desenvolvimento, com uma URL alcançável pelo PHP da loja
5. Identificador do produto
Escolha qual campo do PrestaShop representa o produto no AGTI Analytics:
| Opção | Quando usar |
|---|---|
| Referência (padrão) | SKU/referência estável |
| ID | Quando o g:id do feed for o id numérico do PrestaShop |
| EAN-13 / UPC | Quando o feed e a loja usam código de barras |
O valor precisa bater com o identificador do feed XML. Se o identificador divergir, as vitrines podem ficar vazias ou sugerir o produto errado.
6. Layout e limites
- Layout das recomendações: Hummingbird ou Classic (PrestaShop 1.7+) — escolha o mesmo markup do tema ativo
- Limite na página do produto: quantos itens mostrar (padrão 4)
- Limite no carrinho: quantos itens mostrar (padrão 4; use 6–8 se quiser uma grade maior no carrinho)
Clique em Salvar. A mensagem esperada é Configurações salvas.
7. Complete o Dashboard
Ainda no painel AGTI Analytics:
- URL da loja e moeda
- URL do feed XML → aguarde status sincronizado
- Acompanhe o checklist
8. Publique e confira
- Limpe o cache do PrestaShop se o tema usar cache agressivo
- Abra um produto e o carrinho na loja
- Confira as vitrines e, no Dashboard, se o checklist marca loja conectada e recomendações publicadas