Central de Ajuda Ir para o site da Olist Meus chamados

API de Conversões e Pixel do Facebook: como integrar

De forma resumida, a API cria uma conexão direta entre o seu site e os sistemas do Facebook. Essa tecnologia é fundamental para garantir dados precisos, otimizar os seus anúncios e melhorar a forma como eles são distribuídos para o público.

Assim, quando um usuário do Facebook clica em um de seus anúncios e navega pelo seu site, a API de Conversões coleta esses dados e os compartilha com o seu painel. Ou seja, as ações feitas pelo visitante (como acessos, cliques e compras) são registradas, tornando as suas campanhas de tráfego pago mais inteligentes.

Por que essa configuração é necessária?

Os sistemas operacionais mais recentes disponibilizam para os usuários a opção de não permitir que aplicativos rastreiem suas atividades por meio de cookies de navegadores. Isso afeta diretamente a coleta tradicional de dados do Pixel do Facebook, prejudicando a performance dos seus anúncios e a precisão dos relatórios.

Com a API de Conversões instalada, o sistema consegue coletar esses dados de navegação de servidor para servidor, sem depender exclusivamente dos cookies. Isso ajuda a contornar esses bloqueios e garante a exatidão das métricas.

Dessa forma, a API de Conversões trabalha em conjunto com o Pixel do Facebook para aprimorar o desempenho e a mensuração das suas campanhas. Você pode conferir mais detalhes técnicos diretamente na documentação oficial do Facebook.

Como integrar a API de Conversões

Caso você tenha dificuldades para localizar as telas indicadas neste artigo, recomendamos alterar a visualização do seu painel do Meta Business Suite para o Gerenciador de Negócios tradicional.

Para realizar a integração, você vai precisar de duas informações:

  • ID do Pixel que será utilizado;
  • Token de acesso à API do Pixel.

Coletando os dados no Facebook

  1. Acesse o Gerenciador de Eventos do Facebook;
  2. No menu lateral, acesse a opção Fontes de dados (1);
  3. Caso possua mais de um Pixel cadastrado, selecione o Pixel que será integrado à loja;
  4. Na aba Configurações, clique sobre o número informado em Identificação (2) para copiar o ID do Pixel e guarde essa informação;

  1. Ainda na aba Configurações, role a página até a seção API de Conversões;
  2. Clique no link Gerar token de acesso;

  1. Copie e guarde o código gerado.
 
 

Configurando no painel do e-commerce

  1. Acesse o admin da sua loja no Ecommerce Olist;
  2. Vá em Configurações (ícone de engrenagem no canto inferior esquerdo);
  3. No bloco de integrações, clique na opção Facebook;
  4. Insira o ID do Pixel e o Token de acesso à API nos respectivos campos;

  1. Clique no botão Enviar.

Pronto. A integração com a API de Conversões do Facebook está ativa e configurada no seu site.

 
 

Quais eventos são disparados?

Confira abaixo a lista de eventos automáticos que a integração do Ecommerce Olist envia para o Facebook:

  • Page view: disparado em todas as páginas do site;
  • View content: disparado especificamente nas páginas de produto;
  • Add to cart: disparado no momento em que o cliente clica no botão comprar na página de produto;
  • Iniciate Checkout: disparado quando o cliente avança para a página de finalização de compra;
  • Add payment info: disparado quando o cliente clica para escolher a forma de pagamento no checkout;
  • Purchase: disparado no momento do clique no botão finalizar pedido;
  • Pix (PurchasePix): disparado especificamente ao finalizar o pedido escolhendo a opção Pix;
  • Boleto (PurchaseSlip): disparado especificamente ao finalizar o pedido escolhendo a opção Boleto;
  • OrderPaid: envia um evento de conversão personalizado quando um pedido tem o pagamento confirmado pelo sistema. Esse evento trabalha em conjunto com os anteriores, permitindo metrificar quantos pedidos finalizados em boleto ou Pix foram realmente pagos ou cancelados.

Como validar o funcionamento do Pixel?

A validação correta deve ser feita consultando diretamente o seu Gerenciador de Eventos no painel do Facebook, verificando se os eventos recentes estão constando no histórico de recebimento de servidor.

Atenção: extensões de navegador como o Facebook Pixel Helper, que realizam a leitura de eventos disparados diretamente pelo navegador do usuário, não vão contabilizar os eventos da nossa integração. Isso ocorre porque o Ecommerce Olist envia os dados diretamente pelo servidor via API, garantindo maior segurança e precisão, sem depender das ações ou dos bloqueadores do navegador do cliente.

 

Este artigo foi útil para você?