Configuração do rastreamento do lado do servidor do Facebook com Facebook Conversions API

Ira Holubovska

Ira Holubovska

Autor
Atualizado
24 de mar de 2026
Também disponível

O pixel do Facebook permite que você acompanhe o que os utilizadores estão a fazer no seu site, recolher públicos de remarketing e criar sósias. Se o pixel do Facebook for implementado correctamente, irá passar a informação relevante aos algoritmos de aprendizagem automática da FB. O FB ML (aprendizagem automática da FB) utilizará dados de pixel para mostrar os seus anúncios a pessoas com maior probabilidade de conversão.

Durante vários anos, foi possível acompanhar eventos no site através de código javascript, SDK do Facebook dentro de aplicações, ou carregar eventos offline. Mas como se pode rastrear os utilizadores que instalaram o Ad Blocker ou rastrear eventos fora do site? Ou como é que se pode prolongar a vida útil de um cookie? Isto pode ser feito através da implementação da API de Conversões do Facebook. Este artigo irá mostrar-lhe como configurar a API de Conversões do Facebook através de Contentor do Servidor do Gestor de etiquetas do Google.

Este artigo se concentrará na API de Conversões Facebook e mostrará a você como configurar a API de Conversões Facebook por meio do contêiner de servidor do Google Tag Manager. Você pode obter mais informações sobre o Facebook Conversion API Gateway em nosso blog. A propósito, confira os modelos pré-configurados da Stape para o Meta CAPI. Agora está mais fácil do que nunca configurar sua instalação: tudo está pronto para você!

O que é a API de Conversões do Facebook?

Vamos ver o que é a API de Conversões do Facebook e como podemos utilizá-la para melhorar o rastreamento de eventos, atribuição, e recolha de dados no Facebook. A API de Conversões do Facebook permite o envio de quaisquer eventos de um servidor de nuvem para o pixel do Facebook seleccionado.

A API de Conversões do Facebook tem o mesmo objectivo que um pixel do Facebook, mas têm tecnologias diferentes por detrás deles. As políticas e restrições fizeram com que a API de Conversões do Facebook fosse mais adaptada às necessidades do ambiente de rastreamento moderno. Quanto à API de Conversões do Facebook, esta não envolve o navegador do utilizador para o envio de informação de rastreamento. Tudo é feito através do servidor da nuvem. Isso torna os dados dos utilizadores mais seguros e precisos.

Se observarmos mais de perto o link dos anúncios do Facebook, veremos que, no final de quase todos os URLs, o FB acrescenta seu parâmetro adicional fbclid. O código de pixel na página de destino armazena o valor desse parâmetro em um cookie e o envia junto com qualquer evento do Facebook. Junto com o ID do clique (fbclid), o Facebook usa o ID do navegador (fbp). Os cookies fbp e fbc ajudam o FB a determinar que tipo de usuário chegou ao seu site e quem converteu.

FB pode comparar utilizadores através de outros parâmetros tais como e-mail, número de telefone, o nome próprio/apelido, etc. Quanto mais dados de utilizador enviar para a API de Conversões do Facebook, maior será a taxa de correspondência que receber.

Quais são as principais vantagens da API de conversões Meta?

A etiquetagem do lado do servidor do Facebook ou API de conversões Meta esteve disponível no Facebook durante alguns anos. Mas a partir de 2021, a FB começou a pressionar mais a API de Conversões. Se tiver um representante do Facebook empenhado que ajude com a sua conta de anúncios, é muito provável que ele lhe ligue e recomende a configuração de uma API de conversões Meta.

Esses são os motivos mais importantes para considerar a implementação da API de Conversões Facebook. Veja os detalhes abaixo do infográfico.

Benefits of Facebook Conversions API
Benefits
  1. Pode ajudá-lo a rastrear os utilizadores que instalaram AdBlocker ou aqueles que utilizam Safari (ou qualquer outro navegador com algoritmos da prevenção de rastreamento inteligente). É possível porque os pedidos são enviados a partir de um servidor, não a partir do navegador do utilizador. E os cookies de terceiros não serão bloqueados. Por conseguinte, terá dados mais fiáveis. 
  2. Uma vida útil prolongada dos cookies. Com a ajuda da API de conversões do Facebook, vai prolongar a vida útil do cookie do Facebook para 6 meses. Se não estiver a utilizar a API de conversões do Facebook, o Safari limitará a vida útil dos cookies a 1-7 dias.
  3. A API Conversões dá-lhe mais controlo sobre os seus dados e uma melhor compreensão da viagem do cliente.
  4. Pode usar a API de Conversões do Facebook para rastrear eventos que não acontecem no site. Por exemplo, chamadas telefónicas ou vendas offline.

