O que é a API de Conversões da Meta (CAPI) e por que instalar?

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

A API de Conversões (em inglês, Conversions API, ou CAPI) é a forma oficial de enviar para a Meta os eventos que acontecem no seu negócio: uma compra, um cadastro, um item adicionado ao carrinho. Segundo a documentação da Meta, ela foi criada para conectar os dados de marketing do anunciante, vindos do servidor, da plataforma do site, do app ou do CRM, aos sistemas da Meta que otimizam a segmentação, reduzem o custo por resultado e medem os resultados.

Na prática, em vez de depender só de um código rodando no navegador do visitante (o Pixel), a sua loja passa a mandar os eventos também "por trás", de servidor para servidor.

A CAPI aceita mais do que eventos de site. A documentação lista quatro grupos:

• eventos de site;
• eventos de app;
• eventos de conversas com empresas (business messaging);
• conversões offline, como vendas em loja física.

Por que isso importa para quem anuncia

Os algoritmos de entrega da Meta aprendem com os eventos que recebem. Se uma parte das vendas não chega, a plataforma otimiza com informação incompleta e os relatórios mostram menos conversões do que de fato aconteceram. Se você já leu sobre a fase de aprendizado no Meta Ads, sabe que volume e qualidade de sinal fazem diferença na estabilidade das campanhas.

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

O Pixel e a CAPI não competem: são dois canais para o mesmo objetivo. A recomendação da Meta, tanto na documentação para desenvolvedores quanto na Central de Ajuda, é usar a API de Conversões junto com o Pixel, compartilhando os mesmos eventos pelos dois. A Meta chama isso de configuração redundante.

No Gerenciador de Eventos, a Meta mostra a cobertura de eventos: a porcentagem de eventos recebidos pela CAPI em comparação com os eventos únicos do Pixel. A Central de Ajuda sugere mirar uma razão de cobertura de 75% para ter relatórios precisos e melhor desempenho dos anúncios.

Como evitar contar a mesma venda duas vezes (deduplicação)?

Se o Pixel e a CAPI enviam a mesma compra, a Meta precisa saber que é um evento só. Isso se chama deduplicação. A documentação oficial descreve dois métodos.

Método 1 (recomendado): event_id + nome do evento

• O eventID enviado pelo Pixel precisa ser igual ao event_id enviado pela CAPI.
• O nome do evento no Pixel precisa ser igual ao event_name da CAPI (por exemplo, Purchase nos dois).
• Quando a mesma chave chega pelos dois canais no mesmo Pixel em até 48 horas, a Meta descarta as repetições. Em geral, ela mantém o evento que chegou primeiro.

Cada evento precisa de um ID único, e a deduplicação só acontece se os eventos chegarem em até 48 horas do primeiro evento com aquele ID. Na prática, o número do pedido é um bom candidato a event_id nas compras.

Método 2: fbp e/ou external_id

Também é possível deduplicar usando o mesmo nome de evento junto com o fbp (identificador do navegador) e/ou o external_id (um ID de cliente seu). Mas há limites: esse método, em geral, só funciona quando o evento do navegador chega antes do evento do servidor, e não deduplica eventos enviados por uma fonte só.

Por isso, na maioria dos e-commerces, o caminho mais seguro é gerar um event_id por pedido e enviá-lo nos dois canais.

O que é Event Match Quality e quais dados enviar?

A Event Match Quality (qualidade de correspondência do evento, ou EMQ) é uma nota de 0 a 10 que a Meta calcula para eventos de site enviados pela CAPI com action_source igual a website. Ela indica o quanto os dados de cliente enviados ajudam a associar aquele evento a uma conta da Meta. A Central de Ajuda informa que a nota usa as últimas 48 horas de dados, por isso é importante enviar eventos com regularidade.

Quanto mais eventos são associados, mais conversões a Meta consegue atribuir aos anúncios e melhor ela entende quem tende a converter.

Parâmetros de cliente e prioridade

A Meta classifica os parâmetros por prioridade:

• Alta: e-mail e click ID (fbc).
• Média: Facebook Login ID, data de nascimento, país, telefone, external_id e browser ID (fbp).
• Baixa: lead ID, nome, sobrenome, cidade e CEP.

Hash: o que precisa e o que não pode

A documentação exige hash SHA-256 em e-mail (em), telefone (ph), nome (fn), sobrenome (ln), data de nascimento (db), gênero (ge), cidade (ct), estado (st), CEP (zp) e país (country). Para external_id, o hash é recomendado. Já IP, user agent, fbc e fbp não devem passar por hash.

Antes do hash, os dados precisam ser normalizados. Alguns exemplos da documentação:

