Pré-requisitos
- Shopware 6.5, 6.6 ou 6.7.
- 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 Shopware: Extensions > My extensions > Upload extension, depois instale e ative o plugin.
- Ou em CLI:
bin/console plugin:install --activate DatafireflyServerSide
Configuração
- Abra a configuração do plugin e cole a chave de ligação
dfss_.... - Ative Enable tracking.
O módulo reconhece sozinho as ferramentas de consentimento mais comuns (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), no navegador e no servidor, a mesma lista dos módulos WooCommerce e PrestaShop. Deixe Consent cookie name vazio para essa deteção automática; preencha-o apenas para impor um cookie específico (por exemplo CookieConsent e marketing:true), que passa então a ter prioridade.
Verificar
- Execute
bin/console datafirefly:serverside:test. - O evento de teste deve aparecer como Delivered no Monitoring da sua área de cliente.
Fila de reenvio
Aplica-se a partir da versão 1.23.0.
- Um envio falhado é colocado em fila e repetido a cada 5 minutos por uma tarefa agendada do Shopware.
- 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 em
var/log/, prefixo[DataFirefly SS]. - Se utilizar uma versão do plugin anterior à 1.9.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