メインコンテンツまでスキップ

LinkedIn広告コネクタのトラブルシューティング

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

Lakeflow Connect でマネージド LinkedIn Ads コネクタの一般的なエラーをトラブルシューティングする方法を学習します。

エラー:アクセストークンが見つからないか、無効であるか、期限切れであるか、または取り消されています

エラーメッセージ:

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.

原因: トークンは有効ですが、LinkedInがリクエストを拒否しました。コネクタは認証中に r_ads および r_ads_reporting スコープをリクエストするため、スコープの失敗は、それらが許可されなかったことを意味します。LinkedInはスコープの失敗と広告アカウントの権限の失敗を区別しないため、以下のいずれかが原因でこのエラーが発生する可能性があります:

  • 承認アカウントは、Marketing Developer Platform を介した LinkedIn の Advertising API へのアクセス権を持っていません。
  • 承認ユーザーは、取り込み対象の名前空間を持つ広告アカウントに対してロールを持っていません。

ソリューション:

  1. LinkedInアプリが広告APIで承認されているか確認し、その後接続を再認証してください。「LinkedIn Ads をデータソースとして設定する」を参照してください。
  2. 承認ユーザーが、取り込み元のすべてのスポンサー広告アカウントに対してロールを持っていることを確認してください。

エラー:LinkedIn Ads APIの料金制限が使い果たされました

エラーメッセージ:

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回の自動再試行でもスロットルが解消されませんでした。

解決策: パイプラインの更新を後で再試行してください。エラーが繰り返される場合は、lookback_window_days を絞り込むか、テーブルを複数のパイプラインに分割して同時に実行されるレポートの数を減らすことで、各更新で要求されるデータ量を削減してください。

日次合計が LinkedIn Campaign Manager UI と一致しない

原因: コネクターは広告アカウントのタイムゾーンではなくUTCでレポート日の境界を評価します。広告アカウントがUTC以外のタイムゾーンで報告されている場合、ある暦日は各システムで異なる時間帯をカバーします。

ソリューション: この動作は上書きできません。両者を比較する際はUTCオフセットを考慮するか、境界効果が相対的に小さくなるようなより長い期間で集計してください。

sync_start_dateを下げてもレポートがバックフィルされませんでした

原因: すでに同期されたレポートは、独自のコミット済みカーソルから再開されるため、後から sync_start_date を下げても以前の履歴は再読み込みされません。初めて表示されるアカウントまたはキャンペーンのみが、新しい日付から開始されます。

ソリューション: テーブルで完全更新を実行し、新しい開始日から履歴を再取り込みします。パイプラインの更新を実行するを参照してください。