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

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

info

Beta

Este recurso 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.

Esta página descreve problemas comuns com o conector de ingestão de Meta Ads no Databricks LakeFlow Connect e como resolvê-los.

Para obter orientação geral sobre solução de problemas que se aplica a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.

A autenticação falhou.​

Emitir:

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

Resolução:

  1. Confirme se você fez login com uma conta Meta que tenha acesso às contas de anúncios das quais deseja fazer a ingestão.
  2. Quando solicitado durante o login, conceda todas as permissões solicitadas (ads_read, ads_management, business_management, pages_read_engagement, pages_show_list).
  3. Reautorize a conexão para concluir o fluxo de início de sessão novamente.
  4. 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. Confirme se o usuário que está se autenticando tem acesso à conta de anúncios que você está tentando importar.
  2. Verifique se o usuário que está se autenticando concedeu todas as permissões solicitadas durante o login.
  3. 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 configurado seja encerrado.

O conector ingere automaticamente esses dados na execução subsequente pipeline . Nenhuma ação é necessária. Para configurar a janela de atribuição, consulte Janelas de atribuição.

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.

Recursos adicionais​

Nesta página