Conta de anúncios da Meta e API de Conversões - gasto real de cada peça e a venda devolvida à Meta

Ligue a conta de anúncios da Meta ao CRM para o Hap ler o gasto real de cada anúncio, dia a dia, e devolver à Meta o lead e a venda que vieram do clique - é o que permite ver o custo por venda de cada peça e ajuda a Meta a achar mais gente parecida com quem compra.

CRMAtualizado em 12/10/2026

Quando usar

Quando você anuncia no Instagram ou no Facebook e quer o custo por venda real de cada peça, em vez do orçamento da campanha dividido pelos dias.

Antes de começar

  • Ser administrador ou gestor do CRM (só eles alteram esta tela)
  • Ser administrador do portfólio empresarial (Gerenciador de Negócios) da empresa na Meta, para criar o usuário do sistema e gerar o token
  • As campanhas e os criativos cadastrados em CRM > Configurações > Campanhas e criativos

Para que serve

Esta tela faz duas coisas, independentes uma da outra:

As duas partes da tela
ParteO que fazSem ela
Leitura do gastoO Hap lê o gasto de cada anúncio, dia a dia, e o relatório de criativos passa a ter o custo por venda de cada peçaO relatório usa o orçamento da campanha dividido pelos dias - não sabe que você pausou o anúncio na quarta-feira
API de ConversõesO Hap avisa a Meta quando o lead que clicou no anúncio vira card e quando ele vira venda, com o valorA Meta só sabe quem clicou, não quem comprou, e otimiza o anúncio para clique

Onde fica: CRM > Configurações > Conta de anúncios da Meta, no grupo Captação e comunicação.

1. Na Meta: o usuário do sistema e o token

O Hap lê a sua conta com um token de um usuário do sistema - um usuário técnico da sua empresa na Meta, que não depende da senha de ninguém. Quem faz este passo é um administrador do portfólio empresarial da empresa.

  1. 1

    No Meta Business Suite (business.facebook.com), clique na engrenagem Configurações, no fim da barra lateral. Na página que abre, com o nome do seu portfólio empresarial no topo, vá em Usuários > Usuários do sistema e clique em Adicionar. Dê um nome, como Hap, e a função Funcionário.

    Configurações do portfólio empresarial, em Usuários > Usuários do sistema. Adicionar cria o usuário; com ele selecionado, aparecem a aba Ativos atribuídos e o botão Gerar token
  2. 2

    Clique no usuário criado e atribua a ele a conta de anúncios (Atribuir ativos > Contas de anúncios), com a permissão de ver o desempenho. Enquanto a aba Ativos atribuídos mostrar "Nenhum ativo atribuído", o token não lê gasto nenhum.

  3. 3

    Clique em Gerar token. Escolha o aplicativo, a validade Nunca e marque a permissão ads_read. Gere e copie o token inteiro.

    O passo Atribuir permissões do Gerar token. Aqui a lista só oferece as permissões do WhatsApp: é o sinal de que o aplicativo escolhido não tem o caso de uso de anúncios

Para achar o número da conta de anúncios: nas mesmas Configurações, abra Contas > Contas de anúncios, clique na conta e copie a Identificação. Ele também aparece no Gerenciador de Anúncios, em Configurações da conta, às vezes com act_ na frente - os dois jeitos servem.

2. No Hap: ligar a leitura do gasto

  1. 1

    Abra CRM > Configurações > Conta de anúncios da Meta.

  2. 2

    Em Conta de anúncios, cole o número da conta.

  3. 3

    Em Token de acesso, cole o token do usuário do sistema.

  4. 4

    Clique em Testar conexão. Deu certo quando aparece Conectado, com o nome da conta, a moeda e o fuso.

    A conexão com a conta de anúncios e o passo a passo para gerar o token
  5. 5

    Marque Ler o gasto desta conta e clique em Salvar.

  6. 6

    Clique em Ler agora para não esperar a primeira leitura automática.

Como a leitura funciona
QuandoO que o Hap lê
Primeira leituraAs últimas 8 semanas
Depois, a cada 6 horasOs últimos dias de novo, porque a Meta fecha o gasto com atraso
Reler 8 semanasAs 8 semanas inteiras outra vez - use depois de trocar a conta ou quando a Meta corrigir gasto antigo
Leitura desligada ou falhandoNada. O relatório usa o gasto real até o último dia lido e, depois dele, o orçamento rateado. Nunca vira gasto zero

3. Ligar cada anúncio ao criativo do Hap

O gasto lido é por anúncio. Ele entra no criativo que tem o mesmo Id do anúncio. No bloco Leitura, a tela mostra quanto do gasto já está em anúncios com criativo no Hap e lista os Anúncios com gasto e sem criativo.

O gasto lido, a parte que já tem criativo no Hap e os anúncios que ainda não têm

Para cada anúncio da lista, escolha um dos dois caminhos:

  1. 1

    Clique no id do anúncio para copiar. Em Campanhas e criativos, abra o criativo dele e cole no campo Id do anúncio. O gasto daquele anúncio passa a ser da peça.

  2. 2

    Ou cole o id da campanha da Meta no campo Código / UTM da campanha do Hap. O gasto dos anúncios dela que não têm criativo passa a ser daquela campanha.

4. API de Conversões: devolver o lead e a venda à Meta