Exemplo real do valor da Meta Conversions API

Ao integrar a Conversions API juntamente com o Meta Pixel, a Ray-Ban conseguiu melhorar significativamente os seus resultados publicitários. A combinação levou a um alcance 36% maior no Facebook e Instagram em comparação com a utilização do Meta Pixel sozinho.

Ray-Ban case study results

Além disso, a marca registou uma redução de 19% no custo por 1.000 visualizações e uma diminuição de 7% no custo por conversão, demonstrando a eficácia da Conversions API na otimização das suas campanhas e na obtenção de melhores resultados.

Formas de configurar o rastreamento do lado do servidor do Facebook

Usando o Meta Conversions API Gateway

O Meta Conversions API Gateway é a solução mais rápida para implementar o rastreamento do lado do servidor da Meta e não requer nenhum conhecimento especializado.

A principal característica do Conversions API Gateway é o seu ambiente. Cada instância do Conversions API Gateway requer um servidor na nuvem para gerir todos os processos de comunicação entre o Meta Pixel e a Conversions API. Para uma compreensão mais aprofundada, consulte a documentação da Meta sobre como funciona o Conversions API Gateway.

Uma vez que o Meta Pixel esteja conectado ao ambiente do Conversions API Gateway, ele usará eventos web para rastrear dados do servidor. Portanto, antes de implementar o Conversions API Gateway, é essencial garantir que os eventos web sejam 100% precisos e contenham todas as informações necessárias do utilizador e do produto.

Com o Stape, configurar e hospedar o Conversions API Gateway é mais fácil do que nunca. Basta criar uma conta Stape e configurar o Conversions API Gateway dentro do Stape. Em seguida, conecte os Meta Pixels necessários ao ambiente do Conversions API Gateway.

Prós:

1. Preço baixo. O alojamento Stape para o Conversions API Gateway custa $10/mês por pixel ou $100/mês por 100 pixels. Também oferecemos um período de teste gratuito de 7 dias.

Além disso, o Conversions API Gateway é a forma mais simples de implementar a Conversions API, permitindo-lhe poupar centenas ou até milhares de dólares em comparação com uma implementação manual.

2. Configuração fácil. Não precisa de contratar programadores ou especialistas em rastreamento para configurar o Conversions API Gateway. O processo de configuração é simples e pode levar menos de 1 minuto, mesmo para quem não tem competências técnicas.

3. Sem manutenção. As atualizações do Conversions API Gateway são instaladas automaticamente. Não é necessário gastar tempo a atualizar manualmente configurações ou servidores. Mesmo quando adiciona um novo evento, basta configurar o rastreamento web adequado, e o Conversions API Gateway começará automaticamente a rastrear eventos do servidor.

Contras:

1. Novo. O Conversions API Gateway é novo, e a Meta provavelmente lançará novas funcionalidades e atualizações às existentes. Portanto, faz sentido preparar-se para alterações nas suas funcionalidades.

2. Sem suporte para outras plataformas. Se quiser tirar o máximo partido do rastreamento do lado do servidor, o servidor Google Tag Manager (sGTM) pode ser uma melhor solução. Ainda precisará de uma instância do Google Tag Manager para gerir o Google Analytics (GA) do servidor, Google Ads, etc.

O Stape oferece alojamento para o Conversions API Gateway a um custo de $10 por pixel por mês ou $100 por 100 pixels por mês. Além disso, todos os utilizadores recebem um período de teste gratuito de 7 dias.

Stape CAPIG pricing

Para configurar o Conversions API Gateway com o Stape, tudo o que precisa de fazer é:

  1. Conectar o hub do Conversions API Gateway ao Meta Pixel.

Depois de criar o contentor do Conversions API Gateway no Stape, configuraremos uma pilha de formação na nuvem da Amazon Web Services com base nos requisitos da Meta e geriremos todas as atualizações.

Para um guia passo a passo, consulte a nossa publicação sobre como configurar o Meta Conversions API Gateway.

Consulte o nosso artigo sobre comparação entre Meta CAPI e Meta CAPIG para escolher a solução certa para as suas necessidades.

Usando o servidor GTM

Uma das formas mais acessíveis é usar o servidor Google Tag Manager (sGTM). Com o sGTM, as empresas podem enviar dados de clientes diretamente para os servidores do Facebook.

