Documentação

Conectar a Meta (Conversions API)

A conexão pede duas coisas: o Pixel ID e um token de acesso permanente, gerado no Business Manager por um usuário do sistema. O token não sai do Gerenciador de Anúncios nem do seu perfil pessoal, e é por isso que quase todo mundo trava nesta etapa. Abaixo está cada clique, na ordem.

Para que serve essa conexão?

Sem ela, a Meta só sabe quem clicou no anúncio. Com ela, o ImobiliQ devolve o que aconteceu depois: quem virou lead qualificado e quem fechou negócio. É isso que faz a campanha parar de procurar clique e passar a procurar gente parecida com quem realmente comprou.

O nome dos menus muda
A Meta renomeia essas telas com frequência, e o mesmo lugar aparece como Business Manager, Gerenciador de Negócios, Business Settings ou Configurações do Negócio. Os nomes abaixo estão em português e inglês; se o seu não bater exatamente, procure pelo termo em inglês.

O que eu preciso ter antes de começar?

  • Acesso de administrador ao Business Manager onde está a conta de anúncios. Acesso de anunciante não basta: a tela de usuários do sistema não aparece.
  • O pixel (hoje chamado de conjunto de dados) já criado e recebendo eventos do site.
  • Um aplicativo cadastrado no Business Manager.

Onde encontro o Pixel ID?

  1. Abra as Configurações do Negócio

    Vá para business.facebook.com/settings. No menu da conta, é o item Configurações do Negócio (Business Settings).
  2. Fontes de dados, depois Conjuntos de dados

    Na coluna da esquerda, abra Fontes de dados (Data Sources) e clique em Conjuntos de dados (Datasets). Em contas antigas o nome ainda é Pixels.
  3. Copie o número embaixo do nome

    Selecione o conjunto de dados que o seu site usa. O identificador é o número de 15 a 16 dígitos que aparece logo abaixo do nome. É ele que vai no campo Pixel ID do ImobiliQ.

Como gero o token de acesso permanente?

Este é o passo que trava a maioria das pessoas. O token da Conversions API não é o token que aparece no Gerenciador de Eventos: aquele expira. O que serve é o de um usuário do sistema, que não expira e não depende de ninguém continuar na empresa.

  1. Configurações do Negócio, menu Usuários

    Em business.facebook.com/settings, na coluna da esquerda, abra Usuários (Users).
  2. Clique em Usuários do sistema

    É o terceiro item, abaixo de Pessoas e Parceiros. Em inglês, System Users. Se este item não aparece para você, o seu acesso não é de administrador.
  3. Adicionar, e dê um nome ao usuário

    Clique no botão azul Adicionar (Add). Use um nome que explique para que serve, por exemplo ImobiliQ Integração. Em função, escolha Administrador do sistema (Admin system user) e confirme.
  4. Atribua os ativos: a conta de anúncios

    Com o usuário do sistema selecionado, clique em Adicionar ativos (Add Assets). Escolha Contas de anúncios, marque a conta que roda as campanhas e ative o Controle total (Manage campaigns). Salve.
  5. Atribua também o conjunto de dados

    Repita o passo anterior escolhendo Conjuntos de dados (ou Pixels, nas contas antigas) e marque o mesmo conjunto de dados do Pixel ID que você copiou. Sem este ativo, o token é aceito mas os eventos são recusados depois, o que é bem mais difícil de descobrir.
  6. Gerar novo token

    Ainda na tela do usuário do sistema, clique em Gerar novo token (Generate New Token).
  7. Escolha o aplicativo

    Selecione o aplicativo do Business Manager. Se houver mais de um, use o que já está ligado ao seu pixel.
  8. Marque a permissão ads_management

    Na lista de permissões, marque ads_management. É a única obrigatória. Marcar business_management junto não atrapalha.
  9. Copie o token AGORA

    O token começa com EAA e é longo. Ele aparece uma única vez: ao fechar a janela, não há como vê-lo de novo, só gerar outro. Copie antes de sair da tela.
  10. Cole no ImobiliQ

    No ImobiliQ, vá em Configurações, Integrações, Meta Conversions API e siga o assistente: Pixel ID no passo 1, este token no passo 2.
Onde o token fica guardado
O token é gravado criptografado e nunca é exibido de volta, nem para você nem para outros usuários da imobiliária. Se precisar trocar, gere um novo na Meta e refaça o assistente.

Como sei que funcionou?

O assistente do ImobiliQ tem um passo de teste que envia um evento de verificação. Para acompanhar do lado da Meta:

  1. Abra o Gerenciador de Eventos

    Em business.facebook.com/events_manager, escolha o seu conjunto de dados.
  2. Aba Testar eventos

    Clique em Testar eventos (Test Events). A Meta mostra um código no formato TEST12345.
  3. Cole o código no passo 3 do assistente

    Com o código preenchido, o evento de teste aparece nessa tela em poucos segundos. Depois de validar, apague o código: com ele preenchido, os eventos entram como teste e não contam para a otimização das campanhas.

Quais eventos o ImobiliQ envia?

EventoQuando dispara
LeadQuando um lead novo entra no CRM, por qualquer origem.
QualifiedLeadQuando o lead é marcado como qualificado pelo corretor.
PurchaseQuando a venda é registrada, com o valor do negócio.

Os dados pessoais vão com o embaralhamento (hash) exigido pela Meta. O conteúdo das conversas nunca é enviado.

Erros comuns nesta etapa

SintomaCausa provável
O assistente recusa o tokenO token precisa começar com EAA. Se você copiou do Gerenciador de Eventos, é o token errado: refaça pelo usuário do sistema.
Token aceito, mas nenhum evento chegaFalta atribuir o conjunto de dados como ativo do usuário do sistema (passo 5).
Não encontro Usuários do sistemaSeu acesso ao Business Manager não é de administrador.
Eventos aparecem só em Testar eventosO código de teste ficou preenchido. Apague-o para os eventos valerem de verdade.