Conectar Plataformas (OAuth)

Autorize Meta e/ou Google para rastrear e enviar conversões

O OAuth é o sistema de autorização que permite à Leaper acessar suas contas de anúncios de forma segura. Cada plataforma (Meta e Google) tem propósitos e consequências específicas quando conectada ou desconectada.

Atenção: OAuth pode expirar! Meta expira a cada 60-90 dias, Google pode expirar por inatividade. Verifique periodicamente se as conexões ainda estão ativas.

Atenção: Se você mudar a senha do Facebook ou Google, o OAuth será invalidado e precisará reconectar.

Atenção: Usar conta pessoal em vez de conta de administrador pode resultar em permissões insuficientes.

O que é OAuth e por que é necessário?

OAuth é um protocolo de autorização seguro. Em vez de você informar sua senha, você autoriza a Leaper a acessar recursos específicos da sua conta. Isso é necessário para:

Buscar informações sobre suas campanhas, conjuntos e anúncios ativos
Identificar de qual anúncio cada lead veio (para campanhas de mensagem no Meta)
Enviar eventos de conversão de volta para as plataformas
Permitir que as plataformas otimizem suas campanhas com base nas conversões reais

Conectar Meta Ads (Facebook/Instagram)

A conexão com o Meta permite rastrear campanhas de Facebook e Instagram:

1Acesse Configurar > Meta AdsNo menu lateral, vá em Configurar e depois em Meta Ads.
2Clique no botão 'Conectar com Facebook'Um popup abrirá pedindo login no Facebook. Use a conta que tem acesso ao Business Manager.
3Selecione as permissõesO Facebook mostrará quais permissões a Leaper precisa. Aceite todas para funcionamento completo.
4Selecione o Business ManagerSe você tem acesso a múltiplos Business Managers, selecione o correto para esta empresa.
5Confirme a conexãoApós autorizar, você voltará para a Leaper e verá o status 'Conectado' com o nome da conta.

Conectar Google Ads

A conexão com o Google permite enviar conversões para Google Ads:

1Acesse Configurar > Google AdsNo menu lateral, vá em Configurar e depois em Google Ads.
2Clique no botão 'Conectar com Google'Um popup abrirá pedindo login na conta Google. Use a conta que tem acesso à conta de anúncios.
3Autorize o acessoO Google mostrará quais permissões a Leaper precisa. Aceite para permitir o envio de conversões.
4Confirme a conexãoApós autorizar, você voltará para a Leaper e verá o status 'Conectado'.

Consequências de cada OAuth desconectado

Entenda exatamente o impacto de não ter cada plataforma conectada:

OAuth META desconectado → Leads de campanhas de MENSAGEM chegam SEM informação de campanha, conjunto e anúncio. Você verá o lead mas não saberá de qual anúncio veio.
OAuth META desconectado → NÃO consegue enviar conversões para o Meta. Suas campanhas não otimizam.
OAuth GOOGLE desconectado → NÃO consegue enviar conversões para o Google Ads. O ROAS não é calculado automaticamente.
Ambos desconectados → Leads chegam mas você não consegue atribuir a campanhas nem enviar conversões.

Requisitos de permissão

Para que o OAuth funcione corretamente, você precisa ter as permissões adequadas:

Meta: Acesso de Administrador ou Anunciante ao Business Manager e às contas de anúncio
Meta: Acesso ao WhatsApp Business (para campanhas de mensagem)
Google: Acesso de Administrador ou Padrão à conta de anúncios
Google: Se a conta está em um MCC, precisa ter acesso ao MCC também

Dica: Use uma conta que seja administradora do Business Manager (Meta) para ter todas as permissões necessárias.

Dica: Se a empresa tem múltiplas contas de anúncio, certifique-se de selecionar a conta correta durante a autorização.

Dica: Configure lembretes para verificar o status das conexões a cada 30 dias.

Dica: Se você gerencia contas de clientes, peça para o cliente autorizar diretamente ou adicione sua conta como administrador no Business Manager dele.

Problemas comuns

Popup de autorização não abre ou fecha imediatamente: Verifique se o bloqueador de popups está desativado para o site da Leaper. Tente em outro navegador ou em aba anônima.
Erro 'Permissão negada' ou 'Acesso insuficiente': Você não tem permissões adequadas na conta. Peça para o administrador da conta adicionar você com nível de acesso apropriado (Anunciante ou Administrador).
Status mostra 'Conectado' mas não funciona: O token pode ter expirado. Desconecte e conecte novamente para renovar a autorização.
Não aparece o Business Manager correto na lista: A conta usada não tem acesso a esse Business Manager. Use outra conta ou peça para ser adicionado ao BM correto.
Leads chegam mas sem dados de campanha/conjunto/anúncio: Isso indica que o OAuth do Meta não está funcionando corretamente. Desconecte, reconecte e verifique se todas as permissões foram aceitas.
Google mostra erro 'Conta MCC necessária': Sua conta de anúncios está dentro de um MCC (conta de gerenciador). Você precisa informar tanto o Account ID quanto o MCC ID nas configurações.