Contacto de vendasExperimente grátis

Como configurar a API de Conversões do Facebook + Deduplicação de Eventos e Hash User Data

Ira Holubovska

Ira Holubovska

Autor
Atualizado
21 de ago de 2025
Publicado
11 de fev de 2021
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.

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

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 eventos do pixel do Facebook e API de Conversões

O Facebook recomenda a utilização tanto do pixel do Facebook como da API de Conversões. Mas se o seu site enviar os mesmos eventos utilizando tanto o pixel como a API de Conversões, os eventos podem ser duplicados uma vez que a FB receberá a mesma informação do navegador e do servidor.

O Facebook tem uma funcionalidade de deduplicação. Se souberem que os eventos do navegador e do servidor são idênticos, podem manter apenas um.

Eu diria que a configuração da desduplicação de eventos é obrigatória se quiser enviar todos os eventos tanto do servidor como do navegador. Sem a deduplicação de eventos, os seus dados não serão exactos, e podem afectar as suas campanhas no Facebook.

Para configurar a deduplicação da API de Conversões Facebook, é necessário enviar IDs de eventos únicos a partir do navegador e do servidor. Os mesmos eventos tanto do navegador como do servidor devem ter o mesmo ID de evento.

Criámos uma variável personalizada que gera uma ID única para cada evento. Pode adicioná-la ao seu contentor web utilizando este link para a galeria de modelos . Use esta variável para enviar o ID do evento para o pixel do Facebook dentro do contentor da web e para API de Conversões Facebook usando o contentor do servidor. Temos uma descrição mais detalhada de como configurar a deduplicação de eventos do Facebook.

É possível passar um ID de evento único do contentor web para o contentor do servidor usando a dimensão personalizada do Google Analytics ou Data Tag e Data Client.

Certifique-se de que as tags de evento da Web do Facebook e as tags do GA4 (ou tag de dados) estejam sendo executadas nos mesmos acionadores; caso contrário, elas terão IDs de evento diferentes.

Se a desduplicação estiver correctamente configurada, deverá vê-la dentro da ferramenta de teste do gestor de eventos. E depois de publicar todas as alterações à produção, pode clicar nos detalhes do evento para ver o número de eventos que o Facebook recebeu do navegador e do servidor. Quantos eventos processaram e desduplicaram.

Às vezes, há problemas com os eventos de teste do Facebook, o que faz com que a deduplicação não seja exibida na interface. Nesse caso, verifique se o ID do evento nos eventos é o mesmo; se for o caso, a deduplicação funcionará sem problemas.

Enable Event Enhancement in Facebook CAPI tag
Enable Event Enhancement in Facebook CAPI tag
Enable Event Enhancement in Facebook CAPI tag
Enable Event Enhancement in Facebook CAPI tag

Enviar parâmetros de utilizador usando a API de Conversões do Facebook

Para combinar os usuários que visitam seu site com o banco de dados deles, o Facebook usa a API User Data for Conversion.

O FB exige o hash de alguns parâmetros antes de enviá-los ao Facebook, mas você não precisa se preocupar com isso, pois a tag do Facebook fará o hash de todos os dados automaticamente antes de enviá-los.

Quanto mais parâmetros de usuário você enviar para o Facebook, maiores serão as chances de ele corresponder a um usuário e maior será a pontuação de correspondência de eventos que você obterá.

O envio de parâmetros de usuário do seu site para o Facebook é um assunto delicado, pois você compartilhará os dados dos usuários com serviços de terceiros. Portanto, antes de enviar esses dados ao FB, certifique-se de que eles estejam em conformidade com a política de privacidade.

O ideal é que os dados do usuário sejam adicionados à camada de dados, mas, se isso não for possível, tente coletá-los da página usando um código javascript personalizado e envie-os junto com as conversões ou eventos nos quais você está interessado.

Por exemplo, todos os plugins Stape para CMS (para Facebook CAPI para Shopify, WordPress, Magento, BigCommerce) adicionam uma camada de dados que também contém dados do usuário.

Portanto, você pode facilmente retirá-los da camada de dados e adicionar esses dados aos eventos do Facebook em um contêiner da Web:

Enable Event Enhancement in Facebook CAPI tag
Enable Event Enhancement in Facebook CAPI tag

Em seguida, adicione a transferência dos dados necessários ao contêiner do servidor (no payload GA4 ou na tag Data, dependendo do que você usar):

Enable Event Enhancement in Facebook CAPI tag
Enable Event Enhancement in Facebook CAPI tag

E, por fim, adicione esses dados ao evento do Facebook no lado do servidor:

Enable Event Enhancement in Facebook CAPI tag
Enable Event Enhancement in Facebook CAPI tag

Dessa forma, você obterá uma melhor qualidade de correspondência dos seus eventos do Facebook e, como resultado, poderá melhorar o desempenho das suas campanhas publicitárias, pois o Facebook entenderá melhor o seu público-alvo e otimizará melhor as suas campanhas publicitárias.

Conclusão

É isso mesmo. Espero que tenha movido com sucesso o rastreamento do Facebook para o servidor. A API de Conversões Facebook é uma excelente ferramenta para compreender melhor quem é o seu cliente, ver a viagem completa do cliente até que a conversão ocorra, e passar mais dados sobre os seus utilizadores para os algoritmos de aprendizagem automática do Facebook

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

O que está acontecendo?

Para onde vamos?

Atenção!
Esta é uma zona de cães em pé.