# API de Conversões da Meta (CAPI) para formulários de leads: envie leads sem contagem duplicada

> **Resposta**: A API de Conversões da Meta (CAPI) envia eventos a partir do seu servidor, e não do navegador do visitante. Use-a junto com o Pixel e dê aos dois **o mesmo nome de evento e o mesmo ID de evento**; assim a Meta fica com um e descarta o duplicado. Os leads que o Pixel perde (bloqueadores de anúncios, limites de rastreamento dos navegadores, abas fechadas) continuam sendo registrados pelo evento do servidor.

## Por que só o Pixel não basta

O Pixel roda no navegador do visitante. Bloqueadores de anúncios, limites de rastreamento do iOS e pessoas que fecham a aba logo depois de enviar, tudo isso faz eventos se perderem. A Meta passa então a reportar menos conversões do que houve e otimiza seus anúncios com menos dados. Uma cópia enviada pelo servidor cobre essa lacuna.

## O que você precisa

1. **ID do Pixel (conjunto de dados)**, em Gerenciador de Eventos da Meta → Fontes de dados.
2. **Token de acesso da API de Conversões**: Gerenciador de Eventos → seu conjunto de dados → Configurações → API de Conversões → Gerar token de acesso.
3. **Código de evento de teste** (opcional): aparece na aba Eventos de teste e começa com `TEST`.

## Como funciona a desduplicação

| Enviado por | Nome do evento | ID do evento |
|---|---|---|
| Pixel no navegador | `Lead` | `fbq('track', 'Lead', {}, {eventID: 'abc123'})` |
| Servidor (CAPI) | `Lead` | `"event_id": "abc123"` |

Quando o mesmo nome e o mesmo ID chegam pelos dois lados, a Meta fica com um. Se os IDs forem diferentes, ou se o nome for diferente (por exemplo `Lead` e `SubmitApplication`), o lead é contado duas vezes. Gere um único ID no navegador no momento do envio e passe-o para os dois.

## O que colocar no evento do servidor

- `event_name` (Lead), `event_time`, `event_id`, `action_source: "website"`, `event_source_url`
- `user_data`
  - enviados como estão: `client_ip_address`, `client_user_agent`, `fbc` (cookie do ID de clique), `fbp` (cookie do ID do navegador)
  - com hash SHA-256: telefone (`ph`, só dígitos com código do país, ex.: 821012345678), e-mail (`em`, em minúsculas), nome

Mais identificadores melhoram a Qualidade da Correspondência de Eventos, mas resolva o consentimento antes.

## Consentimento: dado com hash continua sendo dado pessoal

Pela Personal Information Protection Act da Coreia (e pela maioria das leis de privacidade), aplicar hash a um número de telefone não o torna anônimo, e a Meta é uma destinatária no exterior. Uma configuração segura:

1. Adicione um consentimento separado e opcional para "transferência internacional para mensuração de anúncios": destinatário (Meta Platforms), país, itens, finalidade, prazo de retenção.
2. Inclua os dados de contato com hash só de quem concordou.
3. Para todos os outros, envie o evento só com IP, user agent e IDs de clique.
4. Nunca envie informações de saúde, como sintomas.

Veja [texto de consentimento para formulários de leads na Coreia](/en/guides/landing-consent-text) ou gere o seu com a [ferramenta grátis de consentimento](/en/tools/consent).

## Verifique

1. Adicione o código de evento de teste e envie um lead de teste.
2. Em Eventos de teste, deve aparecer um evento do Navegador e um do Servidor, um deles marcado como desduplicado.
3. Remova o código de teste antes de colocar no ar.

## Devolva os resultados

Quando um lead vira consulta ou venda, envie um evento personalizado pelo servidor com os mesmos identificadores com hash (ou um ID externo). Assim a Meta consegue aprender quais pessoas vão além de preencher o formulário.

## No CutLanding

Cole o ID do Pixel e o token de acesso em Configurações → Conectar. Depois que um lead é salvo, os eventos do Pixel e do servidor saem com o mesmo ID, os dados de contato com hash são adicionados só para quem deu consentimento para mensuração de anúncios, dados de saúde nunca são enviados e envios que falham são repetidos por 24 horas.

## FAQ

### Posso tirar o Pixel e usar só a API de Conversões?

A Meta recomenda usar os dois com desduplicação. Os dados do navegador (cookies fbp e fbc) ajudam na correspondência e, se um dos lados falhar, o outro ainda registra o lead.

### Meus leads estão sendo contados duas vezes. Por quê?

Os nomes ou os IDs de evento são diferentes entre o Pixel e o servidor. Use um único ID por envio nos dois lados e o mesmo nome de evento.

### E se o meu token de acesso vazar?

Gere um novo token no Gerenciador de Eventos e substitua-o em todos os lugares onde ele é usado. Mantenha o token só no servidor, nunca no HTML da página.


---
Source: https://cutlanding.com/pt/guides/meta-conversions-api
© CutLanding (컷랜딩). Quote freely with a link to the source.
