Stape

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

Editado
27 de mar de 2022
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.

O que é a API de Conversões do Facebook?Copiar link para esta secção

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 qualquer URL, FB anexa o seu parâmetro adicional fbclid. O código pixel na página de destino armazena o valor deste parâmetro num cookie e depois envia-o juntamente com qualquer evento do Facebook. O Facebook utiliza fbclid para determinar qual foi o tipo de utilizador que acedeu ao seu site e quem o 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 do Facebook?Copiar link para esta secção

A etiquetagem do lado do servidor do Facebook ou API de conversões do Facebook 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 do Facebook.

Estas são as razões mais importantes para considerar a implementação da API de Conversões do Facebook:

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.

Como funcionaCopiar link para esta secção

Vamos utilizar o contentor do servidor de Gestor de etiquetas do Google para configurar a API de Conversões do Facebook. Dentro do contentor do servidor de Gestor de etiquetas do Google, será necessário configurar o rastreamento do lado do servidor para a Universal Analytics e configurar eventos da UA para as acções que se pretende rastrear com a API de conversões do Facebook.

Em resumo, vai precisar destas coisas para configurar a API de conversões do Facebook.

- Contentor web do Gestor de etiquetas do Google configurado

- Contentor do servidor de Gestor de etiquetas do Google configurado

- Código base da Universal Analytics e eventos que estão a funcionar a partir do servidor.

universal analytics stopped working

Neste artigo, não irei abordar como criar e configurar um contentor Web do Gestor de etiquetas do Google. Começarei com a configuração do contentor do servidor de Gestor de etiquetas do Google. Caso queira saber mais sobre o contentor do servidor de Tag Manager e as vantagens que este oferece, consulte este artigo . Então, vamos começar.

👇 Este vídeo mostra como configurar a API de Conversão do Facebook utilizando o Google Analytics 4

Como configurar a API de conversão do FacebookCopiar link para esta secção

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

Se já configurou o GA4 do lado do servidor ou planeia começar a utilizar o GA4, parece que o método GA4 é para si. Mas esta implementação tem os seus contras - o mais significativo é o facto de os pedidos GA4 poderem ser bloqueados por alguns bloqueadores de anúncios. Em contrapartida, o Data Tag e o Data Client resistem a essas restrições. Temos um post que descreve como evitar o bloqueio de pedidos do Google Tag Manager pelo adblocker.

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

Facebook Conversion API tag for server GTM

4. Crie a tag da API de conversão do 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
trigger configuration

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

- Herdar do cliente do GA. Neste caso, iremos fazer corresponder os seus eventos da Universal Analytics ou GA4 a eventos padrão do Facebook. Se não conseguirmos fazer corresponder o evento de GA ao evento padrão de FB, registá-lo-emos como um evento personalizado. Tudo será feito automaticamente, não é necessário configurar eventos de FB.

- Override. Neste caso, terá de configurar manualmente os eventos de FB. Abordaremos como configurar manualmente os eventos do servidor do FB no passo #5.

6. Se seleccionou a opção de override, terá de usar eventos da Universal Analytics (ou GA4) para acionar eventos do servidor do Facebook.  O evento de pageview (visualização de página) do Facebook deve acionar um evento personalizado de page_view. Para configurar outros eventos, vá ao modo de pré-visualização do Contentor do Servidor do Gestor de etiquetas do Google, faça uma acção no seu site que pretende rastrear dentro do Facebook e verifique o nome do evento que a UA (ou GA4) envia para o seu Contentor do Servidor.

Na imagem abaixo, quero configurar um evento do Facebook ViewContent quando alguém abrir a página do produto no meu site. Para tal, criei uma nova etiqueta dentro do contentor do Servidor, configurei-a para override, seleccionei o evento padrão ViewContent, adicionei o Token de Acesso à API, ID do Pixel do Facebook. E fiz um novo nome de evento de acionador igual a view_item.

Facebook conversion API tag example
Facebook conversion API trigger example

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 a opção Melhoria de eventos para utilizar o cookie seguro apenas para HTTP (gtmeec), a fim de melhorar os dados do evento. Quando esta funcionalidade está activada, a tag armazena os dados do utilizador em cookies e enriquece os eventos com dados do utilizador quando estes não estão disponíveis. Desta forma, pode aumentar a qualidade da correspondência de eventos e, como resultado, a atribuição de conversão 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 Gestor de etiquetas do Google e teste se os eventos do Facebook funcionam correctamente. Também pode aceder à sua etiqueta do Facebook dentro do contentor do servidor e adicionar o ID de teste do Facebook. Pode encontrar o ID de teste dentro do gestor de eventos do Facebook sob o separador de eventos de teste. Para mais instruções sobre como testar a API de conversões do Facebook, consulte este artigo.

9. Uma vez configurado e verificado que a API de conversões do Facebook funciona correctamente, é necessário remover o seguimento do navegador FB ou configurar a deduplicação de eventos. Caso contrário, os seus eventos serão duplicados.

Deduplicação de eventos para eventos do pixel do Facebook e API de conversõesCopiar link para esta secção

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 do FB, é 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 do 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.

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.

Enviar parâmetros de utilizador usando a API de conversões do FacebookCopiar link para esta secção

Para comparar os utilizadores que visitam o seu site com a sua base de dados, o Facebook utiliza os Dados de Utilizador para API de Conversões. Eles exigem o envio de pelo menos um dos parâmetros do utilizador dentro dos eventos da API de conversões do Facebook.

A FB exige que alguns parâmetros sejam com hash antes de o enviar para o Facebook. Quanto mais parâmetros de utilizador enviar para o Facebook, maiores serão as probabilidades de corresponderem a um utilizador e maiores serão os resultados de correspondência de eventos.

O envio de parâmetros de utilizador do seu site para o Facebook é um assunto sensível, uma vez que partilhará os dados dos utilizadores com o serviço de terceiros. Portanto, antes de enviar estes dados à FB, certifique-se de que cumprem a política de privacidade.

Se decidir enviar parâmetros de utilizador para a API de conversões do Facebook, então onde os vai obter?  Criamos um Data Tag para o contentor web do Gestor de etiquetas do Google e Data Client para o contentor do servidor para resolver este problema. Estes dois devem trabalhar em conjunto; Data Tag foi criado para enviar dados do contentor web para o contentor do servidor, enquanto Data Client responde a esta tag e obtém a informação. Temos uma descrição mais detalhada do envio de dados da web do Gestor de etiquetas do Google para o contentor do servidor.

A Data Tag irá automaticamente fazer com que os dados dos utilizadores sejam com hash que deverão ser com hash de acordo com os requisitos do Facebook. Se utilizar a nossa etiqueta da API de Conversões do Facebook, Data Tag e Data Client, a etiqueta do Facebook processará automaticamente todos os eventos e parâmetros necessários a partir da Data Tag. Não há necessidade de o enviar manualmente. Basta assegurar-se de que todos os acionadores e variáveis sejam correctamente configurados. Com a ajuda do Data Tag e do Data Client, pode enviar DataLayer do contentor web do Gestor de etiquetas do Google para os dados de eventos dentro do contentor do servidor.

Conclusão:Copiar link para esta secção

É isso mesmo. Espero que tenha movido com sucesso o rastreamento do Facebook para o servidor. A API de Conversões do 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

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

Aloje o seu servidor GTM no Stape