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