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
- Acesse o Gerenciador de Eventos do Facebook;
- No menu lateral, acesse a opção Fontes de dados (1);
- Caso possua mais de um Pixel cadastrado, selecione o Pixel que será integrado à loja;
- 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;

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

- Copie e guarde o código gerado.
Configurando no painel do e-commerce
- Acesse o admin da sua loja no Ecommerce Olist;
- Vá em Configurações (ícone de engrenagem no canto inferior esquerdo);
- No bloco de integrações, clique na opção Facebook;
- Insira o ID do Pixel e o Token de acesso à API nos respectivos campos;

- 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.