Pular para o conteúdo
Tráfego pago

Como configurar o Pixel e a API de Conversões da Meta

Aprenda a configurar o Pixel da Meta e a API de Conversões no seu site, com passo a passo, diferenças, eventos recomendados e como evitar erros.

Lucas Feix8 min de leitura

Pessoa configurando o Pixel da Meta em um computador
Foto de Ivan S no Pexels

Se você quer saber como configurar o Pixel da Meta e a API de Conversões no seu site, este guia é para você. Mostro o passo a passo para qualquer tipo de site, desde HTML puro até plataformas como Shopify e WordPress.

O que é o Pixel da Meta e o que ele rastreia?

O Pixel funciona no navegador do usuário: quando alguém visita seu site, o código dispara e envia informações para a Meta. Isso permite criar públicos personalizados, otimizar campanhas para conversões e medir o retorno dos seus anúncios. Os eventos mais comuns são PageView (visualização de página), AddToCart (adicionar ao carrinho) e Purchase (compra).

O Pixel é fundamental para quem anuncia com tráfego pago, porque ele alimenta o algoritmo com dados de quem realmente converte. Sem ele, suas campanhas ficam cegas e você não sabe qual anúncio trouxe resultado.

O que é a API de Conversões e qual a diferença para o Pixel?

A diferença principal está no caminho dos dados: o Pixel envia do navegador, a API envia do servidor. Isso significa que, mesmo que o navegador bloqueie o Pixel ou o usuário use extensões de bloqueio, a API ainda pode enviar os dados. A Meta recomenda usar os dois juntos, com deduplicação de eventos, para obter a melhor precisão.

CaracterísticaPixelAPI de Conversões
Origem dos dadosNavegadorServidor
Resistência a bloqueadoresBaixaAlta
Privacidade do usuárioPode ser afetadaMenos afetada
ConfiguraçãoMais simplesRequer token e integração
PrecisãoBoa, mas pode perder eventosMelhor, especialmente com deduplicação
Comparação entre Pixel e API de Conversões

A API de Conversões é essencial se você vende online e depende de dados precisos para otimizar campanhas. Ela também é crucial com a crescente restrição a cookies e o foco em privacidade dos navegadores. Se o seu site tem tráfego significativo, implementar a API evita que você fique cego. Antes de aumentar a verba, vale entender quanto investir em Google Ads ou Meta Ads.