Prós de configurar o Facebook CAPI via sGTM:

  • Opções de personalização flexíveis
  • Capacidade de implementar rastreamento puramente do lado do servidor e híbrido (web + servidor)
  • Oportunidade de enriquecimento de dados

Contras de configurar o Facebook CAPI via sGTM:

  • Requer conhecimento técnico do servidor Google Tag Manager
  • Necessita de infraestrutura na nuvem para hospedar o sGTM

Neste artigo, vamos focar-nos na configuração do rastreamento do lado do servidor do Facebook via servidor GTM.

Como configurar a Facebook Conversions API com o servidor GTM?

Vamos usar o contentor do servidor Google Tag Manager para configurar a Facebook Conversions API. Vai precisar do seguinte para configurar a Facebook Conversions API:

Este vídeo mostra como configurar a Facebook Conversions API usando o Google Analytics 4.

Como configurar a API de Conversão Facebook

2. Envie dados para o contentor GTM do servidor. Os dois tipos mais populares de envio de dados para o sGTM são a configuração do Google Analytics 4 do lado do servidorData Tag/Data Client.

3. Aceda ao seu contentor de servidor do Google Tag Manager. Adicione a tag da API de Conversão Facebook a partir da Galeria de modelos.

Facebook Conversion API tag for server GTM

4. Crie a tag da API de Conversão Facebook dentro do contêiner do servidor do Google Tag Manager. Escolha Tag -> Clique em Novo -> Escolha a Tag do Facebook que você importou na etapa anterior.

Adicione o ID do pixel do Facebook e o Token de acesso à API do Facebook (recomendo adicioná-lo como uma variável, pois precisará desses valores para cada evento do Facebook que deseja rastrear). Se não souber o seu Token de acesso à API do Facebook, esta documentação ajudá-lo-á a encontrá-lo.

Facebook Conversion API tag for server GTM

5. Tem 2 opções para configurar a nossa etiqueta personalizada de API de Conversões do Facebook:

  • Override. Nesse caso, você precisará configurar os eventos do FB manualmente. Abordaremos como configurar manualmente os eventos do servidor do FB na etapa seis. Essa é a opção preferida, mas requer mais tempo e conhecimento para ser implementada. Com isso, você pode ter controle total sobre a carga útil do evento e fazê-lo de acordo com as práticas recomendadas para que os eventos do FB na Web e os eventos do FB no servidor sejam idênticos. 
  • Herdar do cliente. Nesse caso, a tag corresponderá a carga útil de seu evento GA4/Data aos eventos padrão do Facebook. Se a tag não puder combinar o evento do GA com o evento padrão do FB, ela o enviará como um evento personalizado. Tudo será feito automaticamente, você não precisa configurar eventos do FB.

6. Se selecionou a opção override, precisará de usar eventos GA4 ou Data Tag/Data Client para acionar os eventos do servidor do Facebook. O evento pageview do Facebook deve ser acionado num evento personalizado page_view que foi reivindicado por um cliente específico (por exemplo, se escolheu usar o GA4 como fonte de dados para o servidor GTM, então deve usar o evento page_view quando o nome do cliente for igual a GA4).

Para configurar outros eventos, vá ao modo de pré-visualização do sGTM, realize uma ação no seu site que queira rastrear no Facebook e verifique o nome do evento que o GA4 ou Data Tag envia para o seu contentor de servidor.

Na captura de ecrã abaixo, queremos configurar um evento do Facebook ViewContent quando alguém abre a página do produto no nosso site. Certifique-se de que também envia com o seu evento GA4 / Data Tag do contentor web quaisquer dados adicionais que queira usar para o evento do servidor. O exemplo abaixo também usa parâmetros padrão de Facebook eCommerce e dados do utilizador.

Para isso, criámos uma nova tag dentro do contentor do servidor, configurámos para override, selecionámos o evento padrão ViewContent, adicionámos o API Access Token e o Facebook Pixel ID. Também adicionámos User Data e criámos um novo trigger com o nome do evento igual a view_item e Client Name igual a GA4.

Tag configuration
Trigger configuration

7. Pode passar parâmetros personalizados usando os campos Server Event Data Override e Custom Data. Também pode enviar dados dos utilizadores para aumentar a correspondência dos resultados no Facebook através do campo User Data ("Dados do Utilizador"), note que a informação dos utilizadores que pretende enviar para a API de conversões do Facebook deve ser com hash.

