Reddit Ads コネクタの概念
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
Reddit Adsコネクタを使用すると、Databricks Lakeflow Connectを使用してReddit Adsから広告データを取り込むことができます。
Reddit Ads の取り込みはどのように機能しますか？
コネクタはReddit Ads APIからデータを取得し、ストリーミングテーブルに書き込みます。各Reddit Adsオブジェクトは、宛先スキーマ内のテーブルに対応します。コネクタは2種類のテーブルをサポートしています：
- エンティティテーブル ：キャンペーン、広告グループ、および広告など、Reddit広告アカウントに関する構成データです。エンティティテーブルは、各パイプラインのランで完全に更新され、履歴追跡（SCDタイプ2）をサポートしていません。
- レポート テーブル ：インプレッション、クリック数、支出などのパフォーマンス メトリクス。レポート テーブルは、遅れて到着するデータとアトリビューション更新を取り込むための設定可能なルックバック ウィンドウを備えた増分取り込みをサポートします。
コネクターデータモデル
Reddit Adsコネクタは、Reddit Adsアカウントから次のオブジェクトを取り込むことができます：
ad_account：認証済みユーザーがアクセスできる広告アカウントcampaign、ad_group、ad：アカウント構造を説明するエンティティオブジェクト- レポートテーブル（例：
campaign_report、ad_group_report、ad_report）：アカウント階層の各レベルで事前構築されたパフォーマンスメトリクス custom_report：構成可能な分解とフィールドの組み合わせを備えたユーザー定義レポート
サポートされているテーブルとそのスキーマの全リストについては、Reddit広告コネクタのリファレンスを参照してください。
ソーススキーマ
Reddit Adsは、アカウント階層に対応するソーススキーマ（名前空間）にテーブルを整理します。
ad_accountエンティティ テーブルは特別なdefaultスキーマにあります。認証済みユーザーがアクセスできるすべての広告アカウントが一覧表示されます。- その他すべてのテーブル —
campaign、ad_group、ad、およびすべてのレポートテーブル — は、広告アカウント ID によって名付けられたスキーマの下にあります（たとえば、t2_abc123）。このスキーマ名は、パイプライン仕様でsource_schemaとして設定する値です。
1つのパイプラインは複数の広告アカウントスキーマから取り込むことができ、各source_schemaエントリは1つの広告アカウントにマッピングされます。
レポートテーブル
レポートテーブルは、広告キャンペーンのパフォーマンスメトリクスを提供します。コネクタは約24か月前までのレポートデータを提供します。sync_start_dateパラメーターに関わらず、レポートテーブルはこのウィンドウよりも古いデータを取得できません。古いデータのリクエストはRedditによって拒否されます。この制限はレポートテーブルにのみ適用され、エンティティテーブルには適用されません。
カスタムレポート
custom_report オブジェクトを使用すると、設定可能な内訳とフィールドの組み合わせで独自のレポートを定義できます。custom_report_options を使用して構成を制御し、各カスタムレポートは個別の destination_table に取り込まれます。breakdowns リストには、少なくとも1つの時間ディメンション（DATE または HOUR）を含める必要があり、これはテーブルのインクリメンタルカーソルになります。
サポートされている内訳とフィールドについては、カスタム レポートの内訳とフィールドを参照してください。
コネクタの基本
- パイプラインの最初のランで、コネクタが選択されたオブジェクトからヒストリカルデータを取り込みます。
- その後のパイプラインのランでは、コネクタは増分取り込みを使用してレポート テーブル内の新規作成または変更されたレコードを取り込み、エンティティ テーブルを完全に更新します。
- コネクタは、Reddit Adsのデータ型をDelta互換のデータ型に自動的に変換します。
- 各宛先テーブルはストリーミングテーブルであり、増分データ処理の追加サポートを備えた Delta テーブルです。
増分取り込み
By default,コネクターは最初のランでレポートテーブルの2年間のヒストリカルデータを取り込みます。YYYY-MM-DD形式の日付を指定できるsync_start_dateパラメーターを使用して、これを構成できます。このパラメーターは、最初のランにのみ適用されます。最初のチェックポイントの後、フル更新なしで変更しても効果はありません。
以降のランでは、コネクタはレポート テーブルに増分取り込みを使用します。Reddit広告のメトリクスは、最初にレポートされた後に変更される可能性があるため（たとえば、コンバージョンやアトリビューションが再計算される際など）、コネクタは同期ごとに最新の数日分のデータを再読み込みします。エンティティテーブルは各ランで完全に更新されます。
アトリビューションとルックバックウィンドウ
遅れて到着するコンバージョンとアトリビューションの更新を取得するために、コネクタは同期のたびに、構成可能な数の最近の日数を再読み込みします。defaultでは、過去30日間を再読み込みします。これは、lookback_window_daysパラメーター（1から30までの任意の値）で変更できます。
組織のコンバージョンアトリビューションウィンドウと一致するようにlookback_window_daysを設定します。たとえば、組織が14日間のアトリビューションウィンドウを使用している場合は、lookback_window_days: 14を設定します。
タイムゾーン
レポートの日付範囲は、広告アカウント自身のタイムゾーンで解釈されます。コネクタは、アカウントからこれを自動的に読み取ります。パイプラインの仕様ではタイムゾーンを設定しません。
通貨
金額列（たとえば、spend、cpc、bid_valueなど）は、広告アカウントの通貨で小数値として（たとえば、12.34）、マイクロ単位ではなく保存されます。アカウントの通貨コードは、ad_account.currency 列とレポート currency 列にあります。
認証
コネクタは、PKCEとともにOAuth 2.0 ユーザーマシン間 (U2M) 認証を使用してReddit Adsで認証します。Reddit Ads Business Managerで開発者アプリケーションを作成し、Databricksが広告データにアクセスできるようにOAuth設定を構成します。adsreadスコープはDatabricksによって自動的に設定されます。接続資格情報はUnity Catalogに安全に保存されます。