Reddit Adsインジェストコネクタに関するFAQ
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、Databricks Lakeflow Connect の Reddit Ads インジェスト コネクタに関するよくあるご質問に回答します。
一般的なマネージド コネクタの FAQ
マネージドコネクタの FAQ の回答は、Lakeflow Connect のすべてのマネージドコネクタに適用されます。Reddit Ads 固有の FAQ については、引き続きお読みください。
DatabricksはReddit Adsにどのように接続しますか？
Databricks は PKCE を使用した OAuth 2.0 ユーザーマシン間（U2M）認証で Reddit Ads API に接続します。adsreadのスコープはDatabricksによって自動的に設定されます。接続資格情報は Unity Catalog に安全に格納され、インジェスト フローを実行しているユーザーが適切なアクセス許可を持っている場合にのみ取得できます。
コネクタはどのような種類のテーブルを取り込むことができますか？
コネクターは、次の 2 種類のテーブルをサポートしています。
- エンティティテーブル (
ad_account,campaign,ad_group,ad)：アカウントに関する構成データです。エンティティテーブルはパイプラインの各ランで完全に更新され、履歴追跡（SCDタイプ2）をサポートしていません。 - レポートテーブル ：インプレッション、クリック、費用などのパフォーマンスメトリクス。レポートテーブルは、構成可能なルックバックウィンドウを備えた増分取り込みをサポートしています。
サポートされているテーブルとそのスキーマの全リストについては、Reddit広告コネクタのリファレンスを参照してください。
コネクタはどのように増分更新を取り込みますか？
レポートテーブルは増分取り込みを使用します。Reddit広告のメトリクスは、最初に報告された後（たとえば、コンバージョンやアトリビューションが再計算された場合）に変更される可能性があるため、コネクタは同期ごとに最新の数日間のデータを再読み込みします。defaultでは、過去30日間を再読み込みします。これをlookback_window_daysパラメーター (1から30までの任意の値) で変更できます。エンティティテーブルは、各ランで完全更新されます。
アトリビューションウィンドウと一致するようにルックバックウィンドウを設定するにはどうすればよいですか？
組織のコンバージョンアトリビューションウィンドウと一致するようにlookback_window_daysを設定します。例えば、組織が14日間のアトリビューションウィンドウを使用している場合は、lookback_window_days: 14を設定します。アトリビューションとルックバックウィンドウを参照してください。
コネクタはどのくらいのヒストリカルデータを取り込みますか？
defaultでは、コネクタはレポート テーブルの2年間分のヒストリカルデータを取り込みます。これはsync_start_dateパラメーター（YYYY-MM-DD形式の日付）で構成できます。このパラメーターは最初のランにのみ適用されます。最初のチェックポイント以降は、完全な更新を行わない限り、変更しても効果はありません。
レポートデータに古い日付が欠落しているのはなぜですか？
Reddit Ads レポート API は、過去約24か月分のレポートデータを提供します。sync_start_dateに関係なく、レポートテーブルはこのウィンドウより古いデータを取得できません — より古いデータの要求はRedditによって拒否されます。この制限はレポートテーブルにのみ適用され、エンティティテーブルには適用されません。レポートデータ保持を参照してください。
カスタムレポートをどのように定義しますか？
source_tableをcustom_reportに設定し、destination_tableの名前を指定し、connector_options.reddit_ads_options.custom_report_optionsの下でレポート構成を指定します。breakdownsリストには、テーブルの増分カーソルとなる少なくとも1つの時間ディメンション（DATEまたはHOUR）を含める必要があります。内訳とフィールド値は、サポートされているリストから取得する必要があります。カスタムレポートの内訳とフィールドを参照してください。
レポートの日付はどのタイムゾーンですか？
レポートの日付境界は、広告アカウント独自のタイムゾーンで解釈されます。コネクタはこれをアカウントから自動的に読み取ります。パイプラインスペックではタイムゾーンを設定しません。
通貨列の通貨は何ですか？
通貨列（たとえば、spend、cpc、bid_value）は、マイクロ単位ではなく、広告アカウントの通貨で小数点以下の金額（たとえば、12.34）として保存されます。アカウントの通貨コードは、ad_account.currency列およびレポートのcurrency列で利用可能です。
1 つのパイプラインで複数の広告アカウントから取り込むことはできますか？
はい。1つのパイプラインは複数の広告アカウントスキーマから取り込むことができ、パイプライン内の各 source_schema エントリは1つの広告アカウントにマップされます。「ソーススキーマ」を参照してください。
コネクタは削除を検出しますか？
エンティティテーブルは各ランで完全に更新されるため、現在の状態は常にソースを反映します。レポートテーブルはルックバックウィンドウ内で増分インジェストを使用します。テーブルを完全に再同期するには、フル更新を実行します。