# Instalar o plugin Shopware

> Instalar e configurar o plugin DataFirefly Server-Side no Shopware 6.5, 6.6 e 6.7: upload da extensão, chave de ligação, cookie de consentimento, teste em CLI.

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

---

Compatível com Shopware 6.5, 6.6 e 6.7. Instalação através do admin ou da linha de comandos. Um envio falhado é colocado em fila e repetido a cada cinco minutos pelo próprio agendador do Shopware: uma falha passageira não custa nada.

## Pré-requisitos

- Shopware 6.5, 6.6 ou 6.7.
- 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 Shopware: **Extensions > My extensions > Upload extension**, depois instale e ative o plugin.
2. Ou em CLI: `bin/console plugin:install --activate DatafireflyServerSide`

## Configuração

1. Abra a configuração do plugin e cole a chave de ligação `dfss_...`.
2. 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

1. Execute `bin/console datafirefly:serverside:test`.
2. 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](https://server-side.datafirefly.com/pt/docs/troubleshooting.html).

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

Atualizado: 1 de setembro de 2026
