Meta Adsコネクタの概念
ベータ版
Meta Ads コネクタはベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。「Databricks プレビューの管理」を参照してください。
Meta Ads コネクタを使用すると、 Databricks LakeFlow Connect使用して Meta Ads から広告データを取り込むことができます。
Meta Ads の取り込みはどのように機能しますか?
コネクタは知見APIからデータを取得し、ストリーミング テーブルに書き込みます。 各 Meta Ads オブジェクトは、宛先スキーマ内のテーブルに対応します。
コネクタデータモデル
Meta Ads コネクタは、Meta Ads アカウントから次のオブジェクトを取り込むことができます。
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 広告はサポートされていません。
認証
コネクタは Meta Ads での認証に OAuth 2.0 を使用します。Meta 開発者ポータルで Meta アプリを作成し、OAuth 設定を構成して、Databricks が広告データにアクセスできるようにします。接続資格情報は Unity Catalog に安全に保存されます。