メタ広告の取り込みに関するトラブルシューティング

備考

ベータ版

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

この記事では、 Databricks LakeFlow Connectの Meta Ads 取り込みコネクタに関する一般的な問題とその解決方法について説明します。

一般的なパイプラインのトラブルシューティング

実行中にパイプラインが失敗した場合は、失敗したステップをクリックし、エラー メッセージにエラーの性質に関する十分な情報が提供されているかどうかを確認します。

右側のパネルで [詳細の更新] をクリックし、 [ログ] を クリックして、パイプラインの詳細ページからクラスター ログを確認してダウンロードすることもできます。ログをスキャンしてエラーまたは例外がないか確認します。

認証に失敗しました

問題：

接続を作成またはパイプラインを実行するときに認証エラーが発生します。

解決：

1. Meta 開発者ポータルで Meta アプリが正しく設定されていることを確認します。
2. 接続時にアプリ ID とアプリ シークレットが正しく入力されていることを確認します。
3. Meta アプリ設定で OAuth リダイレクト URI が正しく構成されていることを確認します。
4. Meta アプリに必要な権限 ( ads_read 、 ads_management 、 business_management ) があることを確認します。
5. エラーが解決しない場合は、接続を削除して再作成してみてください。

レート制限を超えました

問題：

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: RATE_LIMIT_EXCEEDED.

これは、Meta Ads アカウントで API レート制限に達したときに発生します。

解決：

1. API 制限がリセットされるまで待ちます (通常 1 時間)。
2. パイプラインを再試行します。
3. パイプライン スケジュールの頻度を減らすことを検討してください。
4. 大きなパイプラインを複数の小さなパイプラインに分割することを検討してください。

無効な内訳の組み合わせ

問題：

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: INVALID_PARAMETER. Invalid breakdown combination.

これは、 ad_insightsオブジェクトに対して無効な内訳またはアクション内訳の組み合わせを構成した場合発生します。

解決：

1. 有効な内訳の組み合わせについては、 APIドキュメントを確認してください。
2. 有効な内訳の組み合わせを使用するようにパイプライン構成を更新します。
3. パイプラインを再試行します。

権限が不十分です

問題：

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: INSUFFICIENT_PERMISSIONS.

これは、認証ユーザーが要求されたデータにアクセスするための十分な権限を持っていない場合に発生します。

解決：

1. Meta 開発者ポータルで、Meta アプリに必要な権限があることを確認します。
2. 認証ユーザーが、取り込もうとしている広告アカウントにアクセスできることを確認します。
3. 必要に応じて、Meta アプリがアプリレビュー プロセスを完了していることを確認します。
4. 必要に応じて接続を再承認してください。

期限切れのアクセストークン

問題：

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: TOKEN_EXPIRED.

これは、 OAuthアクセスの有効期限が切れたときに発生します。

解決：

1. カタログ エクスプローラーで接続を編集します。
2. [認証] をクリックして接続を再認証します。
3. パイプラインを再試行します。

コネクタはトークンの更新を自動的に管理しますが、場合によっては接続を手動で再承認する必要があります。

広告アカウントが見つかりません

問題：

[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: ACCOUNT_NOT_FOUND.

これは、指定された広告アカウント ID が存在しないか、認証ユーザーがアクセス権を持っていない場合に発生します。

解決：

1. パイプライン設定内の広告アカウント ID が正しいことを確認します。
2. 認証ユーザーが Meta Business Manager の広告アカウントにアクセスできることを確認します。
3. 広告アカウントが削除または無効化されていないことを確認してください。

不完全な ad_insights データ

問題：

ad_insightsテーブルには最近の日付のデータが欠落しているか不完全です。

解決：

これは予想される動作です。ad_insightsオブジェクトは、遅延コンバージョン イベントのアカウントにアトリビューション ウィンドウを使用します。 最近の日付のデータは、アトリビューション期間が終了するまで不完全である可能性があります (クリック アトリビューションの場合は 7 日間、ビュー アトリビューションの場合は 1 日間)。

コネクタは、後続のパイプライン実行時に更新されたデータを自動的に取り込みます。何もする必要はありません。

オブジェクトまたはフィールドが見つかりません

問題：

取り込まれたデータ内に予期されたオブジェクトまたはフィールドが見つかりません。

解決：

1. オブジェクトまたはフィールド名が正しいことを確認します。オブジェクト名とフィールド名は大文字と小文字が区別されます。
2. 認証ユーザーがオブジェクトまたはフィールドにアクセスする権限を持っていることを確認します。
3. オブジェクトまたはフィールドがコネクタでサポートされていることを確認します。サポートされているオブジェクトの一覧については、 Meta Ads 取り込みコネクタ リファレンスを参照してください。
4. 一部のフィールドは、特定の権限または API バージョンでのみ使用できる場合があります。

パイプラインのタイムアウト

問題：

実行中にパイプラインがタイムアウトします。

解決：

1. 大量のデータを取り込んでいるかどうかを確認します。パイプラインをより小さなパイプラインに分割することを検討してください。
2. Meta API レート制限を超えていないことを確認します。
3. パイプラインを再試行します。一部のタイムアウトは一時的なものです。

問題が解決しない場合は、サポート チケットを提出してください。

次のステップ

• コネクタの制限
• コネクタリファレンス
• コネクタに関するよくある質問