Tracking server-side da Meta Conversions API (CAPI)
Envie as conversões da sua loja para a 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. a partir do servidor, já não do navegador: desduplicadas com o seu pixel Meta através de um identificador de evento partilhado, condicionadas ao consentimento de marketing e tratadas na UE. Sem CAPI Gateway para instalar na sua própria cloud, sem contentor GTM de servidor para configurar: uma chave de ligação, e o mesmo evento chega também ao GA4, TikTok, Pinterest, Google Ads e Microsoft Advertising.
O seu dataset ID e o seu token de acesso ficam cifrados do nosso lado: nunca os cola na sua loja.
O que é a Meta Conversions API?
A Meta Conversions API, habitualmente abreviada para Meta Conversions API, é uma interface de servidor para servidor. Em vez de pedir ao navegador do visitante que comunique uma compra à Meta, é o seu servidor que envia o evento diretamente. O pedido sai da sua infraestrutura, por isso um bloqueador de anúncios ou uma política de cookies do navegador não têm nada para intercetar.
A CAPI não substitui o pixel
A própria Meta recomenda usar os dois. O pixel capta sinais do navegador que o servidor nunca vê; o evento de servidor sobrevive quando o pixel é bloqueado. Juntos e desduplicados, cobrem os pontos cegos um do outro.
É o identificador de evento que evita a contagem em duplicado
Os dois lados enviam o mesmo event_id para a mesma conversão. A Meta associa-os e guarda uma. Sem esse identificador partilhado, usar pixel e CAPI em conjunto inflaciona as conversões declaradas.
Server-side não quer dizer sem consentimento
Mover uma tag para o servidor muda de onde parte o pedido, não o facto de precisar de autorização para o enviar. O consentimento de marketing continua a aplicar-se e verificamo-lo nas duas camadas.
Procura a visão de conjunto em vez da Meta em concreto? Leia o que é o tracking server-side e como funciona.
Porque é que só o pixel Meta declara menos vendas do que faz
O pixel corre no navegador do cliente: o único elo da cadeia que não controla, e o que está sob maior pressão.
-
Os bloqueadores de anúncios
impedem o pixel de carregar na página de confirmação: a compra pura e simplesmente nunca é comunicada à Meta.
-
O Safari ITP e os limites de cookies dos navegadores
encurtam ou apagam o cookie
_fbpem que o pixel se apoia para ligar uma venda ao anúncio que a gerou. -
Parâmetros de cliente pobres
dão uma Event Match Quality baixa: o navegador raramente tem o e-mail ou o telefone em hash que a sua encomenda já contém.
O problema não é apenas um buraco nos relatórios. A otimização de entrega da Meta aprende com as conversões que recebe: vendas declaradas a menos significam um algoritmo a otimizar sobre uma imagem parcial de quem compra de facto.
Uma ligação Meta CAPI gerida, sem a canalização
Instale o conector da sua plataforma, ou chame a nossa API diretamente: cada passo do funil é replicado do lado do servidor para a Meta Conversions API, desduplicado com o pixel e condicionado ao consentimento.
Conversões que sobrevivem ao navegador
A compra do lado do servidor parte da sua infraestrutura. Quando o pixel está bloqueado, é esse o evento que a Meta recebe.
A desduplicação tratada por nós
O conector emite o mesmo event_id
(order_<id> para as compras) dos dois lados. Não tem de montar a lógica de correspondência.
Parâmetros de cliente mais ricos
O evento de servidor pode levar o e-mail e o telefone em hash a partir da encomenda, além de fbp/fbc, o endereço IP e o user agent: os dados que determinam a Event Match Quality.
Nada se perde pelo caminho
Uma fila de repetição repete automaticamente os envios falhados que podem ser repetidos, para que uma falha breve de um lado ou do outro não lhe custe uma conversão.
Consentimento aplicado duas vezes
A camada do navegador não injeta nada sem consentimento de marketing e o dispatcher aplica uma segunda verificação antes de algo chegar à Meta.
O token nunca na sua loja
O seu dataset ID e o seu token de acesso CAPI estão cifrados do nosso lado. Um front-end de loja comprometido não os pode expor.
O Inspector para o provar
Cada evento e o seu estado por destino são visíveis no Inspector, por isso confirma a entrega à Meta em vez de a presumir.
Um evento, seis destinos
A mesma conversão chega também ao GA4, TikTok, Pinterest, Google Ads e Microsoft Advertising, sem construir uma segunda integração.
Ligar a sua loja à Meta Conversions API
Adicione as suas credenciais Meta uma vez
Na sua conta DataFirefly, adicione o seu dataset ID da Meta e um token de acesso da Conversions API gerado no Events Manager. Ficam guardados cifrados e nunca são enviados para a sua loja.
Instale o conector da sua plataforma
PrestaShop,
WooCommerce ou
Shopware, depois cole a sua única chave de ligação dfss_ . Em qualquer outra tecnologia, envie os seus eventos para a nossa API.
Verifique no Events Manager
Faça uma encomenda de teste, procure no Inspector um
purchase entregue e confirme o mesmo evento no Meta Events Manager, com as linhas de pixel e de servidor fundidas numa só.
CAPI Gateway, GTM de servidor ou conector gerido?
Três caminhos levam à mesma Conversions API. Distinguem-se pelo que tem de manter a funcionar e por a Meta ser, ou não, o único destino.
A Conversions API Gateway da Meta
Uma infraestrutura que instala e paga na sua própria conta de cloud. Próxima das ferramentas da Meta e dedicada à Meta. O alojamento, as atualizações e a fatura são seus.
GTM de servidor
Um contentor GTM de servidor que aloja e configura, com uma tag Meta lá dentro. Controlo máximo sobre tags e variáveis, e verdadeiras competências de GTM para o construir e manter.
DataFirefly
Um conector gerido: sem contentor, sem conta de cloud, uma chave. Meta CAPI mais GA4, TikTok, Pinterest, Google Ads e Microsoft Advertising a partir do mesmo evento, alojado na UE.
Quando outro caminho lhe convém mais. Se a Meta é o seu único canal e quer manter tudo dentro do ecossistema da Meta, a CAPI Gateway é uma escolha perfeitamente sensata. Se tem competências de GTM em casa e precisa de controlo das transformações tag a tag, o GTM de servidor é mais flexível do que nós. Encaixamos melhor quando quer que as conversões cheguem de forma fiável a várias plataformas sem se tornar uma equipa de infraestrutura de tracking. Veja também as nossas páginas Alternativa ao Addingwell e FAQ .
Tracking Meta CAPI para cada plataforma de e-commerce
PrestaShop
Um módulo nativo que envia todo o funil para a Meta CAPI, com desduplicação e gestão do consentimento integradas.
WooCommerce
Um plugin WordPress com fila de repetição, painel Activity e suporte a HPOS, que entrega as compras do lado do servidor à Meta.
Shopware 6
Um plugin Shopware que cobre o mesmo funil, ligado com a mesma chave única.
Shopify
Os webhooks de encomenda do Shopify, subscritos em minutos com a mesma chave única. Nada a colocar no tema.
Num front-end headless ou numa tecnologia própria? Envie os seus eventos para a nossa API: o dispatcher trata a Meta CAPI e todos os outros destinos da mesma forma. Conte-nos como está montado.
Meta CAPI incluída em todos os planos
Uma subscrição cobre toda a sua conta e todos os seus destinos: a Meta CAPI não é uma opção paga. Suba de nível para mais sites e mais eventos por mês.
Grátis
Gratuito
Começar gratuitamente
Para uma loja que quer pôr a Meta CAPI a funcionar como deve ser.
Faturado 390 € por ano: compromisso de 12 meses, sem reembolso proporcional.
O mais popular
Growth
Faturado 1 190 € por ano: compromisso de 12 meses, sem reembolso proporcional.
Escolher Growth
Scale
Faturado 3 490 € por ano: compromisso de 12 meses, sem reembolso proporcional.
Prefere testar primeiro a ligação? O plano gratuito deixa-o enviar eventos e vê-los chegar antes de subscrever.
Enviar dados à Meta, dentro do quadro europeu
O tracking server-side muda de onde parte o pedido. Não o tira do RGPD: por isso integrámos as verificações de consentimento em vez de as contornar.
Os eventos são tratados na UE antes de chegarem à Meta.
Nada dispara do lado do navegador sem consentimento de marketing, e o servidor volta a verificar.
O seu token CAPI está cifrado em repouso e nunca é enviado ao navegador nem à loja.
O e-mail e o telefone são transformados em hash como a Meta exige: nenhum identificador em claro é enviado.
Um acordo de tratamento de dados que cobre este fluxo está na nossa página do DPA.
Acompanhado em tempo real na nossa Medido e monitorizado em tempo real na nossapágina de estado pública
Perguntas frequentes: Meta Conversions API
O que é a Meta Conversions API (CAPI)?
Uma interface de servidor para servidor que permite ao seu próprio servidor enviar os eventos de marketing (visualização de página, adicionar ao carrinho, compra) diretamente à Meta, em vez de depender do pixel Meta que corre no navegador do visitante. Como o pedido sai da sua infraestrutura e não do navegador, não é afetado por bloqueadores de anúncios nem por restrições dos navegadores aos cookies. A Meta recomenda usar o pixel e a Conversions API em conjunto, com os dois lados desduplicados.
Como se liga um site à Meta Conversions API?
Três caminhos habituais: escrever a sua própria integração contra a API da Meta, instalar a Conversions API Gateway da Meta na sua infraestrutura de cloud, ou usar um conector gerido. Com a DataFirefly instala o conector da sua plataforma (PrestaShop, WooCommerce, Shopware) ou chama a nossa API, e depois cola uma única chave de ligação. O seu dataset ID e o seu token de acesso ficam do nosso lado, cifrados: nunca os cola na sua loja.
A Conversions API vai contar as minhas conversões duas vezes?
Não, quando a desduplicação está configurada. Cada conversão leva um identificador de evento partilhado (order_<id> para as compras) enviado tanto pelo pixel do navegador como pelo evento de servidor. A Meta associa-os por esse identificador e conta a conversão uma só vez. Se o pixel estiver bloqueado, o evento de servidor chega na mesma e a conversão fica registada: é precisamente por isso que se usam os dois.
Qual a diferença entre a Conversions API e a CAPI Gateway?
A Conversions API é a interface em si. A Conversions API Gateway da Meta é uma forma de lá chegar: uma infraestrutura que instala e paga na sua própria conta de cloud, dedicada à Meta. A DataFirefly é uma alternativa gerida que chega à mesma API sem qualquer infraestrutura do seu lado, e envia o mesmo evento ao GA4, TikTok, Pinterest, Google Ads e Microsoft Advertising ao mesmo tempo.
O tracking server-side para a Meta cumpre o RGPD?
O tracking server-side não elimina a necessidade de consentimento. Os nossos conectores condicionam a camada do navegador e a camada do servidor ao consentimento de marketing, e o dispatcher aplica uma segunda verificação antes de um evento sair para a Meta. Os eventos são tratados na UE (Alemanha), está disponível um DPA , e o token de acesso nunca sai do nosso servidor. O server-side é um mecanismo de fiabilidade e de qualidade do dado, não uma forma de contornar um banner de consentimento.
A Conversions API melhora a Event Match Quality?
Pode melhorar. Um evento de servidor pode levar parâmetros de cliente que o navegador perde muitas vezes: e-mail e telefone em hash a partir da encomenda, os identificadores
fbp e fbc , o endereço IP e o user agent. Mais parâmetros associados significam por norma uma pontuação de Event Match Quality mais alta no Events Manager, que é aquilo em que a Meta se apoia para atribuir conversões a um anúncio. O quanto melhora depende dos parâmetros que a sua loja tem realmente no momento da conversão.
Meta, Facebook e Instagram são marcas da Meta Platforms, Inc. A DataFirefly não é afiliada da Meta. Os nomes dos produtos são usados para descrever a interoperabilidade.
Deixe de perder conversões Meta por causa do navegador
Envie o funil completo e desduplicado para a Meta Conversions API: respeitador do consentimento, alojado na UE, com GA4, TikTok, Pinterest, Google Ads e Microsoft Advertising a partir do mesmo evento.