Também pode ativar o Event Enhancement para usar o cookie seguro HTTP-only (gtmeec) para enriquecer os dados do evento. Quando esta funcionalidade está ativada, a tag armazena dados do utilizador em cookies e enriquece os eventos com dados do utilizador quando não estão disponíveis. Desta forma, pode aumentar a qualidade de correspondência do evento, o que pode melhorar a atribuição de conversões a campanhas.

Enable Event Enhancement in Facebook CAPI tag

8. Quando terminar de configurar todos os seus eventos do Facebook, abra o modo de depuração do Google Tag Manager e teste se os eventos do Facebook estão a funcionar corretamente. Também pode ir à sua tag do Facebook dentro do contentor do servidor e adicionar o Facebook test ID. Pode encontrar o test ID dentro do Meta Events Manager no separador Test Events.

Test Facebook Conversions API

9. Depois de configurar e verificar que a Facebook Conversions API funciona corretamente, precisa de remover o rastreamento do navegador do FB ou configurar a deduplicação de eventos. Caso contrário, os seus eventos serão duplicados.

Testar a Facebook Conversions API

O primeiro passo para testar o rastreamento do lado do servidor do Facebook é o mesmo que para o Google Analytics. Precisa de garantir que os eventos estão a ser acionados com os triggers corretos. Abra a ferramenta de depuração do GTM, navegue pelas páginas do seu site e realize os eventos que deseja testar. Depois, vá ao separador do depurador do Tag Manager e verifique os resultados.

Primeiro, certifique-se de que o pixel base do FB está a ser acionado numa visualização de página. Se vir o estado da tag como Fail, verifique os pedidos de saída, que devem indicar por que a tag falhou.

Test Facebook CAPI in server Google Tag Manager

Se está a usar a nossa tag de rastreamento do lado do servidor do FB, tem duas opções para enviar eventos do FB: 

  • Inherit from GA client. Neste caso, fazemos automaticamente a correspondência dos eventos GA com os eventos padrão do FB. Se estiver a usar a opção inherit, verá apenas a tag base do FB dentro do modo de depuração do GTM.
  • Override. Selecionar a opção override requer a configuração dos eventos do servidor do FB manualmente dentro do contentor do servidor, tornando-os visíveis no modo de depuração do servidor.

Abra o Events Manager dentro do seu Facebook Business Manager e clique em Test Events. Verá um código de evento de teste que deve adicionar à sua tag do Facebook dentro do Google Tag Manager. Este código permite-lhe testar os eventos do servidor do Facebook em tempo real.

Depois de adicionar o test ID, abra o seu site e realize ações que acionem os seus eventos do FB. Em seguida, volte à ferramenta de testes do Facebook e verifique os eventos apresentados. Na coluna Received From, deve ver Server. Pode clicar no evento para ver os parâmetros registados.

Facebook event deduplication testing tool

Note que o plugin do Chrome Facebook Pixel Helper que usava para verificar os eventos do navegador do Facebook não funciona para a Conversions API. Por isso, precisa de verificar tudo na ferramenta de testes.

Nota: os cookies só serão estendidos se estiver a usar um subdomínio personalizado no URL de etiquetagem. Por exemplo, se o URL do seu site é example.com, então um domínio personalizado para o URL de etiquetagem deve parecer-se com gtm.example.com.

O terceiro passo é semelhante ao que fizemos antes, mas com algumas diferenças. Para verificar a data de expiração dos cookies do Facebook, primeiro precisa de os gerar. Para isso, abra o seu site e adicione fbclid.

Depois de fazer isso, abra as ferramentas de programador, vá a Storage e clique em Cookies. Verifique se _fbc_fbp foram estendidos.

Check fbp and fbc cookies

Modelos e guias pré-construídos para sua plataforma

Com o Stape, você pode aumentar a precisão do rastreamento e os resultados da campanha com a marcação no lado do servidor.

Com base na plataforma que você usa, é possível configurar o rastreamento de forma rápida e eficaz com nossos modelos personalizados. Siga os guias passo a passo para configurar o Meta CAPI usando o GTM do servidor para:

Modelos e guias para Wix, Shopware, Prestashop e outros serão disponibilizados em breve. Informe-nos se precisar de um modelo para outro CMS.

Deduplicação de eventos para Facebook Pixel e eventos da Conversions API

O Facebook recomenda usar tanto o Pixel como a Conversions API para rastrear eventos, mas sem deduplicação de eventos, os dados duplicados do navegador e do servidor podem distorcer os resultados. A deduplicação garante que apenas um evento é mantido, usando IDs de evento únicos partilhados entre ambas as fontes. Uma configuração adequada requer gerar e sincronizar estes IDs entre eventos do navegador e do servidor, o que pode ser testado no Events Manager do Facebook.

