LinkedIn広告コネクタのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
Lakeflow Connect でマネージド LinkedIn Ads コネクタの一般的なエラーをトラブルシューティングする方法を学習します。
Error: the access token is missing, invalid, expired, or revoked
エラーメッセージ:
The LinkedIn Ads API call '<api-call>' failed because the access token is missing, invalid, expired, or revoked.
原因: 接続をサポートしている LinkedIn アクセストークンが使用できなくなっています。最初から無効であったか、有効期限が切れているか、または取り消されています。LinkedIn は有効期間が 60 日間のアクセストークンを発行します。また、新しい認証で以前とは異なるスコープセットが要求された場合、そのアプリに対するユーザーの既存のトークンは無効になります。
ソリューション: LinkedIn Ads 接続を再認証して、新しいトークンを発行します。「LinkedIn Ads 接続の作成」を参照してください。
エラー:アクセストークンに必要なスコープが不足しています
エラーメッセージ:
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.
Cause: The token is valid, but LinkedIn denied the request. The connector requests the r_ads and r_ads_reporting scopes during authorization, so a scope failure means they could not be granted. LinkedIn does not distinguish a scope failure from an ad-account permission failure, so either of the following can produce this error:
- 承認アカウントは、Marketing Developer Platform を介した LinkedIn の Advertising API へのアクセス権を持っていません。
- The authorizing user has no role on the ad account whose namespace you are ingesting.
ソリューション:
- Confirm that your LinkedIn app is approved for the Advertising API, then reauthenticate the connection. See Set up LinkedIn Ads as a data source.
- Confirm that the authorizing user has a role on every sponsored ad account you ingest from.
Error: the LinkedIn Ads API rate limit has been exhausted
エラーメッセージ:
The LinkedIn Ads API rate limit has been exhausted for the API call '<api-call>'.
Please retry the pipeline update after some time.
原因: LinkedIn がコネクタをスロットルし、コネクタの3回の自動再試行でもスロットルが解消されませんでした。
Solution: Retry the pipeline update later. If the error repeats, reduce how much data each update requests, either by narrowing lookback_window_days or by splitting the tables across more than one pipeline so fewer reports run concurrently.
日次合計が LinkedIn Campaign Manager UI と一致しない
Cause: The connector evaluates report date boundaries in UTC, not in the ad account's time zone. If your ad account reports in a non-UTC time zone, a given calendar day covers a different range of hours in each system.
Solution: This behavior cannot be overridden. Account for the UTC offset when you compare the two, or aggregate over a longer period where the boundary effect is proportionally smaller.
sync_start_dateを下げてもレポートがバックフィルされませんでした
Cause: A report that has already synced resumes from its own committed cursor, so lowering sync_start_date afterward does not re-read earlier history. Only accounts or campaigns appearing for the first time start from the new date.
ソリューション: テーブルで完全更新を実行し、新しい開始日から履歴を再取り込みします。パイプラインの更新を実行するを参照してください。