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: os envios falhados são repetidos, começando pelas compras (detalhes mais abaixo).
- 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.
Fila de reenvio
Aplica-se a partir da versão 2.30.0.
- Um envio falhado é colocado em fila e repetido a cada 5 minutos pelo WP-Cron.
- 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
- 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