Stape

Erros da API de conversões do Facebook e como corrigi-los

Atualizado
24 de out de 2022
Publicado
7 de set de 2021
Também disponível

A configuração da API de conversões do Facebook pode ser confusa. Mas depois de ter feito o tremendo trabalho de mover o rastreamento do FB para o servidor e esperar que tudo esteja bem, poderá entrar no seu gestor de eventos no dia seguinte e ver avisos vermelhos e amarelos para os eventos enviados a partir do servidor.

Já enfrentei este problema muitas vezes ao configurar o FB CAPI para clientes. Por isso, decidi criar um artigo com algumas dicas úteis. Neste post do blog, descreverei os erros e avisos mais populares da API de conversões do Facebook. Além disso, partilharei algumas dicas sobre como corrigi-los.

Como verificar se há alguns erros no Facebook pixel ou na API de ConversõesCopiar link para esta secção

A Ferramenta de Teste de Eventos do Facebook é uma nova e poderosa ferramenta que lhe permite depurar e resolver problemas com os seus pixéis de FB ou eventos do servidor. Se houver erros, eles serão apresentados no separador Diagnostics na barra de ferramentas, para que os possa rever mais de perto.

Os erros marcados a vermelho requerem geralmente uma reacção rápida e devem ser corrigidos de imediato. Os erros amarelos são avisos não críticos aos quais se deve prestar atenção e, eventualmente, examinar.

O Facebook permite marcar os problemas como resolvidos ou ignorá-los. Se marcar um erro como resolvido e este erro se repetir, o Facebook mostrá-lo-á novamente dentro de 3 dias. Em comparação, os problemas ignorados vão para a secção Ignored e ficam lá.

Quando resolver quaisquer problemas com o seu rastreamento de FB, sugiro que os marque como resolvidos. Desta forma, notificará o Facebook de que os problemas foram resolvidos, e obterá uma notificação da plataforma se estes problemas se repetirem.

Quais são os erros mais comuns de pixel do Facebook e de API de conversões, e como corrigi-los?Copiar link para esta secção

1. Novos domínios que enviam dadosCopiar link para esta secção

new domains sending data 

Pode ver todos os domínios que estão a enviar dados para o seu pixel do Facebook. Se a FB detectar tráfego de um novo subdomínio, a plataforma irá enviar-lhe este aviso. Pode colocar os domínios numa lista branca ou numa lista negra. Com a ajuda desta funcionalidade, pode bloquear o tráfego dos seus sites de teste ou URLs técnicos.

Muito provavelmente, verá também o tráfego do gtm-msr.appspot.com. Pode acontecer quando executa uma depuração/publique um contentor ou os utilizadores acedem ao seu site com js desactivados (alguns bots).

Para criar as listas de domínios, abra a ferramenta de eventos no Business Manager (Gestor de Negócios) -> Clique em settings (definições) -> Navegue até às Traffic Permissions (Permissões de Tráfego).

create allow block list in Facebook

2. Evento sem alguns parâmetros de remoção de duplicadosCopiar link para esta secção

event missing some deduplication parameters

Este é o segundo erro mais comum no CAPI do Facebook, segundo a minha experiência. Este erro significa que não está a enviar algumas chaves de remoção de duplicados para os seus eventos do servidor. O Facebook precisa destes parâmetros para a remoção de duplicados de eventos: event name e event ID.

event deduplication parameters

As hipóteses são de que já esteja a enviar os nomes dos eventos. Suponha que vê este problema porque o ID do evento é inválido. Verifique se está a enviar um ID de evento para pixel do Facebook e API de conversões do Facebook. Este ID de evento deve ser o mesmo para o evento do navegador e do servidor. Neste caso, o FB verá o mesmo nome de evento e ID de evento e iniciará a remoção de duplicados.

Por exemplo, para os eventos de PageView (visualização da página), envie o mesmo ID de evento e nome de evento a partir do pixel do Facebook e FB CAPI.

