# Instalar o plugin WooCommerce

> Instalar e configurar o plugin DataFirefly Server-Side no WooCommerce: chave de ligação dfss\_, funil completo, desduplicação das encomendas, CMP compatíveis.

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

---

Funil completo, da vista de produto à compra, com desduplicação automática e fila de reenvio. Compatível com HPOS.

## 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**](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. Admin WordPress: **Plugins > Add New > Upload Plugin**.
2. Envie o zip e clique em **Activate**.

## Configuração

1. Abra **Settings > DataFirefly Server-Side**.
2. 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

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

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

Atualizado: 1 de setembro de 2026