Além disso, enviar dados do utilizador através da Conversions API melhora a qualidade de correspondência e as pontuações de correspondência de eventos, melhorando o desempenho dos anúncios. Os dados do utilizador devem idealmente vir de um data layer e cumprir as políticas de privacidade. Ferramentas como os plugins do Stape simplificam a integração de dados do utilizador para uma melhor otimização de campanhas do Facebook.

Enviar parâmetros do utilizador usando a Facebook Conversions API

Para corresponder utilizadores que visitam o seu site com a sua base de dados, o Facebook usa User Data para a Conversions API.

O Facebook exige que faça hash de alguns parâmetros antes de os enviar, mas não precisa de se preocupar com isso; a tag do Facebook faz automaticamente o hash de todos os dados antes de serem enviados.

Quanto mais parâmetros do utilizador enviar ao Facebook, maiores são as hipóteses de corresponder um utilizador, resultando numa pontuação de correspondência de eventos mais alta.

Enviar parâmetros do utilizador do seu site para o Facebook é um tema sensível, pois estará a partilhar dados do utilizador com um serviço de terceiros. Portanto, antes de enviar estes dados ao Facebook, certifique-se de que cumprem a sua política de privacidade.

Idealmente, deve ter os dados do utilizador adicionados ao data layer. Se isso não for possível, tente recolhê-los da página usando código JavaScript personalizado e enviá-los juntamente com as conversões ou eventos que lhe interessam.

Por exemplo, todos os plugins do Stape para CMS (para Facebook CAPI para Shopify, rastreamento do lado do servidor para WordPress, Magento 2 Google Tag Manager, aplicação GTM para BigCommerce) adicionam um data layer que também contém dados do utilizador.

Pode facilmente recuperar os dados do data layer e adicioná-los aos eventos do Facebook num contentor web. 

Add data to Facebook events in a web container

Em seguida, transfira os dados necessários para o contentor do servidor (no payload do GA4 ou Data tag, dependendo do que utiliza).

Transfer data to the server container

Finalmente, adicione estes dados ao seu evento do Facebook do lado do servidor.

Add data to the server-side Facebook event

Desta forma, conseguirá uma melhor qualidade de correspondência dos seus eventos do Facebook, potencialmente melhorando o desempenho das suas campanhas publicitárias, pois o Facebook compreenderá melhor o seu público e otimizará as suas campanhas publicitárias.

A ferramenta de testes de eventos do Facebook é um recurso poderoso que lhe permite depurar e resolver problemas com os seus Facebook Pixels ou eventos do servidor. Se existirem erros, serão apresentados no separador Diagnostics na barra de ferramentas para uma revisão mais detalhada.

Os erros marcados a vermelho geralmente requerem atenção imediata e devem ser corrigidos de imediato. Os erros amarelos são avisos não críticos que deve monitorizar e resolver eventualmente.

O Facebook permite-lhe marcar problemas como resolvidos ou ignorá-los. Se marcar um erro como resolvido e ele voltar a ocorrer, o Facebook mostrá-lo-á novamente em três dias. Em contraste, os problemas ignorados vão para a secção Ignored e permanecem lá.

Quando corrigir quaisquer problemas com o seu rastreamento do Facebook, sugerimos marcá-los como resolvidos. Desta forma, notifica o Facebook de que os problemas foram corrigidos, e a plataforma alertá-lo-á se estes problemas voltarem a ocorrer.

Quais são os erros mais comuns do Facebook Pixel e da Conversions API e como corrigi-los?

New domains sending data

Pode ver todos os domínios que enviam dados para o seu Facebook Pixel. Se o Facebook detetar tráfego de um novo subdomínio ou domínio, enviará um aviso. Pode colocar domínios na lista de permissões ou na lista de bloqueio usando esta funcionalidade para bloquear tráfego dos seus sites de teste ou URLs técnicos.

Provavelmente, também verá tráfego de gtm-msr.appspot.com. Isto pode acontecer quando executa um contentor de depuração/publicação ou quando os utilizadores visitam o seu site com JavaScript desativado (alguns bots).

Para criar listas de permissão ou bloqueio de domínios, abra a Events Tool no Business Manager → clique em Settings → deslize para baixo até Traffic Permissions.

Create allow block list in Facebook
Event missing some deduplication parameters

