Visão geral
O pixel da Meta roda no navegador do comprador, onde bloqueadores, configurações de privacidade do iOS e escolhas de consentimento impedem muitos eventos. A API de Conversões envia esses mesmos eventos a partir de um servidor. A AffClix faz isso por você: quando uma conversão é aprovada, ela envia um evento de servidor ao seu conjunto de dados (pixel) com o nome de evento mapeado, o valor da venda e os sinais de identidade que você permitir.
A configuração leva poucos minutos: conecte o Facebook, escolha o conjunto de dados em uma lista e mapeie suas metas da AffClix para os eventos padrão da Meta. Se o site também usa o pixel, a Meta mantém um único evento por conversão, porque a AffClix envia o ID da conversão como ID do evento.
Por que esta integração é importante
- Recupere conversões perdidas — compras que o pixel nunca viu, por bloqueadores, iOS ou cookies recusados, também chegam à Meta.
- Otimização melhor — o Advantage+ e as campanhas de conversão aprendem com as vendas que seus parceiros fecham.
- Apenas conversões aprovadas — conversões pendentes, rejeitadas ou com corte nunca são enviadas, então a Meta otimiza com a receita que você mantém.
- Valores reais — cada evento traz o valor da venda e a moeda, para uma otimização por valor e um ROAS precisos.
- Sem duplicar o pixel — o ID de conversão da AffClix é enviado como ID do evento, então a Meta conta uma única compra mesmo que o pixel e o servidor a informem.
- Você controla o que é compartilhado — escolha quais sinais de identidade saem da AffClix; localização e IDs externos passam por hash SHA-256 antes do envio.
- Histórico completo — cada tentativa é registrada com a resposta da Meta no relatório CAPI Delivery.
Pré-requisitos
- Um plano da AffClix que inclua Conversions API — o menu Integrations → Conversions API.
- Um conjunto de dados (pixel) da Meta no Gerenciador de Eventos. Use o que já recebe os eventos de navegador do site, para que eventos de servidor e de navegador se juntem.
- Uma conta do Facebook com acesso a esse conjunto de dados — como pessoa no Business Manager proprietário ou por atribuição de parceiro.
- Conversões chegando à AffClix por postback, pixel ou integração de e-commerce, e aprovadas.
- Opcional: um código de evento de teste em Gerenciador de Eventos → seu conjunto de dados → Eventos de teste, para verificar a configuração antes do tráfego real.
Etapa 1: Prepare seu conjunto de dados no Gerenciador de Eventos
Tudo o que a AffClix precisa já existe no Gerenciador de Eventos; você só precisa saber qual conjunto de dados usar.
Abra o Gerenciador de Eventos
No Meta Business Suite, abra Events Manager → Data sources e selecione o conjunto de dados (pixel) usado pelo site.
Anote o ID do conjunto de dados
É o número exibido abaixo do nome. Normalmente você o escolhe em uma lista na AffClix, mas vale saber qual é o correto.
Copie um código de teste (opcional)
Abra a aba Test events do conjunto de dados e copie o código, por exemplo TEST12345. A AffClix o usa apenas no botão Send test event — conversões reais nunca o levam.
Verifique seu acesso
Confirme que a conta do Facebook que você vai conectar pode gerenciar esse conjunto de dados. Se ele pertence à empresa de um cliente, peça que o atribua a você ou à empresa da sua agência.
Você também pode conectar colando um token de acesso da API de Conversões: Gerenciador de Eventos → seu conjunto de dados → Settings → Conversions API → Generate access token. Veja a etapa 2.
Etapa 2: Conecte o Facebook na AffClix
Abra Conversions API
Acesse Integrations → Conversions API e clique em Add destination.
Escolha Meta CAPI
Selecione o bloco Meta CAPI e dê um nome ao destino, como Meta – Conjunto principal. Deixe Campaign ID vazio para enviar as conversões de todas as campanhas, ou informe o ID de uma campanha.
Conecte o Facebook
Clique em Connect Facebook e faça login com a conta do Facebook que gerencia o conjunto de dados. Aprove as permissões pedidas pela Meta — a AffClix precisa da permissão de anúncios para enviar eventos. A AffClix nunca vê sua senha.
Escolha o conjunto de dados
De volta à AffClix, você verá Facebook connected. Escolha o conjunto de dados em Pixel / Dataset ID. Se ele não aparecer, digite o ID nesse mesmo campo.
Ou cole um token de acesso
Se Connect Facebook não aparecer, ou se preferir seu próprio token de usuário do sistema, cole-o em Access token, clique em Verify token & load pixels e escolha o conjunto de dados. O indicador mostra Paste access token → Verify token → Choose dataset.
A Meta concede o acesso conectado por cerca de 60 dias, sem renovação automática. Antes de expirar, abra o destino e clique em Reconnect Facebook — o conjunto de dados e o mapeamento continuam iguais. A AffClix também avisa se a Meta começar a rejeitar eventos.
Etapa 3: Mapeie suas metas para eventos da Meta
Na Meta, o nome do evento importa: é o evento que a Meta informa e usa para otimizar. Use os nomes de evento padrão da Meta sempre que houver um adequado.
Mapeie cada meta
Em Event Mapping & Matching, escolha uma meta em Your goal e informe o evento da Meta em Platform event — por exemplo, venda → Purchase, lead → Lead, cadastro → CompleteRegistration.
Decida sobre um curinga
Uma linha com a meta * captura todas as metas que você não mapeou. Remova-a se apenas as metas listadas devem ser enviadas.
Escolha as chaves de correspondência
Em Match keys to send, deixe tudo desmarcado para enviar todos os sinais disponíveis, ou marque só o que sua política de consentimento permite. Mais sinais significam maior qualidade de correspondência de eventos (EMQ) no Gerenciador de Eventos.
Se uma meta não tem linha própria e não há linha *, as conversões dessa meta são ignoradas neste destino. É assim que você mantém, por exemplo, leads fora de um conjunto de dados só de compras.
Click IDs envia o ID de clique baseado no fbclid; fbc / fbp envia os cookies de navegador da Meta; IP + UA envia o endereço IP e o navegador do visitante; Geo envia cidade, região, CEP e país (com hash); External ID envia seu ID de cliente (com hash). A AffClix não guarda e-mails nem telefones, então eles nunca são enviados.
Etapa 4: Salve e teste
Salve
Confirme que Active está ativado e clique em Create destination.
Envie um evento de teste
Informe um Test event code no destino, salve e clique em Send test event na lista de Conversions API. A AffClix envia um Purchase de teste, que aparece em até um minuto em Gerenciador de Eventos → seu conjunto de dados → Test events. Esse botão exige um código de evento de teste.
Confirme os eventos reais
Após a próxima conversão aprovada, procure uma linha Delivered em Reports → Delivery Logs → CAPI Delivery e confira em Gerenciador de Eventos → Overview a chegada de eventos de servidor pela API de Conversões.
Exemplo real
Uma marca de moda divulga a loja com criadores no Instagram e roda campanhas de compras Advantage+ no mesmo conjunto de dados. Muitos compradores usam iPhone.
- Um comprador segue, a partir do Instagram, o link da AffClix de um criador. A AffClix registra o clique, incluindo o ID de clique da Meta.
- O comprador compra uma jaqueta por € 89, mas a privacidade do Safari impede o pixel de informar a compra.
- O postback da marca registra a venda na AffClix, e a venda é aprovada.
- A AffClix envia um evento
Purchaseao conjunto de dados com valor 89, moeda EUR, o ID de clique e a localização com hash — e o ID da conversão como ID do evento.
Resultado: a Meta conta a compra que o pixel perdeu, credita-a à campanha certa e otimiza a entrega com vendas reais. Quando o pixel disparou com o mesmo ID de evento, a Meta mantém uma única compra.
Gerenciar e monitorar a integração
- Pausar sem excluir — use o botão na linha do destino ou desative Active.
- Renovar o login — reconecte o Facebook antes que o login de cerca de 60 dias expire; o destino mantém o conjunto de dados e o mapeamento.
- Alertas de credenciais — a AffClix verifica cada destino a cada hora. Se a Meta começar a rejeitar eventos porque um token expirou ou foi revogado, a linha mostra Reconnect credentials e o proprietário do espaço de trabalho recebe um e-mail.
- Qualidade de correspondência de eventos — o Gerenciador de Eventos avalia cada evento de servidor. Permita mais chaves de correspondência para melhorá-la.
- Status de CAPI em cada conversão — o relatório de conversões ganha uma coluna CAPI com Delivered, Failed ou Partial.
Registros do CAPI Delivery
Cada tentativa é registrada em Reports → Delivery Logs → CAPI Delivery. Filtre por data, plataforma, destino e status.
| Coluna | O que informa |
|---|---|
| Platform / Event | O destino e o evento da Meta enviado, por exemplo Purchase. |
| Status | Delivered, ou Failed com o motivo. |
| Response code | O status HTTP retornado pela Meta. |
| Attempts / Retryable | Quantas tentativas foram feitas e se a falha foi temporária e será tentada novamente. |
| Error | A mensagem de erro da Meta, com o ID de rastreamento para chamados de suporte. |
Solução de problemas
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| A lista de conjuntos de dados está vazia | A conta do Facebook não vê o conjunto de dados, ou a empresa o compartilha só por atribuição de ativos. | Digite o ID do conjunto de dados no campo, ou peça ao proprietário que o atribua a você. |
| “This login did not grant ads_management” | A permissão de anúncios foi recusada na tela de consentimento do Facebook. | Clique em Reconnect Facebook e aprove todas as permissões pedidas pela Meta. |
| Send test event falha | O destino não tem código de evento de teste. | Copie o código em Gerenciador de Eventos → Test events, salve-o no destino e tente de novo. |
| A linha mostra Reconnect credentials | O login do Facebook expirou (cerca de 60 dias) ou o token foi revogado. | Abra o destino e clique em Reconnect Facebook, ou cole um novo token. |
| A Meta conta compras em dobro | O pixel do site informa a compra com outro ID de evento. | Faça o site enviar o ID de conversão da AffClix como ID de evento do pixel, ou use só o evento de servidor. |
| As conversões estão na AffClix, mas não na Meta | Ainda não foram aprovadas, ou a meta não tem linha no mapa de eventos e não há linha *. | Aprove as conversões ou adicione um mapeamento para a meta. |
Conclusão
Com a Meta conectada, cada conversão aprovada gerada pelos seus parceiros chega ao seu conjunto de dados pelo servidor — com o nome de evento certo, o valor real e os sinais de identidade que você permite —, e a Meta informa e otimiza com vendas reais. Renove o login do Facebook a cada dois meses, aproximadamente, e acompanhe o relatório CAPI Delivery.
Apenas conversões aprovadas são enviadas à Meta. Conversões pendentes, rejeitadas ou com corte nunca são enviadas; uma conversão aprovada depois é enviada no momento da aprovação.
Relacionados: Visão geral da Conversions API · API de Conversões do Google Ads · Meta Ads com o WebSDK