• e-mail sem espaços nas pontas e em minúsculas;
• telefone só com números e com código do país (no Brasil, 55);
• país no código ISO de duas letras em minúsculas (br), enviado sempre, mesmo que toda a base seja de um país só.

Quais são as formas de instalar a API de Conversões?

A Meta descreve alguns caminhos. A escolha depende da plataforma da loja e de quanta equipe técnica você tem.

• Integração da plataforma de e-commerce. Algumas plataformas já trazem a CAPI. Na Nuvemshop, por exemplo, a central de ajuda informa que, ao conectar o portfólio da Meta pelo canal "Instagram e Facebook", a API de Conversões é ativada automaticamente. Antes de contratar qualquer ferramenta, confira na central de ajuda da sua plataforma se a integração nativa existe.
• Configuração pelo Gerenciador de Eventos. Para quem já usa o Pixel, a Meta oferece configurar a CAPI para eventos de site direto no Gerenciador de Eventos, sem código.
• Conversions API Gateway. É uma opção de autoconfiguração no Gerenciador de Eventos, pensada para quem não tem desenvolvedores dedicados. Ela roda em uma conta de nuvem da própria empresa (a documentação dá a AWS como exemplo), e o custo principal é o da infraestrutura de nuvem. O Gateway recebe os eventos do Pixel, repassa para a CAPI e gera um ID de evento para a deduplicação.
• Integração direta. Seu time de desenvolvimento conecta o servidor da loja ao endpoint da API. É o caminho com mais controle sobre quais eventos e parâmetros são enviados.

Atenção para não empilhar soluções: a própria Nuvemshop orienta desconectar o Gateway da Meta antes de ativar a integração nativa, porque usar os dois pode prejudicar os dados.

Passo a passo para instalar e validar a CAPI

1. Liste os eventos que importam. Para e-commerce, normalmente PageView, ViewContent, AddToCart, InitiateCheckout e Purchase. Para geração de leads, Lead e os eventos do seu CRM.
2. Escolha o método de integração. Prefira a integração nativa da sua plataforma, se existir. Use o Gateway ou a integração direta quando precisar de mais controle.
3. Garanta a deduplicação. Gere um event_id único por evento (o número do pedido funciona bem para compras) e envie o mesmo valor e o mesmo nome de evento pelo Pixel e pela CAPI.
4. Envie dados de cliente normalizados e com hash. Comece pelos de prioridade alta e média que você coleta de forma legítima, como e-mail e telefone.
5. Teste antes de confiar. Use a ferramenta de eventos de teste do Gerenciador de Eventos para conferir se o envio está bem formado.
6. Acompanhe os indicadores do Gerenciador de Eventos. A Central de Ajuda recomenda checar a aba de deduplicação, a cobertura de eventos (a referência de 75% citada acima), a Event Match Quality e a atualidade dos dados, enviando eventos em tempo real ou o mais perto disso possível.
7. Revise o diagnóstico com frequência. Mudanças no site, no checkout ou em apps instalados podem quebrar eventos sem aviso.

Com os eventos chegando bem, fica mais fácil confiar nas métricas de resultado. Para entender como ler esses números, veja o guia sobre ROAS, CAC e MER.

CAPI e LGPD: o que observar?

Enviar dados de clientes para a Meta é tratamento de dados pessoais. No Brasil, isso está sujeito à Lei Geral de Proteção de Dados (Lei 13.709/2018). Segundo a ANPD, a lei prevê dez bases legais para o tratamento de dados pessoais, e o consentimento do titular é uma delas.

A Meta deixa claro que a responsabilidade é do anunciante. Os termos das ferramentas de negócios da Meta exigem que você tenha direito legal de coletar, usar e compartilhar os dados, que faça o hash das informações de contato conforme a documentação e que não compartilhe dados sensíveis. A Meta também recomenda obter as permissões e consentimentos necessários e montar o plano de conformidade com sua assessoria jurídica.

Pontos práticos para levar ao seu jurídico e ao time de dados:

• quais dados de cliente serão enviados e com qual base legal;
• como a política de privacidade e o banner de cookies descrevem esse compartilhamento;
• como respeitar quem não autorizou o uso dos dados para publicidade.

Este conteúdo é informativo e não substitui orientação jurídica.

Como a Increase trabalha com a CAPI

Na Increase, a revisão da API de Conversões costuma ser um dos primeiros pontos que olhamos em uma conta de Meta Ads: deduplicação, cobertura de eventos e qualidade de correspondência antes de qualquer mudança de estratégia de mídia. Se quiser uma leitura da sua operação, solicite um Diagnóstico.