Pular para o conteúdo principal
Última atualização em

Solução de problemas na ingestão de Meta Ads

info

Beta

O conector Meta Ads está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

Este artigo descreve problemas comuns com o conector de ingestão de Meta Ads no Databricks LakeFlow Connect e como resolvê-los.

Solução de problemas pipeline em dutos​

Se um pipeline falhar durante a execução, clique na etapa que falhou e confirme se a mensagem de erro fornece informações suficientes sobre a natureza do erro.

Você também pode verificar e download os logs cluster na página de detalhes pipeline , clicando em Atualizar detalhes no painel direito e, em seguida, em Logs . Analise os logs em busca de erros ou exceções.

A autenticação falhou.​

Emitir:

Você recebe um erro de autenticação ao criar uma conexão ou executar um pipeline.

Resolução:

  1. Verifique se seu aplicativo Meta está configurado corretamente no Portal do Desenvolvedor Meta.
  2. Confirme se o ID do aplicativo e a chave secreta do aplicativo foram inseridos corretamente na conexão.
  3. Verifique se o URI de redirecionamento OAuth está configurado corretamente nas configurações do aplicativo Meta.
  4. Verifique se o aplicativo Meta possui as permissões necessárias (ads_read, ads_management, business_management).
  5. Se o erro persistir, tente excluir e recriar a conexão.

Limite de taxa excedido​

Emitir:

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: RATE_LIMIT_EXCEEDED.

Isso ocorre quando você atinge o limite de taxa API em sua account Meta Ads.

Resolução:

  1. Aguarde até que seus limites API sejam redefinidos (normalmente 1 hora).
  2. Tente novamente o pipeline.
  3. Considere reduzir a frequência de programação do seu pipeline .
  4. Considere dividir um grande oleoduto em vários oleodutos menores.

Combinação de quebra inválida​

Emitir:

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: INVALID_PARAMETER. Invalid breakdown combination.

Isso ocorre quando você configura uma combinação inválida de quebra ou quebra de ação para o objeto ad_insights .

Resolução:

  1. Consulte a documentação API de compatibilidade para obter informações sobre combinações de quebra válidas.
  2. Atualize a configuração do seu pipeline para usar uma combinação de decomposição válida.
  3. Tente novamente o pipeline.

Permissões insuficientes​

Emitir:

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: INSUFFICIENT_PERMISSIONS.

Isso ocorre quando o usuário que está tentando se autenticar não possui permissões suficientes para acessar os dados solicitados.

Resolução:

  1. Verifique se o aplicativo Meta possui as permissões necessárias no Portal do Desenvolvedor Meta.
  2. Confirme se o usuário que está se autenticando tem acesso à conta de anúncios que você está tentando importar.
  3. Verifique se o aplicativo Meta concluiu o processo de revisão, caso necessário.
  4. Reautorize a conexão, se necessário.

access tokenexpirado​

Emitir:

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: TOKEN_EXPIRED.

Isso ocorre quando o access token OAuth expira.

Resolução:

  1. Edite a conexão no Explorador de Catálogo.
  2. Reautorize a conexão clicando em Autenticar .
  3. Tente novamente o pipeline.

Os tokens de gerenciamento do conector refresh automaticamente, mas, em alguns casos, pode ser necessário reautorizar a conexão manualmente.

account de anúncios não encontrada​

Emitir:

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: ACCOUNT_NOT_FOUND.

Isso ocorre quando o ID account de anúncios especificado não existe ou o usuário que está se autenticando não tem acesso a ela.

Resolução:

  1. Verifique se o ID account anúncios na configuração pipeline está correto.
  2. Confirme se o usuário que está se autenticando tem acesso à account de anúncios no Meta Business Manager.
  3. Verifique se a account de anúncios não foi excluída ou desativada.

Dados incompletos de insights de anúncios​

Emitir:

A tabela ad_insights contém dados ausentes ou incompletos para datas recentes.

Resolução:

Este é o comportamento esperado. O objeto ad_insights usa janelas de atribuição para account eventos de conversão atrasados. Os dados para datas recentes podem estar incompletos até que o período de atribuição se feche (sete dias para atribuição de cliques, um dia para atribuição de view ).

O conector ingere automaticamente os dados atualizados na execução subsequente pipeline . Nenhuma ação é necessária.

Objeto ou campo não encontrado​

Emitir:

Não foi possível encontrar o objeto ou campo esperado nos dados recebidos.

Resolução:

  1. Verifique se o nome do objeto ou do campo está correto. Os nomes de objetos e campos diferenciam maiúsculas de minúsculas.
  2. Verifique se o usuário que está se autenticando tem permissão para acessar o objeto ou campo.
  3. Confirme se o objeto ou campo é compatível com o conector. Consulte a referência do conector de ingestão de Meta Ads para obter uma lista de objetos compatíveis.
  4. Alguns campos podem estar disponíveis apenas com permissões específicas ou versões da API.

Tempo limite do pipeline​

Emitir:

O pipeline atinge o tempo limite durante a execução.

Resolução:

  1. Verifique se você está ingerindo uma grande quantidade de dados. Considere dividir o pipeline em oleodutos menores.
  2. Verifique se seus limites de taxa da Meta API não foram excedidos.
  3. Tente novamente o pipeline. Algumas interrupções de tempo são transitórias.

Se o problema persistir, abra um chamado de suporte.

Próximos passos​