# Plugin de tracking server-side para WooCommerce > O plugin WooCommerce que envia as conversões para Meta, GA4 e Google Ads a partir do servidor. Fila de reenvio, alojado na UE. - Página original: https://server-side.datafirefly.com/pt/woocommerce-server-side-tracking.html - Idioma: pt - Atualizado em: 2026-07-28 - Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/ --- Plugin WordPress / WooCommerce: versão 2.0.1 Instale o plugin **datafirefly-serverside** na sua loja WooCommerce e envie o **full-funnel cliente + servidor** (page view, produto, adição ao carrinho, checkout, compra) para **Meta Conversions API (CAPI), GA4, TikTok, Pinterest e Microsoft Advertising**. Deduplicação num event ID partilhado, fila de reprocessamento, painel Activity e gating de consentimento RGPD. Uma só chave `dfss_`, nenhum identificador de píxel para colar. [Criar uma conta](https://admin.datafirefly.com/pricing?lang=pt) Como instalar o plugin Deduplicação cliente + servidor Fila de reprocessamento automática Alojado na UE O plugin instala-se através de um ZIP a carregar em Plugins → Adicionar novo: compatível com WooCommerce HPOS. O fluxo, de ponta a ponta **A sua loja WooCommerce** Plugin datafirefly-serverside: cliente + servidor, full-funnel **Dispatcher DataFirefly** Alojado na Alemanha: canal autenticado por HMAC Meta CAPI GA4 TikTok Pinterest Microsoft Advertising O problema ## As suas tags de browser WooCommerce deixam fugir vendas O píxel Meta, a tag GA4 ou a tag TikTok do seu tema WordPress correm no browser do cliente: onde são cada vez mais bloqueados antes mesmo de dispararem. - **Os bloqueadores de anúncios** impedem as tags de carregar na página de agradecimento: 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 ao longo de todo o percurso de compra. O resultado: conversões WooCommerce incompletas, pior qualidade de correspondência e campanhas que otimizam com base numa visão parcial. Está a pagar por vendas que não consegue medir na totalidade. A solução ## Um tracking completo WooCommerce, cliente + servidor O plugin **datafirefly-serverside** injeta uma camada de cliente leve que segue todo o funil, e duplica cada conversão com um **evento server-side enviado diretamente para a API de conversão** de cada plataforma (CAPI). A compra server-side é a conversão de referência, resistente aos bloqueadores de anúncios. ### Conversões recuperadas A compra server-side é entregue mesmo quando um bloqueador de anúncios elimina o píxel de cliente: recupera conversões que de outra forma se perderiam. ### Zero contagem em duplicado O píxel de cliente e o evento de servidor partilham um event ID (`order_`): os destinos deduplicam e contam cada conversão uma só vez. ### Nada se perde Uma fila de reprocessamento com cron de 5 minutos reenvia as falhas de entrega: uma breve indisponibilidade do dispatcher não custa nenhuma conversão. Como funciona no WooCommerce ## Três passos para um tracking full-funnel 1 ### Instale o plugin WooCommerce Carregue **datafirefly-serverside-2.0.1.zip** em Plugins → Adicionar novo → Carregar plugin, depois ative. A ativação cria a tabela da fila de reprocessamento e o cron de 5 minutos. 2 ### Cole a sua chave de ligação Em Definições → DataFirefly Server-Side, cole a sua chave única (`dfss_...`) obtida em «Connect your shop» em /app. Ela ativa o tracking completo e o consentimento, e lança um teste. 3 ### Os eventos seguem em server-side Cada etapa do funil sobe ao dispatcher, que a distribui por todos os seus destinos. A compra server-side, deduplicada, é a conversão de referência. O que o plugin faz ## O conector server-side para WooCommerce, em detalhe ### Tracking full-funnel cliente + servidor Injeta tags de cliente leves e segue page view, produto, adição ao carrinho, checkout e compra, duplicados por eventos server-side. ### Deduplicação num event ID partilhado Um só event ID (`order_`) por conversão: os destinos contam uma só vez, mesmo que cliente e servidor disparem. ### Compra server-side idempotente A compra é idempotente nos hooks payment_complete / processing / completed através de um bloqueio otimista: a conversão de referência, resistente aos bloqueadores. ### Fila de reprocessamento + cron 5 min As falhas de entrega recuperáveis são reenviadas automaticamente: uma breve indisponibilidade do dispatcher nunca perde uma conversão. ### Painel DataFirefly Activity Estado de ligação, entregues nas últimas 24 h, à espera de reprocessamento, e tabela ao vivo (atualizada a cada 30 s) dos eventos recentes e do seu estado. ### Consentimento multi-CMP Deteta automaticamente WP Consent API, Complianz, Cookiebot, IAB TCF v2 e [DataFirefly Cookie Consent](https://www.datafirefly.com/product/datafirefly-cookie-consent-rgpd-consent-mode-v2/). Nada dispara sem consentimento de marketing. ### Chave única dfss\_, zero píxel Uma chave de ligação configura cliente e servidor. O dispatcher fornece os IDs de destino: nunca cola um identificador de píxel. ### Compatível com WooCommerce HPOS Suporte declarado para as tabelas de encomendas personalizadas (HPOS), para lojas de grande volume. Destinos ## Meta CAPI, GA4, TikTok, Pinterest e Microsoft Advertising a partir do WooCommerce O funil WooCommerce é distribuído em server-side para as APIs de conversão das suas plataformas. Configure uma vez na sua área DataFirefly. [![Logótipo 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 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 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 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 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 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 WooCommerce 2.0.1 distribui o funil para Meta CAPI, GA4, TikTok, Pinterest e Microsoft Advertising. Instalação ## Instalar o plugin server-side no WooCommerce Pré-requisitos: WordPress 5.8+, WooCommerce 5.0+ (HPOS suportado), PHP 7.4+, 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» da sua área de cliente DataFirefly (/app), copie a sua **chave de ligação** (uma única cadeia que começa por `dfss_`). Ela codifica o Tenant ID, o segredo HMAC e o endpoint. 2 ### Carregue o ZIP no WP Admin Plugins → Adicionar novo → **Carregar plugin**, selecione **datafirefly-serverside-2.0.1.zip**, instale e depois **Ative**. A ativação cria a fila de reprocessamento e agenda o cron de 5 minutos. 3 ### Ligue com a chave única Definições → DataFirefly Server-Side → **Connect your shop**: cole a chave `dfss_...` e clique em **Connect**. O tracking completo e o consentimento ativam-se, a configuração é obtida do dispatcher e um teste é lançado automaticamente. 4 ### Verifique em Activity + Inspector Clique em **Send test event**, depois abra **Definições → DataFirefly Activity** para ver o estado ao vivo. Passe uma encomenda de teste e confirme uma linha `purchase` «Delivered», depois valide no Inspector (/app). Atrás de um CDN ou reverse proxy, forneça o verdadeiro IP do cliente através do filtro `dfss_client_ip` para um melhor rate limiting e uma melhor qualidade de correspondência CAPI. Preços ## Preços simples que crescem com a sua loja Uma só subscrição cobre toda a sua conta: todas as suas lojas WooCommerce: numa só fatura consolidada. Suba de plano para mais sites e mais eventos por mês. ### 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 WooCommerce a pôr o tracking server-side a funcionar. **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é **500 mil** 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 exploram 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é **2 milhões** de eventos / mês Uma fatura consolidada [Escolher Growth](https://admin.datafirefly.com/pricing?lang=pt&plan=growth) ### Scale Para agências e portfó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é **10 milhões** de eventos / mês Uma fatura consolidada [Escolher Scale](https://admin.datafirefly.com/pricing?lang=pt&plan=scale) O plugin WooCommerce está incluído em todos os planos. Veja o [detalhe dos preços na página inicial](https://server-side.datafirefly.com/pt/#pricing). Confiança & RGPD ## Concebido para os padrões europeus de privacidade **Alojado na UE (Alemanha)** Os seus dados são processados na UE. **Consentimento multi-CMP** WP Consent API, Complianz, Cookiebot, IAB TCF v2, DataFirefly Cookie Consent. **Beacon endpoint reforçado** Rate limiting por IP, limite de tamanho, sanitização por campo, identidade do lado do servidor. **Segredo HMAC nunca exposto** A chave de assinatura nunca sai do servidor; os tokens dos destinos também não. **Entrega fiável** Fila de reprocessamento + cron 5 min: uma indisponibilidade passageira não perde nenhuma conversão. **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 WooCommerce ### O que é o plugin de tracking server-side para WooCommerce? O plugin **datafirefly-serverside** (versão 2.0.1) assegura um tracking completo para WooCommerce: cliente + servidor, full-funnel (page view, product view, add to cart, checkout, purchase). Os eventos são enviados para a API de conversão de cada plataforma (Meta CAPI, GA4, TikTok, Pinterest, Microsoft Advertising). A compra server-side é a conversão de referência, resistente aos bloqueadores de anúncios. ### O plugin vai contar as minhas conversões WooCommerce duas vezes? Não. Cada conversão transporta um event ID partilhado (`order_` para as compras). O píxel de cliente injetado e o evento server-side são deduplicados pelos destinos com base nesse ID: a conversão é contada uma só vez, mesmo quando os dois disparam, e o caminho de servidor entrega-a quando um bloqueador de anúncios elimina o píxel de cliente. ### Como se liga o plugin WooCommerce? Numa só chave. A partir de «Connect your shop» na sua área de cliente DataFirefly (/app), copie a sua chave de ligação (começa por `dfss_`) e cole-a em Definições → DataFirefly Server-Side. Ela codifica o Tenant ID, o segredo HMAC e o endpoint, ativa o tracking completo e o consentimento, e lança um teste automaticamente. Não cola qualquer identificador de píxel. ### O plugin trata do consentimento e das CMP (RGPD)? Sim. Com **Require consent** (ativo por omissão), o plugin faz o gating das duas camadas com base no consentimento de marketing e deteta automaticamente a sua stack: WP Consent API, Complianz, Cookiebot, IAB TCF v2 e DataFirefly Cookie Consent. O tracker de browser nada injeta enquanto o consentimento não for concedido, e o endpoint de servidor aplica uma segunda verificação de consentimento. ### O plugin é compatível com o HPOS e com cargas elevadas? Sim. A compatibilidade WooCommerce HPOS (tabelas de encomendas personalizadas) está declarada. Uma fila de reprocessamento com um cron de 5 minutos reenvia automaticamente as falhas de entrega recuperáveis: uma breve indisponibilidade do dispatcher não perde nenhuma conversão. Um painel **DataFirefly Activity** mostra o estado em tempo real. Está no PrestaShop? [Conheça o módulo server-side para PrestaShop](https://server-side.datafirefly.com/pt/prestashop-server-side-tracking.html). ## Passe o tracking da sua loja WooCommerce para server-side Envie o funil completo, deduplicado, em server-side para Meta CAPI, GA4, TikTok, Pinterest e Microsoft Advertising, com fila de reprocessamento, painel Activity, alojado 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)