Meta Ads 取り込みコネクタに関するよくある質問
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。「Databricks プレビューの管理」を参照してください。
このページでは、 Databricks LakeFlow Connectの Meta Ads 取り込みコネクタに関するよくある質問に回答します。
一般的なマネージドコネクタに関する FAQ
マネージド コネクタに関する FAQの回答は、 LakeFlow Connectのすべてのマネージド コネクタに適用されます。 Meta Ads 固有の FAQ については、引き続きお読みください。
取り込みコネクタはどの Meta API を使用しますか?
Meta Ads コネクタは 2 つのメタAPIsを使用します。1 つはパフォーマンス メトリクス用の ノウハウAPI ( ad_insights ) 、もう 1 つはオブジェクト データ用の マーケティングAPI ( ads 、 ad_sets 、 campaigns 、 ad_images 、 ad_creatives 、 ad_videos 、 custom_audiences 、 custom_conversions ) です。
Databricks は Meta Ads にどのように接続しますか?
Databricks HTTPSを使用してMeta Ads APIsに接続します。 認証情報はUnity Catalogに安全に保存され、取り込みフローを実行するユーザーが適切な権限を持っている場合にのみ取得できます。
コネクタはどのようにして段階的に更新をプルするのでしょうか?
コネクタはカーソルベースの増分取り込みを使用します。ほとんどのオブジェクトの場合、コネクタは変更を検出するためのカーソルとしてupdated_timeフィールドを使用します。パイプラインの実行ごとに、コネクタは前回の実行以降に作成または変更されたレコードのみを取り込みます。
updated_timeフィールドのないオブジェクトの場合、コネクタは完全更新の取り込みを使用します。
1 つのパイプラインで取り込めるオブジェクトの数はいくつですか?
Databricks では、1 つのパイプラインを 250 個のオブジェクトに制限することを推奨しています。さらに多くのオブジェクトを取り込む必要がある場合は、複数のパイプラインを作成します。
Meta API のレート制限に達した場合はどうなりますか?
コネクタが MetaAPI からレート制限エラーを検出した場合、Meta のレート制限応答APIからサーバー提供のestimated_time_to_regain_access値を読み取り、その間隔 (最大 2 分) だけ待機してから、最大 3 回まで再試行します。 レート制限が継続する場合、パイプラインは失敗し、次回のスケジュールされた実行時に再試行できます。
レート制限の問題を回避するには、次の点を考慮してください。
- パイプラインスケジュールの頻度を減らす
- 単一のパイプラインで取り込まれるオブジェクトの数を減らす
- 複数のパイプラインに取り込みを分散する
カスタムアトリビューションウィンドウを設定できますか?
はい。 ad_insightsオブジェクト (例えば["7d_click", "1d_view"] ) に対して、 meta_ads_optionsにaction_attribution_windows設定します。設定されていない場合、コネクタはメタ広告アカウントの当然のアトリビューション設定を使用します。 サポートされている値については、 「属性ウィンドウ」を参照してください。
コネクタは Instagram 広告をサポートしていますか?
いいえ。コネクタはベータ版では Facebook 広告のみをサポートします。Instagram 広告はサポートされていません。
コネクタはリアルタイムの取り込みをサポートしていますか?
いいえ。コネクタはスケジュールされたバッチ取り込みを使用します。リアルタイムの取り込みはサポートされていません。パイプラインを 1 時間ごとに実行するようにスケジュールできますが、レート制限の問題を回避するために、Databricks では頻度を低くしてスケジュールすることをお勧めします。
コネクタは削除をどのように処理しますか?
コネクタは削除を検出または処理しません。Meta Ads からレコードが削除された場合、そのレコードは宛先テーブルに残ります。削除されたレコードを削除するには、テーブルを完全に更新する必要があります。
最近の日付の ad_insights データが不完全なのはなぜですか?
ad_insightsオブジェクトは、遅延コンバージョン イベントをアカウントするためにアトリビューション ウィンドウを使用します。 設定された属性期間が終了するまで、最近の日付のデータは不完全な場合があります。コネクタは、後続のパイプライン実行時にこのデータを自動的に再取り込みします。帰属表示ウィンドウを設定するには、 「カスタム帰属表示ウィンドウを設定できますか?」を参照してください。
ad_insights ではどのような内訳の組み合わせがサポートされていますか?
コネクタは、知見APIで許可されるすべての内訳とアクション内訳の組み合わせをサポートします。 一部の組み合わせは有効でない場合があります。有効な内訳の組み合わせの詳細については、 APIドキュメントを参照してください。
UI ベースのパイプラインの作成はいつ利用可能になりますか?
ベータ版では、UIベースのパイプライン作成機能は利用できません。Databricks CLI 、 APIs 、SDK、または Declarative Automation Bundle を使用してパイプラインを作成します。 UIサポートは今後のリリースで追加される可能性があります。
Meta Ads コネクタは、Marketplace の Meta Conversions API とどう違うのですか?
Meta Ads コネクタと Meta Conversions API は、反対方向のデータ フローを提供します。
- LakeFlow Connectの Meta Ads コネクタは、 取り込みコネクタです。 キャンペーン、広告セット、レポートなどのメタ広告のパフォーマンス データをDatabricksに取り込んで、分析とレポートを作成します。
- Meta Conversions API ( Marketplace ) はアクティベーション ソリューションです。 広告のターゲティングと測定を改善するために、Databricks から Meta にファーストパーティ データを送信します。「Meta Conversions API と Databricks を使用してファーストパーティ データをアクティブ化する」を参照してください。