Para testar o ID do evento, abra a ferramenta de teste de eventos do Facebook. Se tudo estiver correcto, deverá ver algo semelhante à imagem do ecrã. É assim que a FB mostra que registou eventos de PageView tanto do navegador como do servidor. Estes eventos tinham o mesmo ID de evento. Por isso, processaram eventos do navegador e removeram duplicados dos eventos do servidor.

event deduplication Facebook testing tool

Mas pode haver outra situação em que os eventos do navegador e do servidor sejam accionados de forma aleatória. Neste caso, verifique o ID do evento do FB. Muito provavelmente, os ID de eventos não são idênticos. Por falar nisso, pode usar a nossa variável personalizada para o contentor web para configurar o ID de evento do Facebook.

create facebook test ID google tag manager

3. O servidor está a enviar parâmetros-chave de correspondência inválida para o evento de PageViewCopiar link para esta secção

server sending invalid match key

Aqui, o Facebook quer notificá-lo que os valores que está a enviar do servidor não são únicos ou formatados correctamente. Por exemplo, pode enviar IP do utilizador que inclua símbolos e não apenas números. Ou talvez tenha simplesmente seleccionado a variável errada como o envio de um número de telefone no campo de e-mail.

Para verificar o que está errado, abra o modo de pré-visualização dos contentores web e do servidor do Gestor de Etiquetas do Google (claro, se utilizou GTM para configurar a API de conversões do Facebook). Deverá ver quais os parâmetros do utilizador que foram enviados para o Facebook e se foram formatados correctamente. Teste o evento, clique na etiqueta no modo de depuração, e seleccione os valores.

send user data to Facebook

Este erro pode também significar que possa ter-se esquecido de incluir um parâmetro ou que este esteja formatado incorrectamente.

Por exemplo, eu tinha um cliente que queria enviar o país e a cidade do utilizador com base no endereço de IP. O Facebook espera ver os detalhes reais do endereço dos utilizadores que eles introduzem no site e não os que obteve automaticamente do IP. Esta configuração também enviou um erro sobre parâmetros-chave inválidos.

Ou talvez tenha tentado trapacear e enviar o mesmo nome de utilizador para todos os eventos a fim de aumentar a qualidade.

4. Dados pessoais potencialmente violadores enviados para o FacebookCopiar link para esta secção

potential violating personal data sent to Facebook

Este erro está normalmente relacionado com os eventos do navegador e significa que o Facebook detectou dados do utilizador no URL. Alguns CMS e outras ferramentas como Calendly ou PayPal enviam os dados do utilizador no URL depois de se registarem ou de efectuarem uma compra.

Este erro é difícil de corrigir, e isso é uma tarefa para os seus programadores. Eles devem melhorar os parâmetros de query do URL (URL query parameters) e remover toda a informação do utilizador do URL.

5. Aumentar a qualidade de correspondência de eventosCopiar link para esta secção

event match quality Facebook

Para cada evento do servidor que enviar para a FB, haverá a classificação de qualidade de correspondência de eventos. Esta classificação depende da quantidade de dados de utilizador que enviar para a FB.

Se utilizar um subdomínio personalizado para o seu servidor de etiquetagem, apenas IP de utilizador, ID do navegador, _fbp, e _fbc são enviados para FB CAPI. Se enviar apenas estes parâmetros de utilizador, a qualidade da correspondência será de cerca de 4 dos 10.

É muito importante enviar o máximo de parâmetros possível. A FB utiliza estes dados para fazer corresponder os utilizadores no seu site aos da sua base de dados. Tente enviar todos os parâmetros de utilizador que tiver. Naturalmente, deve verificar primeiro as regras de política de privacidade indicadas no seu site. Mas tecnicamente, é bom enviar mais parâmetros. Isso significa que os dados do público e de conversão serão mais precisos, os algoritmos do Facebook terão dados mais específicos sobre os seus utilizadores, e as campanhas terão um melhor desempenho.