Quando o lead que clicou no anúncio vira card, o Hap avisa a Meta (evento Lead). Quando o card é ganho, avisa de novo, com o valor do pedido (evento de compra). Com isso, a Meta passa a entregar o anúncio para gente parecida com quem compra, não só com quem clica.

O que vai e para onde
Como o lead chegouVai para a Meta?
Clique no link rastreado do Hap ou formulário do site, com a marca do anúncio (fbclid)Sim, para o conjunto de dados (pixel) desta tela, com telefone e e-mail criptografados
Anúncio de clique para o WhatsApp, no número oficialSim, para o conjunto de dados da conta do WhatsApp, com o token do próprio número (veja o aviso abaixo)
Só o código de rastreio no texto, sem clique registradoNão. Sem o clique, a Meta não tem como reconhecer quem é
Card criado à mão ou sem marca de anúncioNão

Regras que valem para todos: o envio sai a cada 10 minutos; a venda vai com o valor do pedido do ERP ou, sem pedido, com o valor do card - venda sem valor não vai; evento com mais de 7 dias a Meta não aceita.

5. Configurando a API de Conversões

  1. 1

    No Gerenciador de Eventos da Meta, abra Fontes de dados, escolha o conjunto de dados (pixel) do site e copie o id - só os números.

  2. 2

    No Hap, cole em Conjunto de dados (pixel) do clique do link.

  3. 3

    Em Token da API de Conversões, você pode deixar em branco - o Hap usa o token da leitura do gasto. Nesse caso, atribua também o conjunto de dados ao usuário do sistema na Meta. O mais simples é gerar um token só para isso: no Gerenciador de Eventos, abra o conjunto de dados > Configurações > API de Conversões > Gerar token de acesso, e cole aqui.

  4. 4

    No Gerenciador de Eventos, abra Testar eventos e copie o código de teste. Cole em Código de teste e clique em Salvar.

  5. 5

    Clique em Enviar evento de teste. O Hap manda um lead fictício, que aparece na tela Testar eventos da Meta.

    A API de Conversões: conjunto de dados, token, código de teste e os eventos enviados
  6. 6

    Deu certo? Apague o Código de teste, marque Enviar os eventos para a Meta e clique em Salvar.

6. Acompanhando os envios

À direita, os números dos últimos 30 dias: Enviados, Na fila, Recusados e Expirados. A lista mostra os últimos eventos, com o card, o tipo (Lead ou Venda com o valor) e a situação. Parar o mouse sobre a situação mostra a resposta da Meta.

7. O número oficial do WhatsApp

A conversa que nasce do anúncio de clique para o WhatsApp vai pela conta do WhatsApp do próprio número, não pelo conjunto de dados desta tela. Para isso, o número precisa de uma permissão de envio de eventos que a Meta libera para o aplicativo do Hap.

  1. 1

    Clique em Conferir WhatsApp oficial. O Hap busca (ou cria) o conjunto de dados da conta do WhatsApp de cada número oficial.

  2. 2

    Na tabela, cada número aparece como pronto ou como com problema, com o motivo.

Problemas comuns

  • O Testar conexão mostra "A Meta recusou" - são quatro causas possíveis. O número digitado é a Identificação do usuário do sistema, e não a da conta de anúncios. O token foi gerado sem a permissão ads_read. A conta de anúncios não foi atribuída ao usuário do sistema (confira a aba Ativos atribuídos). Ou o token foi colado pela metade.
  • Ao gerar o token, ads_read não aparece na lista de permissões - o aplicativo escolhido não tem o caso de uso de anúncios (API de Marketing). Adicione o caso de uso ao aplicativo em developers.facebook.com, ou use outro aplicativo do portfólio, e gere o token de novo.
  • Ao gerar o token, nenhum aplicativo aparece na lista - o usuário do sistema e o aplicativo precisam ser da mesma empresa na Meta. Crie um aplicativo do tipo Empresa ligado ao seu portfólio e atribua-o ao usuário do sistema (veja o passo a passo).
  • Liguei a leitura e o gasto não apareceu - a primeira leitura sai em até 15 minutos. Para não esperar, clique em Ler agora.
  • A tela diz "A última leitura falhou" - o token venceu ou o acesso foi retirado. Gere um token com validade Nunca e cole de novo. Até lá, o relatório usa o gasto real até o último dia lido e o orçamento rateado depois dele.
  • O gasto da conta é maior que o dos anúncios com criativo - há anúncio com gasto que não está cadastrado no Hap. Ele aparece em Anúncios com gasto e sem criativo: copie o id e cole no criativo.
  • Nenhum evento entra na fila da API de Conversões - só vai o card que chegou pelo clique (link rastreado, formulário do site ou anúncio de clique para o WhatsApp no número oficial). Card que chegou só pelo código no texto não tem clique para a Meta reconhecer.
  • A venda não foi para a Meta - o card ganho não tem valor (nem pedido no ERP, nem valor no card). Venda sem valor não é enviada.
  • Eventos marcados como "expirou" - o evento ficou mais de 7 dias sem sair (envio desligado, token recusado). A Meta não aceita evento com mais de 7 dias.
  • O evento de teste não aparece em Testar eventos - o código de teste do Hap não é o que está aberto no Gerenciador de Eventos, ou o conjunto de dados é outro. Salve antes de testar.

Artigos relacionados