Um pedido foi feito na loja online, mas a Meta não consegue vê-lo. Em outras ocasiões, ela o vê duas vezes. A equipe então otimiza campanhas usando números em que não confia, e a primeira ideia é: vamos implementar a CAPI e isso resolverá tudo.
A Conversions API pode tornar a medição mais precisa porque envia alguns eventos de marketing do servidor, do CRM ou da plataforma diretamente para os sistemas da Meta. Mas ela não recuperará dados que a empresa nunca cria, nem corrigirá conversões mal nomeadas. Primeiro, você precisa de um plano de medição. Só então vem a transferência de dados.
A CAPI não substitui o Pixel nem o consentimento
A Meta descreve a Conversions API como uma conexão mais direta entre os dados de marketing de uma empresa e seus sistemas para medir e otimizar anúncios. Para eventos da web, recomenda considerar a CAPI junto com o Meta Pixel. Os caminhos no navegador e no servidor podem complementar um ao outro.
Isso não significa que o servidor possa enviar tudo o que o navegador não enviou. A Meta declara explicitamente que a CAPI não foi criada para contornar regras de privacidade, regulamentações europeias ou restrições da plataforma. Trate o consentimento e a licitude do processamento de acordo com os dados específicos, a região e a avaliação jurídica. Um e-mail com hash ainda é um dado derivado de uma pessoa, não uma cortina de fumaça.
Primeiro decida quais eventos têm valor comercial
Para uma loja online, geralmente faz sentido acompanhar o caminho desde a visualização de um produto, passando pelo carrinho e pelo checkout, até a compra. Para um site de geração de leads, o envio de um formulário ou um lead qualificado pode ser mais importante. Eu não enviaria cada clique como conversão simplesmente porque isso é possível.
Para cada evento, anote:
- o que exatamente precisa acontecer no mundo real,
- se é o principal resultado comercial ou apenas um sinal de diagnóstico,
- qual sistema é a fonte de verdade,
- qual identificador exclusivo você usará,
- quais parâmetros a publicidade e os relatórios precisam,
- em quais condições você tem permissão para enviar os dados.
Em uma compra, a fonte de verdade geralmente é o pedido confirmado na loja online ou no backend, não apenas a abertura da página de agradecimento. Para um lead, o formulário pode ser o primeiro sinal, mas somente o CRM confirma a qualidade do contato.
A deduplicação determina se a medição dupla ajuda
Quando você envia o mesmo evento pelo Pixel e pelo servidor, a Meta precisa reconhecê-lo como um único evento. Isso exige o mesmo nome de evento e o mesmo event_id em ambos os caminhos.
Para uma compra, um ID de pedido estável pode ser uma base adequada. Para um evento sem seu próprio ID comercial, crie um identificador exclusivo quando a ação ocorrer e passe-o para as camadas do navegador e do servidor. Um identificador aleatório gerado separadamente em cada lado não ajudará — os valores não corresponderão.
Deduplicação não é um detalhe para desenvolvedores. Se ela falhar, as campanhas poderão receber um sinal duplicado e os relatórios começarão a mentir.
Quatro caminhos de implementação têm custos diferentes
Um parceiro ou recurso de uma plataforma de e-commerce
Para uma loja online típica, esta costuma ser a primeira escolha. A plataforma mantém a integração continuamente, e a empresa não precisa assumir o código da API. Ainda assim, verifique quais eventos ela envia, se lida com deduplicação e consentimento e se permite inspecionar os parâmetros.
Um serviço gerenciado ou gateway
Um provedor assume parte da infraestrutura e das atualizações. Você paga pela operação e pela dependência, mas reduz sua própria manutenção técnica. Isso faz sentido se o serviço for compatível com sua stack e você tiver acesso claro aos diagnósticos.
Google Tag Manager do lado do servidor
Um contêiner de servidor pode unificar várias transferências de dados de marketing e dar à empresa mais controle. Ao mesmo tempo, acrescenta hospedagem, templates, permissões e outro local que precisa ser testado. Eu não o escolheria apenas por causa de um belo diagrama de arquitetura.
Uma integração direta personalizada
Ela oferece a maior flexibilidade e também a maior responsabilidade. Você precisará de gestão segura de tokens, validação de entradas, registros sem vazamento de dados sensíveis, recuperação de erros, gestão de versões da API e alguém que faça a manutenção da integração.
O artigo original oferecia um script PHP curto e um endpoint publicamente acessível. Não recomendo mais essa solução como guia geral. Ela continha uma versão antiga da API e pressupostos de segurança e operação em excesso. Um código que funciona hoje depois de ser copiado pode descartar eventos silenciosamente amanhã. Para uma integração direta, trabalhe com a documentação atual da Meta e faça um desenvolvimento normal, não marketing de copiar e colar.
A qualidade dos eventos importa mais do que o número de parâmetros
Um evento do lado do servidor normalmente precisa de nome, horário, origem da ação e URL ou outro contexto, dependendo da origem. Para um evento comercial, adicione o valor relevante, a moeda, os itens e um ID estável. Envie identificadores de usuários somente quando tiver direito a obtê-los, eles estiverem normalizados corretamente e no formato exigido.
Mais identificadores podem melhorar a correspondência, mas “quanto mais, melhor” não é verdade sem limites. Não envie valores vazios, inventados ou desatualizados. E certamente não crie uma impressão digital para contornar a escolha do usuário.
O teste precisa abranger toda a jornada
- Inicie o modo de teste no Meta Events Manager.
- Conclua um cenário real, desde a entrada no site até um pedido ou lead.
- Verifique os eventos do navegador e do servidor, seus parâmetros e os IDs correspondentes.
- Confira se a Meta deduplica o par e não exibe um erro de diagnóstico.
- Compare o valor, a moeda e o ID com o backend ou CRM.
- Teste tanto a concessão quanto a recusa do consentimento de acordo com sua solução.
- Após a implantação, monitore diagnósticos e perdas ao longo do tempo, não apenas um teste com sinal verde.
O Test Events confirma que a mensagem técnica chegou. Ele não confirma que você selecionou a conversão correta nem que a integração está em conformidade legal.
CAPI e GA4 são duas camadas diferentes
A CAPI envia eventos para a Meta para medição e otimização de publicidade. O GA4 analisa o site e o aplicativo em diferentes fontes. Os números podem divergir por causa de atribuição, consentimento, identidade e processamento. Não tento forçá-los a uma correspondência absoluta; primeiro verifico se cada sistema recebe dados tecnicamente corretos e se os usamos para a decisão certa.
Se você precisa de uma visão geral compartilhada de custos e resultados do site, leia também como conectar o Meta Ads ao GA4. O guia do Google Tag Manager aborda a implementação das tags, e o guia do GA4 explica o significado dos eventos.
Quando eu ainda não implementaria a CAPI
Se a empresa não definiu suas conversões, não sabe qual pedido é válido ou não consegue manter seu Pixel atual, adicionar um caminho do lado do servidor aumentará o caos. Primeiro corrija os dados de origem e o plano de medição. A CAPI faz sentido quando você sabe qual sinal deseja enviar, por que a Meta precisa dele e quem será responsável pela integração.
Se quiser escolher a menor solução adequada para sua loja online ou site de geração de leads, envie-me a plataforma, a configuração de medição atual e o evento mais importante para sua empresa por meio do contato.