Como se pode aumentar a classificação de qualidade de correspondência de eventos? A resposta é simples: precisa de enviar mais dados de utilizador. Mas a implementação continua a ser um processo complexo. É assim que funciona: começo por verificar se a camada de dados é implementada no seu site e se tem todos os dados de utilizador. Por exemplo, se o utilizador pode iniciar sessão no seu site, precisa de verificar se os dados do utilizador são enviados para a camada de dados quando os utilizadores iniciam sessão.

Se a camada de dados não for implementada, então atribua uma tarefa de configuração dela aos seus programadores. 

Depois disso, certifique-se de que passa todos os parâmetros do utilizador desde a web até ao contentor do servidor.

Outra coisa que o ajudará a aumentar a qualidade de correspondência é uma nova funcionalidade da Data Tag. Adicionamos a capacidade de armazenar dados do utilizador. Por exemplo, se o utilizador submeteu um formulário de contacto no site, pode utilizar a Data tag para armazenar dados do utilizador no armazenamento local e depois utilizá-los em outras páginas.  Pode ler mais sobre esta funcionalidade aqui.

6. Mesmo ID de evento recebido para muitas ocasiões de eventosCopiar link para esta secção

Se estiver a rastrear eventos do Facebook tanto a partir do browser como do servidor, então o Facebook requer que envie um ID de evento único para cada evento. Para os eventos correspondentes, o nome do evento do pixel do Facebook deve ser exacto ao nome dos eventos do servidor. O mesmo para o ID do evento, os mesmos eventos do pixel do FB devem corresponder aos eventos do servidor do FB. É neste caso que a remoção de duplicados acontece.

Este erro acontece quando se envia o mesmo ID de evento para muitos eventos. Por exemplo, um utilizador acedeu à página do produto. Isto significa que dois eventos devem ser accionados nesta página: PageView e ViewContent. Deve enviar um ID de evento único para cada um dos eventos. Isto significa que os eventos do FB e IDs dos eventos devem ter este aspecto:

FB browser: PageView, eventID: ‘69’

FB server: PageView, eventID: '69'

FB browser: ViewContent, eventID: '79'

FB server: ViewContent, eventID: '79'

Embora estes eventos sejam accionados na mesma página e possam usar o mesmo accionador no contentor da web e do servidor do Gestor de Etiquetas do Google, deverá enviar um ID de evento único para ambos.

O mesmo ID de evento recebido para muitas ocasiões de eventos ocorrerá se tiver esta situação:

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 o eventID 69 tanto para eventos de PageView como os de ViewContent. Mas o Facebook espera ver um eventID único para estes dois eventos.

Solução: adicione o ID de teste do Facebook, abra o modo de pré-visualização dos contentores da web e do servidor, e teste a configuração. Depois de descobrir quando este erro acontece, podemos fazer mais para resolver o problema.

Criámos uma variável personalizada que gera um ID de evento único. Sugiro que utilize esta variável para configurar a remoção de duplicados de eventos do FB. Pode adicionar um nome de evento a esta variável para garantir que o eventID seja único, tal como se vê na imagem abaixo. Neste caso, mesmo que os seus eventos usem o mesmo accionador, o eventID será único uma vez que consiste em event_name_eventID. Pode ler mais sobre a remoção duplicados de eventos do Facebook neste artigo.

ConclusãoCopiar link para esta secção

Configurar a API de conversões do Facebook pode parecer complicado e, por vezes, confuso. Mas vale a pena o tempo e o esforço. Depois de ter feito todo esse trabalho árduo de mover o rastreamento do FB para o servidor, a qualidade do rastreamento e público irá melhorar.

No entanto, poderá enfrentar alguns problemas se houver erros dentro deste novo processo de integração. Simplificando, poderá ver avisos vermelhos e amarelos no gestor de eventos.

A boa notícia é que a maioria destes problemas não são tão complicados como poderiam parecer e não são caros de resolver. Espero que este artigo o ajude a lidar com os erros e avisos mais comuns da API de conversões do Facebook.

Tem problemas com API?

Podemos ajudá-lo! Clique em Necessidade de assistência, preencha o formulário, e enviar-lhe-emos um orçamento.

Necessidade de assistência
Tagged with:Facebookgtm server

Aloje o seu servidor GTM no Stape