Plugin Shopware 6.5 / 6.6: versão 1.0.0

Plugin de tracking server-side para Shopware

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.

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.

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 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õesCarregar 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

Starter

Para uma única loja Shopware que põe em marcha o seu tracking server-side.

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

Scale

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

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

O plugin Shopware está incluído em todos os planos. Consulte o detalhe dos preços na página inicial.

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, 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 ou o plugin server-side para WooCommerce.

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.