Pré-requisitos
- PrestaShop 1.7.6 ou mais recente.
- O zip do módulo, a descarregar na página Modules da sua área de cliente.
- A chave de ligação do seu site.
Instalação
- Back-office PrestaShop: Módulos > Gestor de módulos > Carregar um módulo.
- Envie o zip tal como está, sem o descompactar.
- Clique em Configurar.
Configuração
- Preencha Tenant ID, HMAC secret e Events endpoint: os três valores da página do seu site DataFirefly.
- Opção Require consent: o módulo só deixa sair um evento quando o visitante aceitou a publicidade. Reconhece sozinho, sem configuração: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, no navegador e no servidor, a mesma lista dos módulos WooCommerce e Shopware. Recomendado se a sua loja tiver um banner de consentimento.
- Passe Enable tracking para Yes: vem desativado por predefinição.
- Guarde e clique em Send test event.
Ainda não tem banner de consentimento na sua loja? O módulo Cookie Manager para PrestaShop instala o tarteaucitron pronto a usar, com Consent Mode v2.
Verificar
- O evento de teste deve aparecer como Delivered no Monitoring da sua área de cliente.
- Faça uma encomenda de teste: o módulo envia as compras na validação da encomenda.
Fila de reenvio
Aplica-se a partir da versão 1.29.0.
- Um envio falhado é colocado em fila e repetido à medida que a loja recebe visitas: no máximo a cada 30 segundos, nunca duas repetições ao mesmo tempo, em lotes de até 20 eventos enviados em paralelo.
- Loja com pouco tráfego: um URL de cron opcional, protegido por um token e acessível apenas em https, lança a repetição sem esperar por uma visita.
- As compras e os reembolsos passam primeiro, depois os eventos mais recentes.
- Um evento só sai da fila quando tem mais de 7 dias e está em espera há mais de 7 dias. Passa então a ser contado como expirado: nada desaparece sem deixar rasto.
- Se a DataFirefly não responder (falha de rede, HTTP 429 ou 5xx), a loja deixa de enviar diretamente durante 60 segundos e coloca os eventos logo na fila. Assim, uma falha do nosso lado nunca torna a sua loja nem o checkout mais lentos. A repetição continua a tentar e, assim que for bem-sucedida, o envio direto é retomado.
- A página do seu site na área de cliente mostra o estado desta fila. Os estados são explicados na página Resolução de problemas.
Em caso de problema
- Registos: Parâmetros avançados > Registos, filtre pelo prefixo
[DataFirefly SS]. - Se utilizar uma versão do módulo anterior à 1.8.0, atualize: as versões recentes corrigem uma possível contagem em duplicado das compras no GA4.
- As restantes causas frequentes estão listadas no guia de resolução de problemas.
Atualizado: 1 de setembro de 2026