Este é o segundo erro mais comum do Facebook CAPI com base na nossa experiência. Este erro indica que não está a enviar algumas chaves de deduplicação para os seus eventos do servidor. O Facebook usa estas chaves de deduplicação: event name, event ID, _fbp e external ID.

Event deduplication parameters

Com base na nossa experiência, a falta de parâmetros de Event ID causa este erro 80% das vezes. Verifique se está a enviar um event ID tanto para o Facebook Pixel como para a Facebook Conversions API. Este event ID deve ser o mesmo para os eventos do navegador e do servidor, permitindo ao Facebook reconhecer o mesmo event name e event ID para deduplicação.

Por exemplo, para eventos PageView, envie o mesmo event ID e event name tanto do Facebook Pixel como do Facebook CAPI.

Para testar o event ID, abra a ferramenta de testes de eventos do Facebook. Se tudo estiver correto, o seu resultado deve parecer-se com a captura de ecrã abaixo. É assim que o Facebook mostra que registou eventos PageView tanto do navegador como do servidor, que tinham o mesmo event ID, indicando que os eventos do navegador foram processados e os eventos do servidor foram deduplicados.

Event deduplication Facebook testing tool

Mas podem existir situações em que vê eventos do navegador e do servidor acionados aleatoriamente. Neste caso, verifique o event ID do Facebook; provavelmente não são idênticos. Pode usar a nossa variável personalizada para o contentor web para configurar o event ID do Facebook. Para mais informações sobre a deduplicação de eventos do Facebook, consulte a secção acima.

Por vezes, este erro pode ocorrer se não removeu o Facebook test ID e publicou as tags do Facebook CAPI no ambiente de produção. Recomendamos configurar o Test ID como uma variável de tabela de pesquisa que só funciona quando o modo de depuração está ativado para resolver este problema.

Create Facebook test ID Google Tag Manager
Server sending invalid match key

Aqui, o Facebook alerta-o de que os valores enviados do servidor não são únicos ou estão formatados incorretamente. Por exemplo, pode estar a enviar um IP de utilizador que inclui símbolos além de números, ou pode ter selecionado a variável errada, como enviar um número de telefone no campo de email.

Para identificar o problema, abra o modo de pré-visualização do contentor de servidor e web do Google Tag Manager (se usou o GTM para configurar a Facebook Conversions API). Deve ver que parâmetros do utilizador foram enviados ao Facebook e se estão formatados corretamente. Teste o evento, clique na tag no modo de depuração e verifique os valores.

userDataList in Tag Details

Este erro também pode indicar que se esqueceu de incluir um parâmetro ou que está formatado incorretamente.

Por exemplo, houve um cliente que queria enviar o país e a cidade do utilizador com base no endereço IP. O Facebook esperava receber os detalhes reais do endereço do utilizador introduzidos no site, não os extraídos automaticamente do IP. Esta configuração levou a um erro sobre parâmetros de chave inválidos.

Potentially violating personal data sent to Facebook

Este erro geralmente diz respeito a eventos do navegador e indica que o Facebook detetou dados do utilizador no URL. Alguns CMSs e ferramentas, como o Calendly ou o PayPal, enviam detalhes do utilizador no URL após o registo ou a compra.

Este erro é difícil de resolver e requer a atenção dos seus programadores. Devem melhorar os parâmetros de consulta do URL e remover todas as informações do utilizador do URL. Em alternativa, pode seguir as instruções de remoção de informações pessoais identificáveis (PII) e tentar corrigir o problema dentro do GTM. Outra opção é mudar para rastreamento do Facebook exclusivamente do lado do servidor. Isto permitirá modificar o URL antes de o enviar ao Facebook.

Event match quality Facebook

Para cada evento do servidor que envia ao Facebook, é gerada uma pontuação de qualidade de correspondência de eventos. Esta pontuação depende da quantidade de dados do utilizador que envia ao Facebook.

Se usar um subdomínio personalizado para o seu servidor de etiquetagem, apenas o User IP, browser ID, _fbp_fbc são enviados ao CAPI do Facebook. Enviar apenas estes parâmetros do utilizador resulta numa pontuação de qualidade de correspondência de cerca de 4 em 10.

Para atingir uma pontuação de alta qualidade, é crucial enviar o máximo de parâmetros possível. O Facebook usa estes dados para corresponder utilizadores no seu site com os da sua base de dados. Mas antes de prosseguir, certifique-se de que o envio de dados do utilizador ao Facebook cumpre a política de privacidade do seu site e as regulamentações relevantes. Tecnicamente, enviar mais parâmetros é benéfico, pois leva a dados de público e conversão mais precisos, fornece aos algoritmos do Facebook informações específicas sobre os seus utilizadores e melhora o desempenho das campanhas.

