Meta Conversions API na MKTOn: System User Token + snippet do site (passo a passo)

O gatilho Meta Ads da MKTOn dispara os eventos Lead, Purchase e LeadLost pra Conversions API (CAPI) sempre que o lead cai na etapa correspondente do funil. Pra funcionar em produção com estabilidade e taxa de match alta, você precisa de duas coisas: um System User Token (que não expira) salvo na sua workspace, e o snippet de captação colado no site pra pegar os cookies fbc / fbp e o par-metro fbclid.

1. Gerar o System User Token no Business Manager

1. Entre no Business Manager (business.facebook.com) com um usuário admin do negócio.
2. Vá em Configurações do Negócio → Usuários → Usuários do sistema.
3. Se ainda não tiver, clique em Adicionar e crie um System User com função Admin (ex.: "MKTOn Integração").
4. Selecione esse usuário e clique em Adicionar ativos → escolha a Conta de Anúncios e o Pixel que a MKTOn vai usar, com acesso total.
5. Ainda no mesmo usuário, clique em Gerar novo token.
6. Selecione o app da MKTOn (ou o app padrão do seu Business Manager) e marque os escopos: ads_management, business_management e, se estiver disponível, pages_read_engagement.
7. Escolha validade Nunca expira (esse é o ponto todo do System User).
8. Copie o token que aparece, ele começa com EAAB… e só é mostrado uma vez.

2. Salvar o token na MKTOn

1. No painel da MKTOn, entre em Integrações → Meta.
2. Localize o bloco Pixel / Conversions API → System User Token.
3. Cole o token e clique em Salvar. A MKTOn valida contra a Graph API e mostra o nome do System User confirmando que deu certo.
4. A partir de agora, todo disparo do gatilho Meta Ads usa esse token, o OAuth do usuário vira só fallback.

3. Colar o snippet no site do cliente

O snippet é um <script> leve que roda no navegador do visitante, lê os cookies _fbp / _fbc e o fbclid da URL, e envia esses dados pra MKTOn junto com o leadId assim que o formulário é enviado. Isso permite que o CAPI mande o evento server-side com o mesmo event_id do Pixel do navegador, o Meta deduplica os dois e conta como um único evento de alta qualidade.

1. Copie o snippet no bloco Snippet de captação no site do cliente (em Integrações → Meta).
2. Cole antes do </head> em todas as páginas com formulário de lead (landing pages, checkout, blog, etc.).
3. Em cada formulário, adicione o atributo data-mkton-lead-id="{{leadId}}" no <form>, troque {{leadId}} pelo ID do lead assim que ele for criado (ou por um ID temporário que você já mande no webhook de entrada).
4. Publique a página e envie um lead de teste. No Gerenciador de Eventos do Meta, o evento Lead deve aparecer marcado como Pixel + Server (Deduplicado).

<script src="https://app.mkton.io/api/public/track/meta-snippet"
  data-pixel-id="SEU_PIXEL_ID"
  data-mkton-origin="https://app.mkton.io"></script>

4. Testar antes de virar produção

No Gerenciador de Eventos do Meta, abra Test events e copie o Test Event Code (formato TEST12345). No modal do gatilho Meta Ads (CRM → Funis de venda → Automatize → etapa desejada → Meta Ads), cole esse código no campo Test Event Code. Enquanto ele estiver preenchido, os eventos vão pra aba de testes, não afetam otimização de campanha. Quando tudo estiver validado, apague o campo pra ir pra produção.

5. Moeda: definida pela conta, não pelo vendedor

A moeda enviada ao Meta (BRL, USD, EUR…) é a moeda principal da workspace, definida em Configurações → Moeda principal da conta. Só owner ou admin conseguem trocar. Isso garante que todos os vendedores do mesmo cliente disparam o CAPI com a mesma currency, evita rejeição de evento por moeda inconsistente na BM.

Checklist final

• System User Token salvo → status "configurado" no painel Meta
• Snippet colado antes do </head> em todas as páginas de captação
• Atributo data-mkton-lead-id preenchido nos <form>
• Gatilhos Lead / Purchase / LeadLost adicionados nas etapas certas do funil
• Test Event Code validado no Gerenciador de Eventos antes de tirar o campo
• Moeda principal da workspace conferida em Configurações