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.

When Meta Ads ingestion in Lakeflow Connect fails, use the connector error class to identify the cause and resolution. The following guidance covers authentication, API limits, access, and Meta service errors.

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.

Limite de taxa excedido​

Emitir:

The pipeline fails with META_ADS_RATE_LIMIT_EXCEEDED.

O conector repete automaticamente erros de limite de taxa. Esse erro aparece quando essas tentativas são esgotadas.

Resolução:

  1. Aguarde o reset dos seus limites da API do Meta.
  2. Tente novamente o pipeline.
  3. Reduza o número de tabelas ingeridas em paralelo ou reduza a frequência do schedule do pipeline.
  4. Se você encontrar esse erro com frequência, considere solicitar acesso completo da Meta (se você não estiver usando o aplicativo OAuth gerenciado pela Databricks).

Se você entrar em contato com o suporte da Meta, inclua o ID de rastreamento do Facebook da mensagem de erro.

Limite de dados solicitados excedido​

Emitir:

The pipeline fails with META_ADS_REQUESTED_DATA_LIMIT_EXCEEDED.

A Meta retorna esse erro quando uma solicitação de API é muito grande ou complexa para seus servidores processarem. Isso pode acontecer quando uma solicitação seleciona muitos campos ou quando um relatório de percepções combina um grande intervalo de datas com campos e detalhamentos que produzem um resultado grande.

Resolução:

  1. Tente novamente o pipeline.
  2. If the error persists for an percepções report, reduce the number of breakdowns or configure a more recent começar date.
  3. Se você alterar os parâmetros de uma tabela ad_insights existente, execute um refresh completo na tabela.

Acesso inválido​

Emitir:

The pipeline fails with META_ADS_INVALID_ACCESS_ERROR.

Esse erro ocorre quando o objeto solicitado não existe, não pode ser carregado devido a permissões ausentes ou não oferece suporte à operação solicitada.

Resolução:

  1. Verifique se o ID do objeto ou da conta de anúncios está correto.
  2. Confirme se o usuário em autenticação tem acesso à conta de anúncios solicitada.
  3. Confirme se o usuário que está se autenticando concedeu as permissões necessárias durante o login, incluindo ads_read e ads_management.
  4. Reauthorize the connection and retry the pipeline.

No accessible ad accounts​

Emitir:

The pipeline fails with META_ADS_EMPTY_AD_ACCOUNTS_LIST.

This error occurs when the authenticated user can't access any ad accounts.

Resolução:

  1. No Meta Business Manager, conceda ao usuário de autenticação acesso a pelo menos um ad account.
  2. Reautorize a conexão.
  3. Tente novamente o pipeline.

Unconfirmed Meta user account​

Emitir:

The pipeline fails with META_ADS_UNCONFIRMED_USER_ERROR.

This error occurs when the Meta user account associated with the access token isn't confirmed.

Resolução:

  1. Conclua os passos de confirmação necessários no Meta, como verificação de email ou de identidade.
  2. Reautorize a conexão.
  3. Tente novamente o pipeline.

Serviço Meta indisponível​

Emitir:

The pipeline fails with META_ADS_SERVICE_UNAVAILABLE_ERROR.

O conector repete automaticamente erros de serviço transitórios reconhecidos. Este erro aparece quando essas tentativas são esgotadas.

Resolução:

  1. Aguarde e tente executar o pipeline novamente mais tarde.
  2. Se o erro persistir, entre em contato com o suporte da Meta e inclua o ID de rastreamento do Facebook da mensagem de erro.

A data de início das percepções é muito antiga​

Emitir:

The pipeline fails with META_ADS_INSIGHTS_START_DATE_TOO_OLD.

This error occurs when the configured percepções start_date is outside the supported historical range.

Resolução:

Set start_date to a more recent date. If you change start_date for an existing ad_insights table, run a full refresh on the table. Otherwise, retry the pipeline. See Start date for the supported range.

Parâmetros de percepções alterados​

Emitir:

The pipeline fails with META_ADS_PARAMETERS_CHANGED.

Este erro ocorre quando os parâmetros para uma tabela ad_insights existente são alterados.

Resolução:

Execute um full refresh na tabela afetada.

Outros erros da API do Meta​

Emitir:

The pipeline fails with META_ADS_SOURCE_API_ERROR.

Esse erro ocorre quando uma resposta da API do Meta não corresponde a um erro mais específico. A mensagem de erro inclui um ID de rastreamento do Facebook.

Resolução:

  1. Revise o erro subjacente da Meta no log de eventos do pipeline e siga a remediação na documentação de tratamento de erros da API Graph da Meta.
  2. Se você entrar em contato com o suporte da Meta, inclua o ID de rastreamento do Facebook da mensagem de erro.

Recursos adicionais​

Nesta página