Como pode aumentar a pontuação de qualidade de correspondência de eventos? A resposta é simples: envie mais dados do utilizador. No entanto, a implementação pode ser complexa. Primeiro, verifique se o data layer está implementado no seu site e se contém todos os dados do utilizador. Por exemplo, se os utilizadores podem iniciar sessão no seu site, verifique se os detalhes do utilizador são enviados ao data layer ao iniciar sessão.

Se o data layer não estiver implementado, atribua aos seus programadores a sua configuração.

Em seguida, certifique-se de que passa todos os parâmetros do utilizador da web para o contentor do servidor.

Além disso, uma nova funcionalidade do Data Tag pode ajudar a aumentar a qualidade de correspondência. Adicionámos a capacidade de armazenar dados do utilizador. Por exemplo, se um utilizador submeter um formulário de contacto no site, pode usar o Data Tag para armazenar dados do utilizador no armazenamento local e usá-los noutras páginas.

Ao rastrear eventos do Facebook tanto do navegador como do servidor, o Facebook requer um event ID único para cada evento. Para eventos correspondentes, o nome do evento do Facebook Pixel deve corresponder exatamente ao nome do evento do servidor. O mesmo se aplica ao event ID; os eventos do Facebook Pixel devem corresponder igualmente aos eventos do servidor do Facebook. Este é o processo onde ocorre a deduplicação.

Este erro surge quando envia o mesmo event ID para múltiplos eventos. Por exemplo, quando um utilizador chega à página do produto, dois eventos devem ser acionados: PageView e ViewContent. Deve enviar um event ID único para cada evento. Os eventos do FB e os event IDs devem aparecer da seguinte forma:

FB browser: PageView, eventID: ‘69’ FB server: PageView, eventID: '69'
FB browser: ViewContent, eventID: '79' FB server: ViewContent, eventID: '79'

Embora estes eventos sejam acionados na mesma página e possam usar o mesmo trigger no Google Tag Manager tanto para o contentor web como do servidor, deve ser enviado um event ID único para cada um.

O erro Same Event ID Received for Many Event Instances ocorrerá neste cenário:

FB browser: PageView, eventID: ‘69’ FB server: PageView, eventID: '69'
FB browser: ViewContent, eventID: '69' FB server: ViewContent, eventID: '69'

Neste exemplo, estamos a enviar eventID 69 tanto para eventos PageView como ViewContent. Mas o Facebook espera ver um eventID único para estes dois eventos.

Solução: adicione o Facebook test ID, abra o modo de pré-visualização para os contentores web e do servidor, e teste a configuração. Depois de determinar quando este erro ocorre, podemos tomar medidas adicionais para resolver o problema.

Criámos uma variável personalizada que gera um event ID único e recomendamos usá-la para configurar a deduplicação de eventos do Facebook. Pode adicionar o nome do evento a esta variável para garantir que o event ID seja único. Neste caso, mesmo que os seus eventos usem o mesmo trigger, o event ID permanecerá único, pois consiste em event_name_eventID. Pode ler mais sobre a deduplicação de eventos do Facebook na secção acima.

Mapeamento de Event Name

Por defeito, a tag tenta mapear os eventos padrão do GA para os eventos padrão do Facebook. Se não conseguir correspondê-los, será usado o nome do evento em bruto do cliente GA. Por exemplo, se enviar um nome de evento como este: gtag('event', 'UserLikedProduct'), verá o evento UserLikedProduct no gestor de eventos do Facebook.

Abaixo está o esquema de mapeamento de eventos GA para eventos do Facebook que usamos nesta tag por defeito:

page_viewPageView
add_payment_infoAddPaymentInfo
add_to_cartAddToCart
add_to_wishlistAddToWishlist
sign_upCompleteRegistration
begin_checkoutInitiateCheckout
generate_leadLead
purchasePurchase
searchSearch
view_itemViewContent
contactContact
customize_productCustomizeProduct
donateDonate
find_locationFindLocation
scheduleSchedule
start_trialStartTrial
submit_applicationSubmitApplication
subscribeSubscribe

Para simplificar a migração da sua tag web do Facebook GTM para o contentor do lado do servidor, mapeámos todos os dados recebidos pelo cliente GA para o evento do Facebook sem necessidade de configuração adicional da sua parte. Isto também suporta o mapeamento de eventos GA Enhanced eCommerce, e claro, a tag pode substituir quaisquer parâmetros de evento enviados ao Facebook.

