メタ広告の取り込みに関するトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。「Databricks プレビューの管理」を参照してください。
Lakeflow Connect での Meta Ads の取り込みが失敗した場合は、コネクターエラークラスを使用して原因と解決策を特定します。次のガイダンスでは、認証、API の制限、アクセス、Meta サービスのエラーについて説明します。
すべてのマネージド取り込みパイプラインに適用される一般的なトラブルシューティングガイダンスについては、マネージド取り込みパイプラインのトラブルシューティングを参照してください。
認証に失敗しました
問題：
接続を作成またはパイプラインを実行するときに認証エラーが発生します。
解決：
- 取り込み元の広告アカウントにアクセスできるMetaアカウントでサインインしていることを確認してください。
- サインイン時にプロンプトが表示されたら、要求されたすべての権限 (
ads_read、ads_management、business_management、pages_read_engagement、pages_show_list) を付与してください。 - 接続を再承認して、サインインフローを再度完了します。
レート制限を超えました
問題：
パイプラインがMETA_ADS_RATE_LIMIT_EXCEEDEDで失敗します。
コネクタは、レート制限エラーを自動的に再試行します。このエラーは、それらの再試行を使い果たしたときに表示されます。
解決：
- Meta API の制限が Reset されるのを待ちます。
- パイプラインを再試行します。
- 並行して取り込まれるテーブルの数を減らすか、パイプラインのスケジュールの頻度を減らします。
- このエラーが頻発する場合は、Meta からのフルアクセス（Full Access）の取得を検討してください（Databricks 管理の OAuth アプリを使用していない場合）。
Metaサポートに連絡する場合は、エラーメッセージからFacebookトレースIDを含めてください。
要求されたデータ制限を超えました
問題：
パイプラインがMETA_ADS_REQUESTED_DATA_LIMIT_EXCEEDEDで失敗します。
APIリクエストがサーバーでの処理にとって大きすぎるか複雑すぎる場合、Metaはこのエラーを返します。これは、リクエストが多くのフィールドを選択している場合や、Insightsレポートで大量の結果を生成するフィールドと内訳に長い日付範囲が組み合わされている場合に発生する可能性があります。
解決：
- パイプラインを再試行します。
- インサイトレポートでこのエラーが持続する場合は、内訳の数を減らすか、より新しい開始日を設定してください。
- 既存の
ad_insightsテーブルのパラメーターを変更する場合は、テーブルでフル更新を実行します。
無効なアクセス
問題：
パイプラインがMETA_ADS_INVALID_ACCESS_ERRORで失敗します。
このエラーは、要求されたオブジェクトが存在しない場合、権限の欠落のためにロードできない場合、または要求された操作をサポートしていない場合に発生します。
解決：
- オブジェクトまたは広告アカウントの ID が正しいことを確認します。
- 認証を行うユーザーが、要求された広告アカウントへのアクセス権を持っていることを確認します。
- 認証を行うユーザーが、サインイン時に
ads_readやads_managementを含む必要な権限を付与したことを確認します。 - 接続を再承認し、パイプラインを再試行してください。
アクセス可能な広告アカウントはありません
問題：
パイプラインがMETA_ADS_EMPTY_AD_ACCOUNTS_LISTで失敗します。
このエラーは、認証されたユーザーがどの広告アカウントにもアクセスできない場合に発生します。
解決：
- Metaビジネスマネージャで、認証ユーザーに少なくとも1つの広告アカウントへのアクセス権を付与します。
- 接続を再承認します。
- パイプラインを再試行します。
未確認のMetaユーザーアカウント
問題：
パイプラインがMETA_ADS_UNCONFIRMED_USER_ERRORで失敗します。
このエラーは、アクセストークンに関連付けられているMetaユーザーアカウントが確認されていない場合に発生します。
解決：
- Eメールや本人確認など、Meta で必要な確認ステップを完了させます。
- 接続を再承認します。
- パイプラインを再試行します。
Meta サービス利用不可
問題：
パイプラインがMETA_ADS_SERVICE_UNAVAILABLE_ERRORで失敗します。
コネクタは、認識された一時的なサービスエラーを自動的に再試行します。このエラーは、それらの再試行回数を使い果たしたときに表示されます。
解決：
- しばらく待ってからパイプラインを再試行してください。
- エラーが解決しない場合は、Metaサポートにお問い合わせいただき、エラーメッセージに含まれるFacebookトレースIDをお知らせください。
知見の開始日が古すぎます
問題：
パイプラインがMETA_ADS_INSIGHTS_START_DATE_TOO_OLDで失敗します。
設定された知見 start_date がサポートされている履歴の範囲外の場合に、このエラーが発生します。
解決：
start_date をより新しい日付に設定します。既存の ad_insights テーブルの start_date を変更した場合は、そのテーブルのフル更新を実行してください。それ以外の場合は、パイプラインを再試行してください。サポートされている範囲については、開始日を参照してください。
知見のパラメーターが変更されました
問題：
パイプラインがMETA_ADS_PARAMETERS_CHANGEDで失敗します。
このエラーは、既存の ad_insights テーブルのパラメーターが変更されたときに発生します。
解決：
影響を受けるテーブルに対してフルリフレッシュを実行します。
その他の Meta API のエラー
問題：
パイプラインがMETA_ADS_SOURCE_API_ERRORで失敗します。
このエラーは、Meta API のレスポンスがより詳細なエラーに一致しない場合に発生します。エラーメッセージには、Facebook トレース ID が含まれます。
解決：
- パイプライン イベント log で基になる Meta エラーを確認し、Meta の Graph API エラー処理のドキュメントの修復手順に従います。
- Metaサポートに連絡する場合は、エラーメッセージからFacebookトレースIDを含めてください。