Pré-requisitos
- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Compatível com HPOS.
- O zip do plugin, a descarregar na página Modules da sua área de cliente.
- A chave de ligação do seu site.
Instalação
- Admin WordPress: Plugins > Add New > Upload Plugin.
- Envie o zip e clique em Activate.
Configuração
- Abra Settings > DataFirefly Server-Side.
- Cole a chave de ligação
dfss_...e clique em Connect: o botão ativa o tracking completo e a opção de consentimento, e dispara de imediato um evento de teste.
O plugin deteta automaticamente as seguintes ferramentas de consentimento, sem configuração: WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. Os módulos PrestaShop e Shopware usam a mesma deteção: uma ferramenta reconhecida aqui é reconhecida em todo o lado.
O que o plugin cobre
- Todo o funil: navegação, vista de produto, carrinho, checkout, compra.
- Desduplicação por identificador de encomenda: sem contagem em duplicado entre navegador e servidor.
- Fila de reenvio automática: um envio falhado é repetido a cada 5 minutos.
- O painel DataFirefly Activity no admin mostra os últimos eventos enviados.
Verificar
- O evento de teste deve aparecer como Delivered no Monitoring da sua área de cliente.
- Faça uma encomenda de teste e encontre-a no painel DataFirefly Activity.
Em caso de problema
- Depois de qualquer alteração de configuração, limpe a cache do seu site: caso contrário, o LiteSpeed Cache e afins continuam a servir o JavaScript antigo.
- Se utilizar uma versão do plugin anterior à 2.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