Ads Connector: testes e solução de problemas
O Ads Connector tem duas funções: trazer leads para dentro a partir do Google e da Meta, e enviar conversões de volta para fora. Antes de confiar nele, vale a pena comprovar as duas direções com seus próprios olhos — um lead de teste que realmente chega à REDA, e uma conversão de teste que realmente é reportada. Este artigo percorre os dois testes e depois entrega uma matriz de diagnóstico e correção para os problemas mais comuns: leads que nunca aparecem, conversões que nunca disparam, a chave geral silenciosamente desligada, uma desconexão que não conclui, e acesso ausente. Cada problema vem acompanhado da causa mais comum e da correção, para você sair rapidamente do "não está funcionando" para o "é por isso". Este artigo pressupõe apenas que sua conta de anúncios já foi configurada e conectada — se ainda não foi, comece pelo guia de configuração linkado ao final.
Acesso necessário. Testar e diagnosticar problemas é uma tarefa de administrador — o mesmo acesso usado para conectar e gerenciar contas de anúncios. Algumas correções (a chave geral de captura de leads, as configurações de site remoto, os conjuntos de permissões) são feitas pelo seu administrador do Salesforce.
Antes de testar
Um teste significativo precisa da configuração já em vigor. Confirme o seguinte primeiro, para que um teste malsucedido aponte para uma falha real, e não para uma etapa incompleta:
- A conta de anúncios existe na guia Ad Account, mostra Active e tem uma Connected Date.
- A captura de leads está ligada para sua plataforma (a configuração geral Meta / Google — veja a matriz de diagnóstico se tiver dúvidas).
- Para conversões, a conta de anúncios tem um Conversion Target definido (e, para a Meta, um Conversion Token). Veja Conversões de Circuito Fechado e Objetivo de Conversão.
Teste 1: comprove que um lead entra
O teste de entrada mais limpo é enviar seu próprio lead pelo formulário real e observar sua chegada à REDA. Tanto o Google quanto a Meta oferecem uma forma de enviar uma submissão de teste pelas próprias ferramentas de formulário, o que evita gastar orçamento de anúncios.
Teste 2: comprove que uma conversão dispara
O teste de saída é levar um lead capturado até a conversão e confirmar que a REDA o carimba como enviado. Você não envia nada manualmente — converter o lead é o gatilho.
Matriz de diagnóstico
Trabalhe de cima para baixo — as linhas anteriores são tanto as mais comuns quanto as mais baratas de verificar.
| Problema | Causa provável | Correção |
|---|---|---|
| Nenhum lead aparece de uma plataforma | A chave geral de captura de leads dessa plataforma está desligada. Há um ligar/desligar separado para Meta lead ads e para Google lead forms; se o da sua plataforma estiver desligado, nada é capturado. | Peça ao seu administrador para ligar a chave da sua plataforma e execute novamente o Teste 1. |
| Um único lead não chegou (os outros chegam) | A conta de anúncios está inativa, ou seu Page ID / Lead Webhook Key ou Webhook Base URL não corresponde à configuração do formulário, então o lead não pôde ser roteado até ela. | Abra a conta de anúncios: confirme que Active está marcado, e que o Page ID / Lead Webhook Key e o Webhook Base URL correspondem ao que o formulário aponta. |
| Leads chegam, mas sem atribuição de anúncio | O lead chegou à REDA mas não foi associado a uma conta de anúncios — geralmente por incompatibilidade da Webhook Key, ou porque os campos de atribuição não estão no seu layout de página, o que só faz parecer vazios. | Confirme se a Webhook Key vincula o formulário à conta de anúncios correta, e se os campos Ad Platform / Ad Account / Ad Campanha Id / Ad Form Id estão no layout do lead. |
| Conversão não disparou — Conversion Sent em branco | O registro não foi realmente marcado como convertido, então nada disparou. | Na edição Inquiry, marque o Lead como convertido; na edição Oportunidade, converta o Lead em uma Oportunidade. Confirme que o campo então se carimba. |
| Convertido, mas ainda assim nenhuma conversão enviada | A conta de anúncios não tem Conversion Target (ação do Google / dataset da Meta), então a REDA não tem onde reportar. | Defina o alvo: use Select Conversion Target para Google, ou informe o ID do dataset e o Conversion Token para Meta. Veja Closed-loop Conversions. |
| Conversão enviada, mas a plataforma nunca a contabiliza | Falta ao lead seu identificador de clique original (Web gclid / Web fbclid), então a plataforma não consegue associar a conversão de volta a um clique. | Verifique se o lead carrega o identificador de clique. Leads capturados sem um (por exemplo, digitados manualmente) não podem ser associados pela plataforma. |
| Disconnect Ad Account falha com uma referência de suporte | A etapa de desconexão precisa da configuração de site remoto REDA_Router para alcançar o serviço da REDA, e ela está ausente ou com o nome incorreto. A desconexão falha com segurança, então a conta permanece conectada. | Peça ao seu administrador para confirmar que a configuração de site remoto REDA_Router existe e tente novamente — é seguro executar a desconexão de novo. Cite a referência de LOG ao suporte se o problema persistir. |
| Botões ou a guia Ad Account não estão visíveis | Falta ao usuário o conjunto de permissões de integração de anúncios (ou, na edição que não traz um, o acesso equivalente pelo perfil), então a guia, os botões e os campos ficam ocultos. | Peça ao seu administrador para conceder o acesso de integração de anúncios. Veja Ads Connector Setup para o modelo de acesso. |
A chave de captura de leads
Uma configuração fica acima de tudo o mais neste conector: uma chave geral de ligar/desligar para a captura de leads, mantida separadamente para cada plataforma — uma para Meta lead ads, outra para Google lead forms. Quando a chave de uma plataforma está desligada, nenhum lead dela é capturado, não importa quão corretamente a conta de anúncios, o formulário e o webhook estejam configurados. É a coisa mais rápida de descartar e a mais fácil de esquecer, e é por isso que ela abre a matriz.
Por ser uma chave global, ela é gerenciada pelo seu administrador do Salesforce, não a partir do registro da conta de anúncios. Se uma plataforma inteira tiver ficado silenciosa — todos os leads, não só um — este é o primeiro lugar a verificar. Ligar a chave certa restaura a captura imediatamente; nenhuma reconexão é necessária.
Quando a desconexão não conclui
Desconectar uma conta de anúncios não é apenas uma marcação local — para a Meta, isso também libera a conexão da página no serviço de roteamento da REDA, para que a página possa se mover para outra organização. Essa liberação é o que ocasionalmente faz a desconexão falhar: ela depende de uma configuração de site remoto chamada REDA_Router, que concede à REDA permissão para alcançar seu próprio serviço. Sem ela, a chamada de liberação não pode sair.
O ponto importante é que a desconexão falha com segurança. Se a liberação não for bem-sucedida, a conta de anúncios permanece totalmente conectada em vez de terminar meio desconectada — nenhum lead é perdido silenciosamente. Você verá uma referência curta de LOG que pode citar ao suporte. Assim que a configuração de site remoto REDA_Router estiver confirmada como presente, tentar a desconexão de novo é totalmente seguro; ela simplesmente retoma de onde parou.
Quando o acesso é o problema
Se alguém não consegue ver a guia Ad Account, os botões de conectar/desconectar, ou os campos de anúncios em um lead, a causa é quase sempre acesso, não uma conexão quebrada. Gerenciar contas de anúncios exige o conjunto de permissões do conector, que concede a guia, os botões e o acesso de leitura aos campos de anúncios.
Duas nuances valem a pena conhecer. Primeiro, os campos de anúncios são concedidos como somente leitura por esse conjunto de permissões — o próprio conector os grava em segundo plano — então um administrador que precise editar uma conta de anúncios (por exemplo, para definir um Meta Conversion Target) precisa desse acesso de edição pelo perfil, não apenas pelo conjunto de permissões. Segundo, só a REDA One (OEM) traz um conjunto de permissões de Ads dedicado, REDA - Ads Integration. Na REDA no Sales Cloud (ISV) esse mesmo acesso à guia, ao registro e aos botões faz parte de REDA - Master Data - Admin, então atribua esse conjunto no lugar — não há nada a configurar à mão. De qualquer forma, se o acesso estiver faltando, é o seu administrador do Salesforce quem o concede.
Exemplo prático: os formulários silenciosos da Meta na Meridian Court
A Meridian Court relata que seus formulários de leads do Facebook e do Instagram pararam de repente de gerar leads, enquanto seus formulários do Google continuam funcionando. Seguindo a matriz de cima para baixo, o administrador começa pela chave geral — e descobre que a chave de captura de Meta lead ads tinha sido desligada durante uma alteração não relacionada. A chave do Google não foi tocada, e é exatamente por isso que o Google continuou funcionando.
Eles religam a chave da Meta e executam novamente o Teste 1: uma submissão de teste pela ferramenta de formulário da Meta chega como um Lead em poucos instantes, corretamente carimbada com sua conta de anúncios, campanha, formulário e Web fbclid. Com a captura restaurada, eles passam ao Teste 2 — convertem o lead de teste e confirmam que Conversion Sent se carimba com sua data e hora. Comprovadas as duas direções, a Meridian volta a funcionar normalmente sem uma única reconexão.
O que vem a seguir
- Ads Connector Setup — a configuração administrativa única, o modelo de acesso e os campos de layout que estas verificações pressupõem.
- Conversões de Circuito Fechado e Objetivo de Conversão — defina um Conversion Target e entenda como uma conversão dispara.
- Google Lead Connector — a configuração de entrada para os formulários do Google.
- Meta Lead Connector — a configuração de entrada para Facebook e Instagram, incluindo a movimentação de uma página.
- Ads Connector Overview — como as peças se encaixam.
Perguntas frequentes
Verifique se a captura de leads está ativada para aquela plataforma. Há uma chave geral de ligar/desligar para Meta e para Google, separadamente; se a da sua plataforma estiver desligada, nenhum lead é capturado, por melhor que esteja configurado o resto. Depois confirme que a conta de anúncios está Ativa e que seu Page ID / Lead Webhook Key e Webhook Base URL correspondem à configuração do seu formulário.
Abra o lead ou negócio convertido e verifique Conversion Sent. Se estiver em branco, a conversão não foi reportada. Confirme se o registro foi realmente marcado como convertido, se a conta de anúncios tem um Conversion Target definido, e se o lead carrega o identificador de clique original (Web gclid / Web fbclid) que permite à plataforma associá-lo de volta.
A desconexão falha com segurança — a conta de anúncios permanece conectada em vez de ficar parcialmente desconectada — e exibe uma referência de LOG para o suporte. A causa mais comum é uma configuração de site remoto REDA_Router ausente, que a etapa de desconexão precisa para alcançar o serviço da REDA. Peça ao seu administrador para confirmar que essa configuração existe e tente novamente; é seguro executar a desconexão de novo.
Sim — Meta e Google têm chaves independentes de captura de leads, então uma pode estar desligada enquanto a outra continua funcionando. Se uma plataforma inteira ficar silenciosa de uma vez, a chave geral é a primeira coisa a verificar.
Isso é uma questão de acesso, não de conexão quebrada. Gerenciar contas de anúncios exige o acesso de integração de anúncios do conector, que concede a guia, os botões e os campos de anúncios. Seu administrador do Salesforce concede esse acesso. Usuários finais que só visualizam leads não precisam dele — só precisam do acesso de leitura normal a Leads da REDA ou Leads padrão.
Isso foi útil?