# Plugin de tracking server-side para Shopware > O plugin Shopware 6 que envia as conversões para Meta, GA4 e Google Ads a partir do servidor. Uma única chave, alojado na UE. - Página original: https://server-side.datafirefly.com/pt/shopware-server-side-tracking.html - Idioma: pt - Atualizado em: 2026-07-28 - Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/ --- Plugin Shopware 6.5 / 6.6: versão 1.0.0 Instale o plugin **DatafireflyServerSide** na sua loja Shopware 6 e envie a conversão de compra em server-side, diretamente para **Meta Conversions API (CAPI), GA4, TikTok, Pinterest e Microsoft Advertising**. Assinatura HMAC por loja, concebido para ser fail-safe para que um erro de tracking nunca quebre o checkout, e opção de consentimento RGPD configurável. Uma só chave de ligação, nenhum identificador de píxel para colar no Shopware. [Criar uma conta](https://admin.datafirefly.com/pricing?lang=pt) Como instalar o plugin Fail-safe: o checkout nunca é interrompido Assinatura HMAC por loja Alojado na UE O plugin instala-se como qualquer extensão Shopware: um ZIP a carregar em «As minhas extensões» da administração, sem necessidade de acesso FTP. O fluxo, de ponta a ponta **A sua loja Shopware** Plugin DatafireflyServerSide: evento encomenda efetuada **Dispatcher DataFirefly** Alojado na Alemanha: canal autenticado por HMAC Meta CAPI GA4 TikTok Pinterest Microsoft Advertising O problema ## Porque é que as suas tags de browser no Shopware deixam fugir vendas? O píxel da Meta, a tag do GA4 ou a tag do TikTok do seu tema Shopware correm no browser do cliente: onde são cada vez mais bloqueadas antes sequer de dispararem. - **Os bloqueadores de anúncios** impedem as tags de carregar na página de confirmação da encomenda: a compra nunca chega às suas plataformas. - **O Safari ITP** e proteções semelhantes encurtam ou eliminam os cookies de que as suas tags de conversão dependem. - **As restrições aos cookies e o atrito do consentimento** reduzem ainda mais aquilo que o tracking no browser consegue captar no momento da compra. O resultado: conversões Shopware incompletas, pior qualidade de correspondência e campanhas a otimizar com base numa visão parcial. Está a pagar por vendas que não consegue medir na totalidade. A solução ## Como funciona o rastreamento server-side no Shopware 6? O plugin **DatafireflyServerSide** capta a compra no momento em que a **encomenda é efetuada** (evento `checkout.order.placed`), do lado do servidor, e envia-a **de servidor para servidor, diretamente para a API de conversão de cada plataforma** (CAPI): o canal concebido para dados de conversão fiáveis e first-party. ### Compras recuperadas A conversão de compra deixa de depender de as tags do browser sobreviverem aos bloqueadores de anúncios e ao ITP: recupera vendas que de outra forma se perderiam. ### Melhor match quality O plugin capta os identificadores de browser disponíveis (`_fbp`, `_fbc`, `_ttp`, GA `clientId`) para um sinal de correspondência mais rico e fiável. ### Zero risco para o checkout Concebido para ser fail-safe: timeouts curtos e tratamento completo de exceções. Um erro de tracking é registado mas nunca interrompe a encomenda. Como funciona no Shopware ## Que passos levam a um tracking de compra completo? 1 ### Instale o plugin Shopware Carregue o ZIP **DatafireflyServerSide** em Extensões → As minhas extensões → Carregar extensão, e ative-o. O Shopware regista automaticamente a subscrição do evento de encomenda. 2 ### Cole a sua chave de ligação Abra a configuração do plugin e cole a sua chave de ligação (dfss\_…) copiada de «Connect your shop» na sua área de cliente DataFirefly (/app). Sem identificadores de píxel para introduzir. 3 ### A compra parte em server-side A cada encomenda efetuada, o evento de compra é assinado por HMAC e entregue ao dispatcher, que o distribui por todos os seus destinos configurados. Uma instalação, todas as plataformas. O que o plugin faz ## O que inclui o conector server-side para Shopware? ### Conversão de compra server-side Envia o evento purchase quando a encomenda é efetuada, diretamente para as API de conversão. ### Assinatura HMAC-SHA256 Cada envio é assinado por loja (cabeçalhos X-Dfss-Tenant, X-Dfss-Timestamp, X-Dfss-Signature). As credenciais dos destinos nunca tocam no browser. ### Fail-safe por conceção Timeouts HTTP curtos e tratamento completo de exceções: um erro de tracking nunca quebra o checkout. As falhas são registadas. ### Gating de consentimento Opção «Require consent»: a compra só é transmitida se estiver presente o cookie de consentimento que indicar, nome e valor configuráveis segundo o seu CMP, verificados do lado do servidor. ### Match quality enriquecida Capta os identificadores de browser disponíveis (\_fbp, \_fbc, \_ttp, GA clientId) juntamente com os dados da encomenda e do cliente. ### Evento de teste integrado Verifique a conectividade e a assinatura com um comando de consola (`bin/console datafirefly:serverside:test`), antes mesmo de fazer uma encomenda de teste real. ### Uma chave, nenhum segredo exposto A chave de ligação (dfss\_…) fica do lado do servidor. Os tokens dos destinos vivem no dispatcher, nunca no storefront. ### Alojado na UE O dispatcher corre na Alemanha: os seus dados permanecem na UE. Destinos ## Para que destinos envia o Shopware com Meta CAPI, GA4, TikTok, Pinterest e Microsoft Advertising? A conversão de compra do Shopware é distribuída em server-side para as API de conversão das suas plataformas. Configure uma vez na sua área DataFirefly. [![Logótipo da Meta: destino Meta Conversions API (CAPI) server-side](https://server-side.datafirefly.com/assets/logos/meta.svg) Meta Conversions API CAPI](https://server-side.datafirefly.com/pt/meta-capi-server-side-tracking.html) [![Logótipo do GA4: destino Google Analytics 4 via Measurement Protocol](https://server-side.datafirefly.com/assets/logos/ga4.svg) GA4 Measurement Protocol](https://server-side.datafirefly.com/pt/ga4-server-side-tracking.html) [![Logótipo do TikTok: destino TikTok Events API server-side](https://server-side.datafirefly.com/assets/logos/tiktok.svg) TikTok Events API](https://server-side.datafirefly.com/pt/tiktok-events-api-server-side-tracking.html) [![Logótipo do Pinterest: destino Pinterest Conversions API server-side](https://server-side.datafirefly.com/assets/logos/pinterest.svg) Pinterest Conversions API](https://server-side.datafirefly.com/pt/pinterest-conversions-api-server-side-tracking.html) [![Logótipo do Google Ads: destino via Google Ads Data Manager API](https://server-side.datafirefly.com/assets/logos/google-ads.svg) Google Ads Data Manager API](https://server-side.datafirefly.com/pt/google-ads-server-side-tracking.html) [![Logótipo do Microsoft Advertising: destino via Microsoft Advertising Conversions API](https://server-side.datafirefly.com/assets/logos/microsoft-ads.svg) Microsoft Advertising Conversions API](https://server-side.datafirefly.com/pt/microsoft-ads-conversions-api-server-side-tracking.html) O Google Ads (Data Manager API) está disponível ao nível da plataforma. O plugin Shopware 1.0.0 distribui a compra para Meta CAPI, GA4, TikTok, Pinterest e Microsoft Advertising. Instalação ## Como instalar o plugin server-side no Shopware? Requisitos: Shopware 6.5 ou 6.6, uma conta DataFirefly server-side, e acesso HTTPS de saída para serverside.datafirefly.com. 1 ### Obtenha a sua chave de ligação Em «Connect your shop» na sua área de cliente DataFirefly (/app), copie a sua **chave de ligação** (prefixo `dfss_…`). Contém tudo o que o plugin precisa: tenant, segredo HMAC e endpoint já vêm encapsulados, nenhum outro parâmetro para introduzir. 2 ### Carregue o ZIP na administração Administração Shopware → Extensões → **As minhas extensões** → **Carregar extensão**, e selecione o ZIP do plugin. Depois clique em **Ativar**. Por linha de comandos: `bin/console plugin:install --activate DatafireflyServerSide`. 3 ### Configure o plugin Abra a **configuração do plugin**. Cole a sua chave de ligação (dfss\_…). Se utilizar um CMP, ative **Require consent** (desativado por predefinição) e indique o nome e o valor do cookie de consentimento a verificar. Coloque o **tracking** em ativo e guarde. 4 ### Verifique a ligação Execute `bin/console datafirefly:serverside:test`: uma mensagem de sucesso confirma que a chave e a assinatura são válidas. Faça depois uma encomenda de teste real, e abra o **Inspector** em /app para confirmar a chegada do evento purchase (valor, moeda, referência). Os erros de entrega são registados nos logs do Shopware (entradas com prefixo `[DataFirefly SS]`). Uma falha de tracking é registada mas nunca interrompe a encomenda. Preços ## Quanto custa um pricing que cresce com a sua loja? Uma só subscrição cobre toda a sua conta, com todas as suas lojas Shopware: numa única fatura consolidada. Suba de plano para mais sites e mais eventos mensais. ### Gratuito Gratuito enquanto se mantiver abaixo da quota mensal: se a exceder, nada se quebra. 0 € / mês **1** site incluído Até **10 000** eventos / mês Sem cartão bancário [Começar gratuitamente](https://server-side.datafirefly.com/pt/gratuito.html) ### Starter Para uma única loja Shopware que põe em marcha o seu tracking server-side. **39 €** / mês (Mensal) · **32 €** / mês (Anual 2 meses grátis) Faturado 390 € por ano: compromisso de 12 meses, sem reembolso proporcional. **1** site incluído Até **500K** eventos / mês Uma fatura consolidada [Escolher Starter](https://admin.datafirefly.com/pricing?lang=pt&plan=starter) O mais popular ### Growth Para comerciantes e pequenas agências que gerem até cinco lojas. **119 €** / mês (Mensal) · **99 €** / mês (Anual 2 meses grátis) Faturado 1 190 € por ano: compromisso de 12 meses, sem reembolso proporcional. **5** sites incluídos Até **2M** de eventos / mês Uma fatura consolidada [Escolher Growth](https://admin.datafirefly.com/pricing?lang=pt&plan=growth) ### Scale Para agências e portefólios que gerem até vinte lojas com maior volume. **349 €** / mês (Mensal) · **290 €** / mês (Anual 2 meses grátis) Faturado 3 490 € por ano: compromisso de 12 meses, sem reembolso proporcional. **20** sites incluídos Até **10M** de eventos / mês Uma fatura consolidada [Escolher Scale](https://admin.datafirefly.com/pricing?lang=pt&plan=scale) O plugin Shopware está incluído em todos os planos. Consulte o [detalhe dos preços na página inicial](https://server-side.datafirefly.com/pt/#pricing). Confiança & RGPD ## Cumpre os padrões europeus de privacidade? **Alojado na UE (Alemanha)** Os seus dados são tratados na UE. **Ingestão autenticada por HMAC** Cada envio de compra é assinado por loja (HMAC-SHA256). **Respeito pelo consentimento** Com «Require consent», a compra só é transmitida se estiver presente o cookie de consentimento configurado: verificado do lado do servidor. **Credenciais nunca expostas** Os tokens dos destinos permanecem no dispatcher, nunca no browser. **Uma só chave de ligação** A chave dfss\_… encapsula tudo: nenhum token de destino vive na loja. **Objetivo de disponibilidade de 99,5 %** Medido e monitorizado em tempo real na nossa [página de estado pública](https://serverside.datafirefly.com/status), em linha com o nosso SLA. FAQ ## Perguntas frequentes: plugin Shopware ### O que é o plugin de tracking server-side para Shopware? O plugin **DatafireflyServerSide** (versão 1.0.0, compatível com Shopware 6.5 e 6.6) envia a conversão de compra da sua loja de servidor para servidor, diretamente para a API de conversão de cada plataforma (Meta CAPI, GA4, TikTok, Pinterest, Microsoft Advertising). O evento de compra é disparado quando a encomenda é efetuada, assinado por HMAC para a sua loja. As credenciais dos destinos nunca passam pelo browser. ### O plugin pode quebrar o funil de encomenda da minha loja Shopware? Não. O plugin foi concebido para ser fail-safe: timeouts HTTP curtos e tratamento completo de exceções fazem com que um erro de tracking nunca possa interromper a encomenda nem o checkout. Uma falha de entrega é registada (prefixo `[DataFirefly SS]` nos logs do Shopware), mas a encomenda conclui sempre normalmente. ### Preciso de colar identificadores de píxel no Shopware? Não. Cola apenas uma chave de ligação (`dfss_…`), copiada do ecrã «Connect your shop» da sua área de cliente DataFirefly (/app). O dispatcher sabe para que destinos distribuir. Não cola qualquer identificador de píxel nem token de acesso na loja. ### O plugin respeita o consentimento RGPD? Sim, através da opção **Require consent** (desativada por predefinição). Uma vez ativada, a compra só é transmitida se estiver presente o cookie de consentimento que indicar, nome e valor do cookie configuráveis, verificados do lado do servidor. O Shopware 6 não expõe um cookie de consentimento de marketing único legível do lado do servidor: o plugin adapta-se por isso à solução de consentimento da sua loja. O dispatcher está alojado na UE (Alemanha) e os dados pessoais são ocultados. ### Preciso de alojar um contentor GTM server-side? Não. A DataFirefly envia os eventos diretamente para a API de conversão de cada plataforma: não há qualquer contentor GTM server-side para alojar ou manter. A instalação resume-se ao plugin Shopware e a uma chave de ligação. Está noutra plataforma? Conheça o [módulo server-side para PrestaShop](https://server-side.datafirefly.com/pt/prestashop-server-side-tracking.html) ou o [plugin server-side para WooCommerce](https://server-side.datafirefly.com/pt/woocommerce-server-side-tracking.html). ## Passe o tracking da sua loja Shopware para server-side Envie a conversão de compra em server-side para Meta CAPI, GA4, TikTok, Pinterest e Microsoft Advertising: assinada por HMAC, fail-safe para o checkout, alojada na UE e sensível ao consentimento. [Criar uma conta](https://admin.datafirefly.com/pricing?lang=pt) [Vamos conversar](https://server-side.datafirefly.com/pt/contact.html)