メインコンテンツまでスキップ

Meta Ads 取り込みコネクタリファレンス

備考

ベータ版

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

この記事には、 Databricks LakeFlow Connectの Meta Ads 取り込みコネクタに関する参考資料が含まれています。

自動データ変換

Databricks は、次のように Meta Ads データ型を Delta 互換データ型に変換します。

メタ広告タイプ

Delta型

string

String

int

Integer

long

Long

float

Float

double

Double

boolean

Boolean

datetime

タイムスタンプ

日付

Date

list

Array

map

Map

enum

String

サポートされているオブジェクト

Meta Ads コネクタは、次のオブジェクトの取り込みをサポートしています。

オブジェクト

説明

広告

キャンペーン内の個別の広告

広告セット

共通のターゲティング、予算、スケジュール設定で広告をグループ化した広告セット

キャンペーン

広告セットを含む最上位のキャンペーン オブジェクト

広告画像

広告で使用される画像アセット

広告インサイト

広告、広告セット、キャンペーン、またはアカウントのパフォーマンス メトリクスおよびアナリティクス データ

広告クリエイティブ

広告で使用されるクリエイティブ要素(画像、動画、テキスト)

カスタムオーディエンス

ターゲティングのためのカスタムオーディエンス定義

広告動画

広告で使用される動画アセット

カスタムコンバージョン

カスタムコンバージョンイベント定義

ad_insights 設定オプション

ad_insightsオブジェクトは、パフォーマンス データを分析するための追加の構成オプションをサポートしています。

粒度レベル

パフォーマンス メトリクスを取得するレベルを指定します。

  • account: アカウントレベルのメトリクス
  • campaign: キャンペーンレベルのメトリクス
  • ad_set: 広告セットレベルのメトリクス
  • ad: 広告レベルのメトリクス (自信)

内訳ディメンション

パフォーマンス データをセグメント化するための内訳ディメンションを構成します。

  • age: 年齢層
  • gender: 性別
  • country: 国
  • region: 地理的地域
  • dma: 指定市場エリア(米国のみ)
  • device_platform: デバイス プラットフォーム (モバイル、デスクトップなど)
  • placement: 広告掲載場所
  • publisher_platform: パブリッシャープラットフォーム(Facebook、Audience Networkなど)
  • impression_device: インプレッションのデバイスタイプ

アクションの内訳ディメンション

コンバージョン アクションを分析するには、アクション内訳ディメンションを設定します。

  • action_type: コンバージョンアクションの種類
  • action_destination: コンバージョンアクションの目的地
  • action_carousel_card_id: カルーセルカード識別子
  • action_carousel_card_name: カルーセルカード名
  • action_video_sound: ビデオサウンド設定
  • action_video_type: ビデオの種類

時間増分

コネクタは毎日の時間増分を使用します。ベータ版では、時間単位の時間増分はサポートされていません。

アトリビューションウィンドウ

コネクタはベータ版で次の固定アトリビューション ウィンドウを使用します。

  • クリックアトリビューション期間: 7日間
  • 表示アトリビューション期間: 1 日

APIバージョン

Meta Ads コネクタはAPIを使用します。 Databricks は、コネクタを最新の安定した API バージョンに更新します。

次のステップ