メインコンテンツまでスキップ
に最終更新

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

開始日​

過去のad_insightsデータを取り込む開始日を設定してください。APIデータを約36か月間しか保持しないため、 start_date過去36か月以内である必要があります。 設定されていない場合、コネクタはデフォルトで現在の日付の36ヶ月前になります。

粒度レベル​

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

  • account: アカウントレベルのメトリクス
  • campaign: キャンペーンレベルのメトリクス
  • adset: 広告セットレベルのメトリクス
  • 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: ビデオの種類

時間増分​

ad_insightsデータの集計期間を設定します。

  • all_days: 全時間範囲をカバーする単一のバケット (知見API )。
  • monthly：1暦月につき1つのバケツ。
  • 日数を整数で文字列として指定します（例：日単位の場合は"1" 、週単位の場合は"7" ）。

当該API時間単位の時間増分をサポートしていません。

行動報告の時間です​

アクション統計を報告する際に使用するタイムスタンプを設定します。

  • impressionコンバージョンは、コンバージョンを引き起こしたインプレッションの日付で報告されます。
  • conversion変換は、変換が発生した日付に報告されます。
  • mixedクリックコンバージョンはインプレッション時間を使用し、ビュースルーコンバージョンはコンバージョン時間を使用します。
  • lifetime: エンティティの生涯変換。

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

アクションの帰属期間を設定します。

  • 1d_click、 7d_click ：クリックスルーアトリビューションウィンドウ
  • 28d_clickクリックアトリビューションウィンドウ。Metaによって非推奨になりました。新しいAPIバージョンでは返されない可能性があります。
  • 1d_view: 表示アトリビューションウィンドウ
  • 7d_view、 28d_view ：表示可能な帰属表示ウィンドウ。Metaによって非推奨になりました。新しいAPIバージョンでは返されない可能性があります。

複数の値を指定できます（例： ["7d_click", "1d_view"] ）。action_attribution_windowsが設定されていない場合、コネクタはメタ広告アカウントの確実なアトリビューション設定を使用します。 値のリストについては、 Meta の知見APIリファレンスを参照してください。

ルックバック期間​

コネクタが同期ごとにデータを再取り込む期間（日数）を設定します。

行動：

  • 時間範囲の再取り込み ：最初の同期以降、コネクタは[last_sync_cursor - <N> days, today]データを取得するため、遅れて到着した変換がキャプチャされます。custom_insights_lookback_windowが設定されていない場合、コネクタはデフォルトで過去7日間のデータを再取り込みします。
  • 帰属フォールバック : custom_insights_lookback_window明示的に設定し 、 action_attribution_windowsを設定していない場合、コネクタは<N>d_click,1d_view帰属ウィンドウとして共有APIにも渡します。 ルックバックとは独立してアトリビューションを制御するには、 action_attribution_windowsを設定します。

APIバージョン​

Meta Ads コネクタは Meta マーケティングAPI (Graph API ) を使用します。 Databricksは、コネクタを最新の安定版APIバージョンに常に更新しています。

このページの見出し