Por exemplo, se a tag detetar que o tipo de evento é Purchase, determinaremos a lista de produtos, a moeda e o valor.

Nas secções seguintes, descreveremos como exatamente os dados são mapeados em cada grupo de parâmetros.

Facebook tag configuration

Apenas alguns parâmetros se enquadram na categoria de Server Event Data. Consulte a documentação do Facebook sobre os parâmetros de evento disponíveis para mais detalhes.

Os parâmetros definidos por defeito incluem:

event_nameEvent Name
event_source_urlPage Location
action_sourceWhere your conversions occurred. (For example: website, email, app)
event_timeCurrent Time

Com a opção de tag "User Data", pode substituir ou adicionar quaisquer dados do utilizador que serão enviados ao Facebook. Consulte a documentação do Facebook sobre parâmetros de dados do utilizador para mais detalhes sobre que dados pode adicionar à chamada. Se a documentação exigir que o parâmetro esteja em hash, deve fazer o hash com SHA256 ou o hit não será enviado ao Facebook.

fbcCookie value ‘_fbc’ or ‘fbclid’ url parameter if exist
fbpCookie value ‘_fbp’
external_idexternal_id or user_id or userId
subscription_idsubscription_id or subscriptionId
lead_idlead_id or leadId
lnlastName or LastName or nameLast
fnfirstName or FirstName or nameFirst
ememail
phphone
gegender
ctcity
ststate
zpzip
countrycountryCode

Também pode substituir quaisquer outros parâmetros ou adicionar os seus próprios usando a secção "Custom Data" na configuração da tag. Consulte a documentação de parâmetros padrão para mais detalhes sobre os parâmetros de dados que pode incluir.

Se o parâmetro Enhanced eCommerce items existir, defina o content_type como product. Os parâmetros de produto GA item_name e item_category mapeiam para content_name e content_category do Facebook, respetivamente.

A tag também tenta determinar outros parâmetros de produto, incluindo: 

valuex-ga-mp1-ev or value
currencycurrency
transaction_idorder_id

Se o tipo de evento for Purchase mas a moeda não puder ser mapeada, USD é usado como valor predefinido, pois o Facebook não aceita eventos Purchase sem o parâmetro de moeda.

Rastreamento do lado do servidor do Facebook: problemas reais de utilizadores Stape resolvidos

1. Um utilizador na Comunidade notou que após mudar para o rastreamento do lado do servidor do Facebook, o seu público de retargeting era muito menor do que o tráfego do GA4 (cerca de 15% de match rate). O problema não era rastreamento defeituoso, mas expectativas irrealistas: o Facebook não consegue corresponder utilizadores de forma fiável usando apenas IP e User Agent. A solução foi seguir a configuração híbrida recomendada pela Meta (navegador + servidor com deduplicação) e enviar todos os dados do utilizador disponíveis (como email ou nome quando possível). Esta abordagem melhora a qualidade de correspondência e o tamanho do público, enquanto o rastreamento puramente do lado do servidor limita o potencial de retargeting.

2. Muitos utilizadores neste tópico enfrentam problemas com o rastreamento do lado do servidor do Facebook e o mapeamento de FBP/FBC, especialmente em checkouts de terceiros. Usar o template do Facebook CAPI do Stape num subdomínio próprio, acionar eventos-chave no domínio principal, implementar eventos híbridos navegador+servidor para deduplicação e, opcionalmente, usar webhooks resolve a maioria dos problemas. Verifique sempre os dados através das ferramentas de rede do navegador em vez de depender exclusivamente do Tag Assistant.

Conclusão

É tudo. Esperamos que tenha migrado com sucesso o rastreamento do Facebook para o lado do servidor. A Facebook Conversions API é uma ferramenta poderosa para compreender os seus clientes, rastrear a sua jornada até à conversão e fornecer mais dados para otimizar os algoritmos de machine learning do Facebook.

Implementar FB CAPI no seu site?

Nós podemos ajudar. Descobre quanto vai custar! Encontre um orçamento em 24 horas. Sim, estamos a falar a sério.

Obter uma citação
author

Ira Holubovska

Author

Ira tem mais de 10 anos de experiência em marketing digital, com 5 anos focados em rastreamento do lado do servidor. Sabe como e quando usá-lo em diferentes cenários de marketing.

Comentários

Experimente o Stape para tudo relacionado ao lado do servidor