# Módulo de tracking server-side para PrestaShop > Envie as conversões PrestaShop para Meta, GA4 e Google Ads a partir do servidor. Módulo nativo, respeita o consentimento, alojado na UE. - Página original: https://server-side.datafirefly.com/pt/prestashop-server-side-tracking.html - Idioma: pt - Atualizado em: 2026-07-28 - Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/ --- Módulo PrestaShop 1.7.6+: versão 1.0.1 Instale o módulo **datafirefly_serverside** na sua loja PrestaShop 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 de modo a que um erro de tracking nunca quebre o checkout, e gating de consentimento RGPD. Uma só chave de ligação, nenhum identificador de píxel para colar no PrestaShop. [Criar uma conta](https://admin.datafirefly.com/pricing?lang=pt) Como instalar o módulo Fail-safe: o checkout nunca é interrompido Assinatura HMAC por loja Alojado na UE O módulo instala-se através de um ZIP a carregar no gestor de módulos, sem necessidade de acesso FTP. O fluxo, de ponta a ponta **A sua loja PrestaShop** Módulo datafirefly_serverside: hook actionValidateOrder **Dispatcher DataFirefly** Alojado na Alemanha: canal autenticado por HMAC Meta CAPI GA4 TikTok Pinterest Microsoft Advertising O problema ## As suas tags de browser PrestaShop deixam fugir vendas O píxel Meta, a tag GA4 ou a tag TikTok do seu tema PrestaShop 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 confirmação de 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 PrestaShop 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 ## A conversão de compra PrestaShop, enviada em server-side O módulo **datafirefly_serverside** capta a compra no hook **actionValidateOrder**, no momento em que a encomenda é validada do lado do servidor, e envia-a **de servidor para servidor, diretamente para a API de conversão de cada plataforma** (CAPI): o canal criado para dados de conversão fiáveis e first-party. ### Compras recuperadas A conversão de compra deixa de depender da sobrevivência das tags de browser aos bloqueadores de anúncios e ao ITP: recupera vendas que de outra forma se perderiam. ### Melhor qualidade de correspondência O módulo capta os identificadores de browser disponíveis (`_fbp`, `_fbc`, `_ttp`, GA `clientId`) para um sinal de correspondência mais rico e mais 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 PrestaShop ## Três passos para um tracking de compra completo 1 ### Instale o módulo PrestaShop Carregue **datafirefly_serverside.zip** em Módulos → Gestor de módulos. O PrestaShop regista automaticamente o hook actionValidateOrder. 2 ### Cole a sua chave de ligação Introduza o seu Tenant ID e o seu segredo HMAC copiados de «Connect your shop» na sua área de cliente DataFirefly (/app). Nenhum identificador de píxel para introduzir. 3 ### A compra segue em server-side Em cada encomenda validada, o evento de compra é assinado por HMAC e entregue ao dispatcher, que o distribui por todos os destinos que tiver configurado. Uma instalação, todas as plataformas. O que o módulo faz ## O conector server-side para PrestaShop, em detalhe ### Conversão de compra server-side Envia o evento purchase na validação da encomenda (hook actionValidateOrder), diretamente para as APIs 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 o browser. ### Fail-safe by design 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 Com «Require consent», a compra só é transmitida se o cliente tiver consentido um serviço publicitário: lido do lado do servidor a partir do cookie tarteaucitron / [DataFirefly Cookie Manager](https://www.datafirefly.com/product/cookie-manager-tarteaucitron-conformite-rgpd-cle-en-main-pour-prestashop/). ### Qualidade de correspondência enriquecida Capta os identificadores de browser disponíveis (\_fbp, \_fbc, \_ttp, GA clientId) juntamente com os dados de encomenda e de cliente. ### Botão «Send test event» Verifique a conectividade e a assinatura a partir do ecrã de configuração, antes mesmo de passar uma verdadeira encomenda de teste. ### Código protegido por .htaccess O módulo é fornecido com um .htaccess que recusa o acesso web direto aos ficheiros de código-fonte do módulo. ### Alojado na UE O dispatcher corre na Alemanha: os seus dados permanecem na UE. Destinos ## Meta CAPI, GA4, TikTok, Pinterest e Microsoft Advertising a partir do PrestaShop A conversão de compra PrestaShop é distribuída 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 módulo PrestaShop 1.0.1 distribui a compra para Meta CAPI, GA4, TikTok, Pinterest e Microsoft Advertising. Instalação ## Instalar o módulo server-side no PrestaShop Pré-requisitos: PrestaShop 1.7.6.0 ou mais recente, 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 o seu **Tenant ID** (ex.: shop_yourstore_xxxx) e o seu **segredo HMAC** (chave de 64 caracteres). O endpoint está pré-preenchido em https://serverside.datafirefly.com/v1/events. 2 ### Carregue o ZIP no Back Office Módulos → Gestor de módulos → **Carregar um módulo**, depois selecione **datafirefly_serverside.zip** (não descompactar). O PrestaShop instala-o e regista automaticamente o hook actionValidateOrder. 3 ### Configure o módulo Clique em **Configurar**. Introduza o Tenant ID, o segredo HMAC, deixe o endpoint por omissão, defina **Require consent** como **Sim** (recomendado RGPD), depois coloque **Enable tracking** em **Sim** e guarde. 4 ### Verifique a ligação Clique em **Send test event**: uma mensagem de sucesso confirma o Tenant ID, o segredo HMAC e o endpoint. Passe depois uma verdadeira encomenda de teste e abra o **Inspector** em /app para confirmar a chegada do evento purchase (valor, moeda, referência). Os erros de entrega são registados em Parâmetros avançados → Logs (entradas com o prefixo `[DataFirefly SS]`). Uma falha de tracking é registada mas nunca interrompe a encomenda. Preços ## Preços simples que crescem com a sua loja Uma só subscrição cobre toda a sua conta: todas as suas lojas PrestaShop: 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 PrestaShop 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 módulo PrestaShop 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. **Ingestão autenticada por HMAC** Cada envio de compra é assinado por loja (HMAC-SHA256). **Respeito pelo consentimento** A compra só é transmitida com consentimento publicitário, lido do lado do servidor. **Credenciais nunca expostas** Os tokens dos destinos permanecem do lado do dispatcher, nunca no browser. **Código do módulo protegido** Um .htaccess recusa o acesso web direto aos ficheiros do módulo. **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: módulo PrestaShop ### O que é o módulo de tracking server-side para PrestaShop? O módulo **datafirefly_serverside** (versão 1.0.1, compatível com PrestaShop 1.7.6 e superior) 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 na validação da encomenda, assinado por HMAC para a sua loja. As credenciais dos destinos nunca passam pelo browser. ### O módulo pode quebrar o funil de encomenda da minha loja PrestaShop? Não. O módulo 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 PrestaShop), mas a encomenda conclui sempre normalmente. ### Preciso de colar identificadores de píxel no PrestaShop? Não. Introduz apenas o seu Tenant ID e o seu segredo HMAC, copiados 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 módulo respeita o consentimento RGPD? Sim. Com a opção **Require consent** ativada, a compra só é transmitida se o comprador tiver consentido um serviço publicitário, consentimento lido do lado do servidor a partir do cookie tarteaucitron / DataFirefly Cookie Manager. 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 módulo PrestaShop e a uma chave de ligação. Está no WooCommerce? [Conheça o plugin server-side para WooCommerce](https://server-side.datafirefly.com/pt/woocommerce-server-side-tracking.html). ## Passe o tracking da sua loja PrestaShop 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)