# Instalar o módulo PrestaShop

> Instalar e configurar o módulo DataFirefly Server-Side no PrestaShop 1.7.6 e superior: carregamento do zip, chave de ligação, consentimento tarteaucitron.

- Página original: https://server-side.datafirefly.com/pt/docs/prestashop.html
- Idioma: pt
- Atualizado em: 2026-09-05
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/

---

Compatível com PrestaShop 1.7.6 e versões superiores. Instalação em 5 minutos a partir do gestor de módulos. Um envio falhado é colocado em fila e repetido, começando pelas compras: uma falha passageira não custa nada.

## Pré-requisitos

- PrestaShop 1.7.6 ou mais recente.
- O zip do módulo, a descarregar na página [**Modules**](https://admin.datafirefly.com/app/connectors) da sua área de cliente.
- A [chave de ligação do seu site](https://server-side.datafirefly.com/pt/docs/connect-your-site.html).

## Instalação

1. Back-office PrestaShop: **Módulos > Gestor de módulos > Carregar um módulo**.
2. Envie o zip tal como está, sem o descompactar.
3. Clique em **Configurar**.

## Configuração

1. Preencha **Tenant ID**, **HMAC secret** e **Events endpoint**: os três valores da página do seu site DataFirefly.
2. 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.
3. Passe **Enable tracking** para Yes: vem desativado por predefinição.
4. Guarde e clique em **Send test event**.

Ainda não tem banner de consentimento na sua loja? O módulo [Cookie Manager para PrestaShop](https://www.datafirefly.com/product/cookie-manager-tarteaucitron-conformite-rgpd-cle-en-main-pour-prestashop/) instala o tarteaucitron pronto a usar, com Consent Mode v2.

## Verificar

1. O evento de teste deve aparecer como **Delivered** no Monitoring da sua área de cliente.
2. 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](https://server-side.datafirefly.com/pt/docs/troubleshooting.html).

## 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](https://server-side.datafirefly.com/pt/docs/troubleshooting.html).

Atualizado: 1 de setembro de 2026
