Módulo PrestaShop 1.7.6+: versão 1.0.1

Módulo de tracking server-side para PrestaShop

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.

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-1.0.1.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.

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.

Meta Conversions API CAPI GA4 Measurement Protocol
TikTok Events API
Pinterest Conversions API
Google Ads Data Manager API
Microsoft Advertising Conversions API

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-1.0.1.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

Starter

Para uma única loja PrestaShop a pôr o tracking server-side a funcionar.

39 € / mês
1 site incluído
Até 500 mil eventos / mês
Uma fatura consolidada
Escolher Starter

Scale

Para agências e portfólios que gerem até vinte lojas com maior volume.

349 € / mês
20 sites incluídos
Até 10 milhões de eventos / mês
Uma fatura consolidada
Escolher Scale

O módulo PrestaShop está incluído em todos os planos. Veja o detalhe dos preços na página inicial.

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, 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.

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.