Como criar o Pixel da Meta no Gerenciador de Eventos?

  1. Acesse o Gerenciador de Eventos

    Entre no Gerenciador de Eventos da Meta (https://business.facebook.com/events) com a conta do negócio que é dona dos anúncios.

  2. Abra Conjuntos de dados

    No menu à esquerda, clique em Conjuntos de dados. É onde a Meta guarda hoje o que antes se chamava só de pixel: o pixel foi convertido em conjunto de dados, com o mesmo número.

  3. Crie o conjunto de dados do site

    Crie um conjunto de dados para o site, com um nome fácil de reconhecer (ex.: 'Site da minha empresa').

  4. Copie o ID

    Anote o ID do conjunto de dados. Ele é o mesmo número do pixel e vai no código-base e na API de Conversões.

O Gerenciador de Eventos também oferece configuração rápida para plataformas como Shopify, mas aqui seguimos o caminho que vale para qualquer site. Os rótulos dos botões mudam de tempos em tempos; o que não muda é que tudo parte de Conjuntos de dados.

Como configurar a API de Conversões no Gerenciador de Eventos?

  1. Abra o conjunto de dados

    No Gerenciador de Eventos, clique em Conjuntos de dados e selecione o do seu site.

  2. Vá em Gerenciar integrações

    Se a API de Conversões ainda não estiver configurada, selecione API de Conversões e clique em Configurar. Se já estiver, clique em Gerenciar integrações.

  3. Escolha a forma de integração

    Integração de parceiro (Shopify, WooCommerce, GTM do lado do servidor, entre outros), Conversions API Gateway ou integração direta com código.

  4. Na integração direta, gere o token

    O token de acesso fica vinculado ao conjunto de dados. Guarde-o fora do código público do site.

  5. Teste antes de anunciar

    Use a ferramenta Eventos de teste para confirmar que os eventos do servidor estão chegando.

A API de Conversões pode ser configurada por integração de parceiro (Shopify, WooCommerce, Google Tag Manager do lado do servidor, entre outros), pelo Conversions API Gateway ou por integração direta com código, como mostra a central de ajuda da Meta sobre a API de Conversões. Para sites sob medida, a integração direta envia os eventos do seu servidor para a Meta.

Como instalar o Pixel e a API de Conversões no seu site?

Instalação manual

  1. No Gerenciador de Eventos, abra o conjunto de dados do site, escolha a instalação manual do código e copie o código-base do pixel.
  2. Cole o código dentro da tag <head> de todas as páginas do seu site. Se usa WordPress, adicione via plugin ou no arquivo header.php.
  3. Acesse seu site, abra o console do navegador (F12) e veja se o código do Pixel carrega sem erros.

Instalação via Google Tag Manager

No GTM web, crie uma tag do tipo HTML personalizado com o código-base do pixel e o gatilho de todas as páginas, como a Meta ensina na central de ajuda. A API de Conversões não roda no contêiner web: ela precisa de um contêiner de servidor do GTM com a tag da API de Conversões da Meta, ou da integração Google Tag Manager do Gerenciador de Eventos, que cria esse servidor no Google ou na Stape.

Integração com plataformas

Shopify e WooCommerce têm integração de parceiro com a Meta que conecta o pixel e a API de Conversões: basta autorizar a conta e escolher os eventos. Em WordPress sem loja e em outras plataformas, confira se o plugin envia eventos pelo servidor ou só instala o pixel no navegador. Só o primeiro caso é API de Conversões.

Quais eventos configurar para medir vendas e leads?

EventoQuando dispararParâmetros recomendados
PageViewToda visitaNenhum
ViewContentVisualização de produto ou páginacontent_name, content_ids
AddToCartAdicionar ao carrinhocontent_name, value, currency
LeadPreenchimento de formuláriovalue, currency
PurchaseCompra concluídavalue, currency
Eventos padrão da Meta e parâmetros úteis

Mapeie os eventos para o funil do seu negócio: ViewContent indica interesse, AddToCart mostra intenção de compra, Lead captura contatos e Purchase mede vendas. Sempre envie o valor e a moeda para dar mais dados ao algoritmo.

Como verificar se o Pixel e a API de Conversões estão funcionando?

Se os eventos não aparecem, verifique se o código está no cabeçalho, se não há erros de JavaScript e se o token da API está válido. Bloqueadores de anúncio podem impedir o Pixel, mas a API deve funcionar mesmo assim.

Erros comuns na configuração e como evitar

Bloqueadores de anúncio. Muitos usuários usam bloqueadores que impedem o Pixel. Com a API de Conversões, você contorna isso, mas precisa garantir que o servidor esteja configurado corretamente.

Token expirado ou inválido. O token de acesso pode expirar. Verifique periodicamente no Gerenciador de Eventos e gere um novo se necessário.

Dados incompletos. Se você não envia parâmetros como valor e moeda, o algoritmo de otimização fica limitado. Sempre inclua esses dados nos eventos de conversão.

Como a Quilha trabalha nisso

Na Quilha, a configuração do Pixel e da API de Conversões faz parte do nosso serviço de tráfego pago. Nós cuidamos da instalação, da configuração dos eventos e da verificação para que suas campanhas tenham dados confiáveis desde o início.

Se o seu site ainda não está pronto para receber o Pixel, ou se você precisa de ajustes, nossa equipe de sites e landing pages pode ajudar. Trabalhamos com um método que começa com uma conversa sobre seu negócio; se fizer sentido, segue com um estudo do seu caso, e depois vêm a implementação e o acompanhamento.

Você fala com a gente pelo formulário ou WhatsApp, de segunda a sexta, das 9h às 18h. Nos primeiros 3 meses, construímos a estrutura; depois, o acompanhamento segue com relatórios de leads recebidos, respondidos, propostas e vendas.

Perguntas frequentes

O que é o Pixel da Meta?

O Pixel da Meta é um código que você instala no seu site para rastrear as ações dos visitantes, como visualizações de página, adições ao carrinho e compras. Ele envia esses dados para a Meta, que os usa para otimizar seus anúncios e medir resultados.

O que é a API de Conversões da Meta?

A API de Conversões é uma ferramenta que envia eventos diretamente do seu servidor para a Meta, sem depender do navegador do usuário. Isso aumenta a precisão dos dados, especialmente quando o navegador bloqueia cookies ou o usuário tem extensões de bloqueio.

Qual a diferença entre Pixel e API de Conversões?

O Pixel rastreia eventos no navegador do usuário, enquanto a API de Conversões envia eventos do servidor. O Pixel pode perder dados por bloqueadores ou privacidade; a API é mais confiável. Usar os dois juntos, com deduplicação, melhora a precisão.

Preciso usar os dois ou posso escolher um?

O ideal é usar os dois. O Pixel captura eventos em tempo real no navegador, e a API garante que os dados cheguem mesmo com bloqueios. A Meta recomenda usar ambos e configurar a deduplicação para evitar contagens duplicadas.

Como configurar o Pixel da Meta no site?

Crie o Pixel no Gerenciador de Eventos, copie o código-base e instale no cabeçalho do site. Você pode fazer manualmente, via Google Tag Manager ou com plugins de plataformas como Shopify e WordPress.

Como configurar a API de Conversões no Gerenciador de Eventos?

No Gerenciador de Eventos, clique em Conjuntos de dados, selecione o do seu site e clique em Gerenciar integrações. Se a API ainda não estiver configurada, selecione API de Conversões e clique em Configurar. Escolha entre integração de parceiro, Conversions API Gateway ou integração direta; na integração direta, você gera um token de acesso.

Como verificar se o Pixel da Meta está funcionando?

Use a ferramenta Eventos de teste, no Gerenciador de Eventos, ou a extensão Consultor de Dados de Anúncios da Meta, antigo Auxiliar do Pixel. As duas mostram quais eventos disparam e se estão chegando.

A API de Conversões funciona com Shopify ou Loja Integrada?

Shopify e WooCommerce aparecem entre as integrações de parceiro da Meta para a API de Conversões: basta conectar a conta e escolher os eventos. Em outras plataformas, como a Loja Integrada, confira na central de ajuda da própria loja se a integração envia eventos pelo servidor ou só instala o Pixel.

Continue por aqui

Outros artigos da mesma trilha.

Dona de loja analisando o painel do Google Ads no notebook para conferir a força dos dados da campanha

Tráfego pago

Força dos dados no Google Ads: o que mudou para leads

A força dos dados decide quanto a sua campanha de leads custa e converte, e o Google acabou de explicar como melhorar. Veja o que mudou e como aplicar na sua conta.

  • Google Ads
  • Custo por lead

7 min de leitura

Empreendedor analisando o painel de campanhas de Google Ads e Meta Ads no notebook

Tráfego pago

Quanto investir em Google Ads ou Meta Ads: calcule a verba

Decidir quanto investir em Google Ads ou Meta Ads começa por uma conta: quanto cada lead pode custar antes de dar prejuízo. Veja como calcular a verba a partir daí e escolher a plataforma.

  • Google Ads
  • Meta Ads
  • Custo por lead

8 min de leitura

Empresário verifica no computador se o site da empresa aparece nas respostas do ChatGPT

Sites e conversão

Como saber se meu site aparece no ChatGPT

Um teste de dois minutos mostra se o ChatGPT usa o seu site como fonte, e dá para fazer agora, sem cadastro. Veja o passo a passo, o que impede a sua página de aparecer e como monitorar sua presença em IA.

  • SEO

8 min de leitura