Pular para conteúdo principal
TécnicoAvançado 12 min de leitura

Pixel da Meta e API de Conversões: guia de implementação

Tudo sobre instalação do Pixel, eventos padrão, eventos customizados e a API de Conversões (CAPI).

PixelCAPITécnicoConversões

Introdução

O Pixel da Meta e a API de Conversões (CAPI) são a infraestrutura invisível que torna o tráfego pago inteligente. Sem eles, o algoritmo da Meta não sabe quem converteu, não consegue otimizar a entrega e você fica no escuro sobre o retorno real das suas campanhas.

Este guia técnico cobre desde a instalação básica do Pixel até a configuração avançada da API de Conversões, incluindo as adaptações necessárias após as mudanças de privacidade do iOS 14+.

O que é o Pixel da Meta?

O Pixel é um trecho de código JavaScript que você instala no seu site. Ele rastreia as ações dos visitantes (visualizar página, adicionar ao carrinho, comprar) e envia esses dados para a Meta, permitindo:

- Otimização de campanhas para conversões específicas

- Criação de Custom Audiences baseados em comportamento

- Medição precisa de ROAS e CPA

- Atribuição de conversões a anúncios específicos

Instalação do Pixel

Existem três formas de instalar o Pixel:

MétodoComplexidadeRecomendado para
Integração nativa (Shopify, WooCommerce)BaixaPlataformas com plugin oficial
Google Tag ManagerMédiaSites com GTM já configurado
Código manualAltaSites customizados

Para a maioria dos e-commerces brasileiros que usam Shopify, Nuvemshop ou WooCommerce, a integração nativa é a forma mais rápida e confiável.

Eventos padrão do Pixel

A Meta define eventos padrão que o algoritmo reconhece e usa para otimização:

EventoQuando dispararImportância
PageViewToda página carregadaBase (automático)
ViewContentPágina de produto visualizadaAlta
AddToCartProduto adicionado ao carrinhoMuito alta
InitiateCheckoutInício do checkoutAlta
AddPaymentInfoInformação de pagamento adicionadaMédia
PurchaseCompra concluídaCrítica
LeadFormulário preenchidoAlta (para geração de leads)
CompleteRegistrationCadastro concluídoMédia

Parâmetros obrigatórios

O evento Purchase deve incluir obrigatoriamente: value (valor da compra), currency (BRL) e content_ids (IDs dos produtos). Sem esses parâmetros, o algoritmo não consegue calcular ROAS nem otimizar para valor de compra.

Exemplo de disparo correto:

fbq('track', 'Purchase', {
  value: 297.00,
  currency: 'BRL',
  content_ids: ['PROD-001', 'PROD-002'],
  content_type: 'product',
  num_items: 2
});

Eventos customizados

Além dos eventos padrão, você pode criar eventos customizados para rastrear ações específicas do seu negócio:

- Visualização de vídeo de vendas (assistiu 50%+)

- Clique no botão de WhatsApp

- Download de material rico

- Agendamento de consulta

- Scroll até o final da página de vendas

Eventos customizados são úteis para criar públicos de retargeting mais qualificados e para otimizar campanhas para micro-conversões.

API de Conversões (CAPI)

A API de Conversões envia dados de conversão diretamente do seu servidor para a Meta, sem depender do navegador do usuário. Isso é crucial por dois motivos:

Bloqueadores de anúncios: Cerca de 30% dos usuários brasileiros usam algum tipo de bloqueador que impede o Pixel de funcionar. A CAPI contorna esse problema.

iOS 14+ (ATT): Desde 2021, o iOS pede permissão explícita para rastreamento. Cerca de 75% dos usuários de iPhone negam. A CAPI recupera parte desses dados perdidos.

Implementação da CAPI

A implementação recomendada é o modelo redundante: tanto o Pixel (browser) quanto a CAPI (servidor) enviam os mesmos eventos. A Meta faz a deduplicação automaticamente usando o event_id.

ComponenteResponsabilidadeOnde roda
Pixel (browser-side)Captura eventos em tempo realNavegador do usuário
CAPI (server-side)Envia eventos do servidorSeu servidor/backend
DeduplicaçãoRemove eventos duplicadosServidores da Meta

Deduplicação

Para que a deduplicação funcione, cada evento deve ter um event_id único e idêntico tanto no Pixel quanto na CAPI. Se os IDs não coincidirem, a Meta contará o evento duas vezes, inflando suas métricas.

Configuração pós-iOS 14+

Após as mudanças de privacidade do iOS 14, algumas configurações adicionais são necessárias:

Verificação de domínio: Verifique seu domínio no Business Manager para poder configurar eventos priorizados.

Aggregated Event Measurement (AEM): Configure até 8 eventos priorizados por domínio. Ordene por importância (Purchase > AddToCart > ViewContent).

Janela de atribuição: A janela padrão mudou para 7 dias de clique e 1 dia de visualização. Considere isso ao analisar ROAS.

Diagnóstico de problemas

Eventos não estão sendo registrados

Verifique: Pixel instalado corretamente (use a extensão Meta Pixel Helper), eventos disparando no momento certo (não antes da ação), parâmetros obrigatórios presentes.

Conversões não são atribuídas a anúncios

Verifique: janela de atribuição configurada, UTM parameters presentes nos links, domínio verificado no Business Manager.

Dados discrepantes entre Pixel e CAPI

Verifique: event_id idêntico em ambos, deduplicação ativa, timestamps sincronizados.

Conclusão

O Pixel e a CAPI são a fundação técnica de qualquer operação séria de tráfego pago. Invista tempo na implementação correta — cada evento mal configurado é dinheiro perdido em otimização. No Viggno Ads, os dados de conversão são processados automaticamente a partir da Meta Ads API, mas a qualidade desses dados depende diretamente da qualidade da sua implementação de Pixel e CAPI.

Dica Viggno Ads

Acompanhe todas essas métricas em tempo real no seu dashboard do Viggno Ads. Acessar Dashboard →

Quer aplicar o que aprendeu?

Comece seu trial de 14 dias no Viggno Ads e monitore suas campanhas com dados reais.

© 2026 Viggno Educação Ltda. Todos os direitos reservados. CNPJ: 64.668.780/0001-25