O que você vai configurar
- Encaminhamento server-side de conversões para a Meta via Conversions API — melhora a qualidade do sinal para usuários do iOS 14.5+ e com bloqueadores de anúncios.
- O ID do seu Pixel e um token de acesso da Conversions API gerado no Meta Events Manager.
- Um evento de teste para verificar a integração antes de entrar em produção, usando a aba Test Events da Meta.
O Elido envia eventos de conversão para a Conversions API (CAPI) da Meta, do lado do servidor. Isso complementa seu pixel no navegador e melhora a qualidade do sinal, especialmente para usuários que bloqueiam JavaScript ou usam restrições de privacidade do iOS 14.5+.
O que você precisa#
- Uma conta do Meta Business com um pixel.
- Acesso ao Meta Events Manager.
- O token de acesso da Conversions API do pixel.
Passo 1 — Encontre o ID do seu Pixel#
- Vá para o Meta Events Manager.
- No painel esquerdo, clique em Fontes de dados (Data Sources).
- Selecione seu pixel. O ID do Pixel é o número exibido na parte superior (ex:
123456789012345). Copie-o.
Passo 2 — Gere um token de acesso da Conversions API#
Na mesma página de detalhes do pixel:
- Clique na guia Configurações (Settings).
- Role até Conversions API.
- Clique em Gerar token de acesso (Generate access token) em "Configurar manualmente" (Set up manually).
- Copie o token. É uma longa sequência que começa com
EAAB....
Passo 3 — Configure no Elido#
- Vá para Dashboard → Conversions → Meta CAPI → Configurar encaminhamento (Set up forwarding).
- Cole o ID do Pixel e o token de acesso.
- Clique em Salvar (Save).
Passo 4 — Envie um evento de teste#
- No Elido, clique em Enviar evento de teste (Send test event). O Elido dispara um evento de teste
Purchasecomtest_event_code: TEST1234(ou qualquer código que o Elido gerar). - No Meta Events Manager, vá para o seu pixel → guia Eventos de Teste (Test Events).
- Espere até 30 segundos. Você deverá ver o evento
Purchaseaparecer.
Se você vir "Recebido" na guia Eventos de Teste, a integração está funcionando.
Como o Elido mapeia os parâmetros do evento#
| Campo do Elido | Parâmetro do Meta CAPI |
|---|---|
click_id | event_id (para desduplicação) |
conversion.value | value |
conversion.currency | currency |
utm_source | Dados personalizados: source |
utm_campaign | Dados personalizados: campaign |
| IP do usuário (do clique) | client_ip_address (hash antes do envio) |
| User agent do usuário (do clique) | client_user_agent |
O Meta usa event_id para desduplicar eventos entre o pixel do seu navegador e o evento do Elido do lado do servidor. Se ambos dispararem para a mesma conversão, o Meta o conta apenas uma vez.
Nomes de eventos#
O Elido envia Purchase para eventos de conversão. Se você também dispara eventos AddToCart ou Lead em seu site e deseja que eles sejam encaminhados, use a opção de webhooks + payload personalizado para construir um mapeamento personalizado.
Privacidade e tratamento de dados#
O Elido faz hash de e-mail e telefone antes de enviar para o Meta (SHA-256, minúsculas, aparadas). Os endereços IP são enviados em texto simples — o Meta exige isso para correspondência, mas não os armazena além da janela de correspondência. Revise a política de dados da Meta para sua própria avaliação de conformidade sob o GDPR.
Solução de problemas#
Evento de teste não aparece no Events Manager — Verifique o ID do Pixel para erros de digitação. Verifique também se o token de acesso é para o pixel correto — os tokens são específicos do pixel.
Erro "Invalid token" no log de entrega do Elido — O token foi revogado ou pertence a um pixel diferente. Gere novamente em Events Manager → Settings → Conversions API.
Eventos aparecendo, mas sem atribuição no Ads Manager — A atribuição leva de 24 a 72 horas para ser processada. Verifique também se o client_ip_address está sendo passado corretamente — sem um sinal correspondente, o Meta não pode atribuir a uma campanha.
Contagem duplicada com o pixel do navegador — Certifique-se de que o event_id do seu pixel do navegador corresponda ao click_id do Elido. Se forem strings diferentes, o Meta as trata como dois eventos distintos. Consulte o guia de desduplicação da Meta para as regras de correspondência exatas.