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 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?
Abra as Configurações do Negócio
Vá parabusiness.facebook.com/settings. No menu da conta, é o item Configurações do Negócio (Business Settings).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.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.
Configurações do Negócio, menu Usuários
Embusiness.facebook.com/settings, na coluna da esquerda, abra Usuários (Users).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.Adicionar, e dê um nome ao usuário
Clique no botão azul Adicionar (Add). Use um nome que explique para que serve, por exemploImobiliQ Integração. Em função, escolha Administrador do sistema (Admin system user) e confirme.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.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.Gerar novo token
Ainda na tela do usuário do sistema, clique em Gerar novo token (Generate New Token).Escolha o aplicativo
Selecione o aplicativo do Business Manager. Se houver mais de um, use o que já está ligado ao seu pixel.Marque a permissão ads_management
Na lista de permissões, marqueads_management. É a única obrigatória. Marcarbusiness_managementjunto não atrapalha.Copie o token AGORA
O token começa comEAAe é 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.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.
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:
Abra o Gerenciador de Eventos
Embusiness.facebook.com/events_manager, escolha o seu conjunto de dados.Aba Testar eventos
Clique em Testar eventos (Test Events). A Meta mostra um código no formatoTEST12345.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?
| Evento | Quando dispara |
|---|---|
| Lead | Quando um lead novo entra no CRM, por qualquer origem. |
| QualifiedLead | Quando o lead é marcado como qualificado pelo corretor. |
| Purchase | Quando 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
| Sintoma | Causa provável |
|---|---|
| O assistente recusa o token | O 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 chega | Falta atribuir o conjunto de dados como ativo do usuário do sistema (passo 5). |
| Não encontro Usuários do sistema | Seu acesso ao Business Manager não é de administrador. |
| Eventos aparecem só em Testar eventos | O código de teste ficou preenchido. Apague-o para os eventos valerem de verdade. |