メタ広告コネクタのコンセプト
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。「Databricks プレビューの管理」を参照してください。
Meta Adsコネクタを使用すると、 Databricks LakeFlow Connect使用してMeta Adsから広告データを取り込むことができます。
Meta Adsの取り込みはどのように行われるのですか？
コネクタはメタ広告APIsからデータを取得し、ストリーミング テーブルに書き込みます。 ad_insightsオブジェクトはAPIを使用します。 ads 、 ad_sets 、およびcampaignsオブジェクトはマーケティングAPIを使用します。 各メタ広告オブジェクトは、宛先スキーマ内のテーブルに対応します。
コネクタデータモデル
メタ広告コネクタは、メタ広告アカウントから次のオブジェクトを取り込むことができます。
adsキャンペーン内の個々の広告ad_sets広告をグループ化する広告セットcampaigns: 最上位のキャンペーンオブジェクトad_images広告に使用されている画像ad_insights: パフォーマンスメトリクスとアナリティクスデータad_creatives広告で使用されるクリエイティブ要素custom_audiences: カスタムオーディエンス定義ad_videos広告で使用される動画素材custom_conversionsカスタム変換イベント定義
ad_insights オブジェクト
ad_insightsオブジェクトは、広告キャンペーンのパフォーマンス メトリクスを提供します。 パフォーマンスをさまざまなレベルで分析するために、内訳とアクション内訳を設定できます。
- 粒度レベル ：
account、campaign、adset、またはad - 分析項目 ：年齢、性別、国、場所、デバイスプラットフォームなど
- アクションの内訳 ：アクションの種類、アクションの到達先、およびその他のコンバージョン関連の要素
- 時間増分 ：
all_days、monthly、または任意の日数。当該API時間単位の時間増分をサポートしていません。 - アクションレポート時間 ：コネクタがインプレッション、コンバージョン、ミックス、およびライフタイム別にアクション統計を報告するかどうか。
- ルックバックウィンドウ ：コネクタが同期ごとに再取り込みして、遅れて到着したコンバージョンをキャプチャする日数。
各オプションの詳細については、 「ad_insights 設定オプション」を参照してください。
コネクタの基本
- パイプラインの初回実行時、コネクタは選択されたオブジェクトからすべてのデータを取り込みます。
- 以降のパイプライン実行では、コネクタは増分取り込みを使用して、新しく作成または変更されたレコードを取り込みます。
- このコネクタは、Meta Adsのデータ型をDelta互換のデータ型に自動的に変換します。
- 各宛先テーブルはストリーミング テーブルであり、増分データ処理の追加サポートを備えたDeltaテーブルです。
増分取り込み
Meta Adsコネクタは、パイプラインの効率を向上させるために、インクリメンタルインジェスト方式を採用しています。パイプラインの初回実行時には、ソースから選択されたすべてのデータが取り込まれます。以降の実行では、コネクタはカーソルベースの変更追跡を使用して、前回の実行以降に変更されたデータのみを取り込みます。
コネクタは、変更を検出するために、（利用可能な場合） updated_timeフィールドをカーソル列として使用します。updated_timeフィールドを持たないオブジェクトの場合、コネクタは完全な更新取り込みを使用します。
帰属設定
もちろん、Meta Ads コネクタは、 ad_insightsデータを取得するときに Meta Ads アカウントの属性設定を使用します。 action_attribution_windowsを設定して 1 つ以上の帰属ウィンドウを指定することで、これを上書きできます (たとえば、 7d_clickまたは1d_view )。サポートされている値については、 「属性ウィンドウ」を参照してください。
コンバージョンイベントはインプレッションやクリックが発生した後に報告される可能性があるため、設定されたアトリビューション期間が終了するまでは、最近の日付のデータは不完全な場合があります。コネクタは、後続のパイプライン実行時にこのデータを自動的に再取り込みします。
サポートされている広告プラットフォーム
ベータ版では、このコネクタはFacebook広告のみをサポートしています。Instagram広告はサポートされていません。
認証
このコネクタは、OAuth 2.0を使用してMeta Adsとの認証を行います。Meta開発者ポータルでMetaアプリを作成し、OAuth設定を構成して、Databricksが広告データにアクセスできるようにします。接続認証情報はUnity Catalogに安全に保存されます。