Pular para o conteúdo principal

Solucionar problemas do conector do LinkedIn Ads

info

Beta

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Aprenda a solucionar problemas comuns com o conector de anúncios gerenciados do LinkedIn no Lakeflow Connect.

Erro: o access token está ausente, inválido, expirado ou revogado

Mensagem de erro:

The LinkedIn Ads API call '<api-call>' failed because the access token is missing, invalid, expired, or revoked.

Causa: O access token do LinkedIn que sustenta a conexão não é mais utilizável. Ele nunca foi válido, expirou ou foi revogado. O LinkedIn emite access tokens com uma vida útil de 60 dias e invalida os tokens existentes de um usuário para um aplicativo quando uma nova autorização solicita um conjunto de escopos diferente do anterior.

Solução: reautentique sua conexão com o LinkedIn Ads para gerar um novo token. Consulte Criar uma conexão com o LinkedIn Ads.

Erro: o access token não possui os escopos necessários.

Mensagem de erro:

The LinkedIn Ads API call '<api-call>' was denied. The access token is missing the required
scopes (e.g., r_ads, r_ads_reporting), or the user does not have access to the requested ad account.

Causa: O token é válido, mas o LinkedIn negou a solicitação. O conector solicita os escopos r_ads e r_ads_reporting durante a autorização, portanto, uma falha de escopo significa que eles não puderam ser concedidos. O LinkedIn não distingue uma falha de escopo de uma falha de permissão na conta de anúncios, portanto, qualquer uma das seguintes situações pode gerar esse erro:

  • A account autorizadora não tem acesso à API de publicidade do LinkedIn por meio da Marketing Developer Platform.
  • O usuário autorizador não possui nenhuma função na account de anúncios cujo namespace você está ingerindo.

soluções:

  1. Confirme se seu aplicativo do LinkedIn está aprovado para a API de Publicidade e, em seguida, autentique a conexão novamente. Consulte Configurar anúncios do LinkedIn como fonte de dados.
  2. Confirme se o usuário autorizador tem uma função em cada account de anúncio patrocinado da qual você realiza a ingestão.

Erro: o limite de requisições da API de anúncios do LinkedIn foi atingido.

Mensagem de erro:

The LinkedIn Ads API rate limit has been exhausted for the API call '<api-call>'.
Please retry the pipeline update after some time.

Causa: O LinkedIn limitou a taxa de transferência do conector, e as três tentativas automáticas de reconexão não removeram essa limitação.

Solução: Tente atualizar o pipeline novamente mais tarde. Se o erro se repetir, reduza a quantidade de dados que cada atualização solicita, seja restringindo lookback_window_days ou dividindo as tabelas em mais de um pipeline para que menos relatórios sejam executados simultaneamente.

Meus totais diários não correspondem à interface do usuário do Gerenciador de Campanhas do LinkedIn.

Causa: o conector avalia os limites de data do relatório em UTC, não no fuso horário da conta de anúncio. Se sua conta de anúncio gera relatórios em um fuso horário que não seja UTC, um determinado dia do calendário cobre um intervalo de horas diferente em cada sistema.

Solução: este comportamento não pode ser substituído. Considere o deslocamento UTC ao comparar os dois, ou agregue ao longo de um período mais longo onde o efeito de limite seja proporcionalmente menor.

A redução de sync_start_date não preencheu retroativamente meu relatório

Causa: Um relatório que já foi sincronizado é retomado a partir de seu próprio cursor confirmado, portanto, reduzir sync_start_date posteriormente não faz com que a história anterior seja lida novamente. Somente accounts ou campanhas que aparecem pela primeira vez começam a partir da nova data.

Solução: execute um refresh completo na tabela para reingerir o histórico a partir da nova data de início. Consulte Executar uma atualização de pipeline.