Erros Comuns de Conexão
As APIs de plataformas de anúncios são rigorosas. Se uma senha for alterada, uma conta for sinalizada ou um nível de permissão for rebaixado, a plataforma rejeitará imediatamente as solicitações para extrair dados.
Diferente de ferramentas legadas que falham silenciosamente ou fornecem uma mensagem genérica de “Ocorreu um erro”, o Metric Might mostra exatamente o que a API da plataforma de anúncios reportou.
Se a sua consulta falhar ou uma atualização agendada exibir um triângulo de aviso vermelho (⚠), isso é quase sempre devido a um dos problemas comuns abaixo.
1. “Failed to Fetch” ou Erros de Rede (Bloqueadores de Anúncios)
Como o Metric Might executa consultas diretamente do front-end do seu navegador, o seu navegador se comunica diretamente com graph.facebook.com, googleads.googleapis.com, etc.
Se você tiver um bloqueador de anúncios agressivo instalado (como uBlock Origin, Ghostery ou usar o Brave Browser), ele pode interceptar e bloquear essas solicitações de API, presumindo que sejam scripts de rastreamento.
Como corrigir isso:
- Desative seu bloqueador de anúncios ou “Shields” (Escudos) especificamente para
app.metricmight.comedocs.google.com(se estiver usando a extensão para Sheets). - O Metric Might não veicula anúncios nem vende os seus dados; adicionar nosso domínio à lista de permissões (whitelist) simplesmente permite que seu navegador se comunique com as APIs de relatórios.
2. “Token Expired” ou “Authentication Failed”
Quando você conecta uma fonte de dados, a plataforma de anúncios dá ao Metric Might um “token” seguro para acessar seus dados. Esses tokens expiram rotineiramente por motivos de segurança.
- Meta (Facebook) e TikTok: Os tokens costumam expirar após 60 a 90 dias, ou imediatamente se você alterar sua senha ou ativar a autenticação de dois fatores (2FA).
- Google: Os tokens raramente expiram, a menos que você revogue o acesso explicitamente nas configurações de segurança da sua Conta do Google.
Como corrigir isso:
- Navegue até a aba Connections no menu principal à esquerda.
- Localize a fonte de dados que está falhando.
- Clique no menu de três pontos (⋮) ao lado da fonte e selecione Sign In Again.
- Faça login novamente para atualizar o token. Suas consultas voltarão a funcionar instantaneamente.
3. “Permission Denied” ou “Insufficient Access”
Se você conseguir autenticar a fonte de dados com sucesso, mas uma consulta específica falhar com um erro de permissão, sua conta de usuário não tem mais o nível de acesso necessário para a Conta de Anúncios (Ad Account) desse cliente específico.
Isso geralmente acontece quando um cliente de agência remove o seu acesso no Business Manager dele, ou se sua função de usuário (user role) for rebaixada.
Como corrigir isso:
- Faça login diretamente na interface de usuário da plataforma de anúncios (ex: Meta Business Manager ou Google Ads MCC).
- Verifique se o seu endereço de e-mail ainda tem acesso pelo menos de Analista (Analyst) ou Somente Leitura (Read-Only) para o ID da Conta de Anúncios específica que você está tentando consultar.
- Se você não tiver acesso na interface da plataforma, o Metric Might não conseguirá extrair os dados. Você deve pedir ao cliente para restaurar suas permissões.
4. “Rate Limit Exceeded” ou “Too Many Requests”
Plataformas de anúncios limitam estritamente a quantidade de dados que você pode extrair em um período específico. Se você tiver dezenas de consultas pesadas agendadas para rodar no mesmo minuto, a plataforma de anúncios (especialmente LinkedIn ou TikTok) pode bloquear temporariamente as solicitações.
Como corrigir isso:
- Consultas manuais: Aguarde 60 segundos e clique em Apply novamente. O bloqueio geralmente é temporário.
- Consultas agendadas: O backend do Metric Might gerencia as atualizações agendadas automaticamente. Se você notar falhas persistentes de limite de taxa (rate limit) em vários relatórios agendados, entre em contato com o suporte — isso pode indicar um problema que podemos ajudar a resolver do nosso lado.
Se você atualizou sua conexão, desativou seu bloqueador de anúncios e verificou suas permissões na plataforma de anúncios, mas a consulta ainda falha, queremos saber sobre isso.
Vá para Contact Support e envie-nos uma mensagem!
O Que Vem a Seguir?
- Por Que Meus Dados Não Batem? (Solução de problemas de diferenças de fuso horário e janela de atribuição)
- Limites de Conta Explicados (Entendendo exatamente o que conta como uma “Conta” em diferentes fontes de dados)
