Reddit Ads コネクタ リファレンス
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、サポートされるテーブル、列の定義、データ型を含め、Lakeflow Connect のマネージド Reddit Ads コネクタのリファレンス情報を提供します。
サポートされているソーステーブル
「Reddit広告コネクタは、次のタイプのテーブルをサポートしています。」
- 「 エンティティテーブル : キャンペーン、広告グループ、広告など、Reddit広告アカウントに関する設定データ。」「これらのテーブルは、パイプラインのランごとに完全に更新されます。」
- レポート テーブル :インプレッション、クリック数、支出などのパフォーマンス メトリクス。これらのテーブルは増分取り込みをサポートしています。
- カスタム レポート : 分解ディメンションとメトリクス フィールドを選択できるユーザー定義テーブルです。カスタム レポートを参照してください。
エンティティテーブル
テーブル名 | 説明 |
|---|---|
| 認証済みユーザーがアクセスできる広告アカウント。 |
| キャンペーン構成と設定。 |
| 広告グループの構成と設定。 |
| 個々の広告の詳細と設定。Reddit Ads APIの |
レポートテーブル
テーブル名 | プライマリーキー | 説明 |
|---|---|---|
|
| キャンペーンレベルのパフォーマンスメトリクス |
|
| 広告グループレベルのパフォーマンスメトリクス。 |
|
| 広告レベルのパフォーマンスメトリクス。 |
|
| 国別に分類されたキャンペーンレベルのパフォーマンスメトリクス。 |
データ型の表記規則
通貨
金額列(例えば、spend、cpc、bid_value)は、広告アカウントの通貨でdecimal(19,2)として保存されます。値はマイクロではなく、小数(例えば、12.34)です。アカウントの通貨コードは、ad_account.currency列とレポートのcurrency列で利用できます。
JSON列
一部のエンティティテーブルの列には、JSON文字列として保存されている複雑なネストされたオブジェクトが含まれています:targeting、schedule、event_trackers。これらをSQLまたはPySparkでfrom_json()またはparse_json()を使用して解析します。
増分カーソル
レポートテーブルでは、metrics_updated_at(timestamp)を増分カーソルとして使用します。
エンティティ テーブル スキーマ
ad_account
認証済みユーザーがアクセスできる広告アカウント。このテーブルはdefaultソーススキーマにあります。
列 | データ型 | 説明 |
|---|---|---|
|
| プライマリーキー。広告アカウントID。 |
|
| 広告アカウント名。 |
|
| アカウントの種類。 |
|
| 管理者承認ステータス。 |
|
| 関連ビジネス ID。 |
|
| 「アカウントが作成されたとき。」 |
|
| アカウントが最後に変更された時刻。 |
|
| アカウント通貨コード、例えば |
|
| アカウントのタイムゾーン。 |
|
| 属性タイプ設定。 |
|
| 「アプリの属性タイプ設定」 |
|
| クリック属性ウィンドウ。 |
|
| 属性ウィンドウの表示。 |
|
| アプリのクリックアトリビューションウィンドウ。 |
|
| アプリビューのアトリビューションウィンドウ。 |
|
| 支出上限タイプ。 |
|
| 該当する場合、アカウント停止の理由。 |
|
| ターゲットから除外されたコミュニティ。 |
|
| ターゲティングから除外されたキーワード。 |
|
| ピクセルパートナー設定。 |
|
| 主要連絡先メンバー ID |
campaign
キャンペーン構成と設定。
列 | データ型 | 説明 |
|---|---|---|
|
| プライマリーキー。キャンペーン ID。 |
|
| 関連付けられた広告アカウントID。 |
|
| キャンペーン名。 |
|
| キャンペーンの目的 |
|
| ユーザーが設定するステータス(アクティブまたは停止)。 |
|
| 実質的な配信ステータス |
|
| 詳細な配信ステータス理由。 |
|
| キャンペーンが作成されたとき。 |
|
| キャンペーンの最終変更日時。 |
|
| キャンペーン開始時刻。 |
|
| キャンペーン終了時刻。 |
|
| 「入札タイプ」 |
|
| 入札戦略。 |
|
| アカウント通貨での入札値。 |
|
| 目標タイプ。 |
|
| アカウント通貨での目標値。 |
|
| アカウント通貨での支出上限。 |
|
| 関連付けられたコンバージョンピクセル ID。 |
|
| 関連付けられた資金調達手段ID。 |
|
| 最適化目標。 |
|
| 「ビュースルーコンバージョンタイプ」 |
|
| 関連付けられたアプリID。 |
|
| 「請求書ラベル」 |
|
| キャンペーン予算の最適化がMAXモードであるかどうか。 |
|
| キャンペーン予算の最適化が有効になっているかどうか。 |
|
| 特別な広告カテゴリ(例:住宅、信用)。 |
|
| SKAdNetworkのメタデータ。 |
|
| 「年齢制限設定」 |
ad_group
広告グループの構成と設定。
列 | データ型 | 説明 |
|---|---|---|
|
| プライマリーキー。広告グループID。 |
|
| 関連付けられた広告アカウントID。 |
|
| 関連するキャンペーンID。 |
|
| 広告グループ名 |
|
| ユーザー設定のステータス。 |
|
| 実質的な配信ステータス |
|
| 詳細な配信ステータス理由。 |
|
| 広告グループが作成されたとき。 |
|
| 広告グループが最後に変更された時刻。 |
|
| 広告グループの開始時刻。 |
|
| 広告グループの終了時間。 |
|
| 「入札タイプ」 |
|
| 入札戦略。 |
|
| アカウント通貨での入札値。 |
|
| 目標タイプ。 |
|
| アカウント通貨での目標値。 |
|
| 関連付けられたコンバージョンピクセル ID。 |
|
| 最適化目標。 |
|
| 「ビュースルーコンバージョンタイプ」 |
|
| この広告グループに対して、キャンペーン予算の最適化がアクティブかどうか。 |
|
| キャンペーン目標タイプ。 |
|
| 関連付けられたアプリID。 |
|
| 関連付けられた製品セットID。 |
|
| ショッピングの種類。 |
|
| 保存されたオーディエンスID。 |
|
| ターゲット設定を含むJSON文字列。 |
|
| ショッピングターゲティング設定。 |
|
| 広告スケジューリング設定を含むJSON文字列 |
|
| SKAdNetworkのメタデータ。 |
ad
個々の広告の詳細と設定。Reddit Ads APIのadsに対応します。
列 | データ型 | 説明 |
|---|---|---|
|
| プライマリーキー。広告ID。 |
|
| 関連付けられた広告アカウントID。 |
|
| 関連付けられた広告グループID。 |
|
| 関連するキャンペーンID。 |
|
| 広告名。 |
|
| 広告タイプ。 |
|
| ユーザー設定のステータス。 |
|
| 実質的な配信ステータス |
|
| 詳細な配信ステータス理由。 |
|
| 広告の作成日時。 |
|
| 広告の最終変更日時。 |
|
| 広告がクリックされた場合の宛先URL。 |
|
| クリックURLに追加されるクエリーパラメーター。 |
|
| キャンペーン目標タイプ。 |
|
| 関連付けられたReddit投稿ID。 |
|
| 関連付けられたReddit投稿のURL。 |
|
| 関連付けられたプロファイルID。 |
|
| 広告プレビューURL。 |
|
| プレビューURLの有効期限が切れるとき。 |
|
| イベントトラッカー設定を含むJSON文字列。 |
|
| 関連製品。 |
|
| 該当する場合、広告却下の理由。 |
|
| ショッピングクリエイティブ設定 |
|
| SKAdNetworkのメタデータ。 |
テーブルスキーマを報告する
すべてのレポートテーブルは、同じメトリクス列を共有しています。それらはプライマリキーの列のみが異なります。
共有メトリクス列
すべてのレポートテーブルには、account_id (string) と以下のメトリクス列が含まれています:
Core配信
列 | データ型 | 説明 |
|---|---|---|
|
| インプレッション数。 |
|
| クリック数。 |
|
| アカウント通貨での合計支出額。 |
|
| 効果的な1,000インプレッションあたりの費用。 |
|
| クリックあたりのコスト。 |
|
| 表示あたりのコスト。 |
|
| クリック率。 |
|
| ユニークユーザー数に達しました。 |
|
| 各ユーザーが広告を見た平均回数。 |
|
| 視認可能なインプレッション数。 |
|
| エンゲージメントクリック数。 |
|
| Reddit リード数。 |
|
| コンバージョンからの広告費用対効果。 |
エンゲージメント(エンゲージメントキャンペーンに対して入力されます。その他のキャンペーンタイプの場合はnull )
列 | データ型 | 説明 |
|---|---|---|
|
| 広告の高評価数。 |
|
| 広告の低評価数。 |
|
| コメントの賛成票数。 |
|
| コメントの低評価数。 |
|
| 送信されたコメント数。 |
|
| コメントページビュー数。 |
動画の再生数と視聴時間
列 | データ型 | 説明 |
|---|---|---|
|
| 動画再生が開始された回数。 |
|
| ビデオが展開された回数。 |
|
| 音声オンでの再生回数 |
|
| 「3秒に達したビューの数」 |
|
| 5秒に到達するビュー数。 |
|
| 10秒に達するビューの数。 |
|
| 25%完了に達するビューの数。 |
|
| 50%完了に達するビューの数。 |
|
| 75%の完了に達したビューの数。 |
|
| 完了率95%に達したビューの数。 |
|
| 100%完了に達したビュー数。 |
動画レートと視認性
列 | データ型 | 説明 |
|---|---|---|
|
| 動画視聴率。 |
|
| 6秒時点のビデオ視聴率。 |
|
| 15秒時点での動画視聴率。 |
|
| 動画完了率。 |
|
| 完全に視認可能なインプレッション数。 |
|
| 視認可能なインプレッション数。 |
|
| 6秒間視聴された表示可能なインプレッション数。 |
|
| 15秒視聴された表示可能インプレッション数。 |
表示あたりのコスト
列 | データ型 | 説明 |
|---|---|---|
|
| 3秒ビューあたりのコスト。 |
|
| 6秒間の視聴あたりのコスト。 |
|
| 15秒あたりの視聴コスト。 |
|
| 完了したビューあたりのコスト。 |
その他
列 | データ型 | 説明 |
|---|---|---|
|
| 通貨列の通貨コード。 |
|
| メトリクスが最後に更新された時期です。増分カーソルとして使用されます。 |
campaign_report
キャンペーンレベルのパフォーマンスメトリクス
プライマリキー:campaign_id(string)、date(date、YYYY-MM-DD)。
すべての共有メトリクス列とaccount_id (string) を含みます。
ad_group_report
広告グループレベルのパフォーマンスメトリクス。
プライマリキー:ad_group_id(string)、date(date、YYYY-MM-DD)。
すべての共有メトリクス列に加えて、広告グループの内訳に対して自動的に返される account_id (string) および pacing (double) が含まれます。
ad_report
広告レベルのパフォーマンスメトリクス。
プライマリキー:ad_id(string)、date(date、YYYY-MM-DD)。
すべての共有メトリクス列とaccount_id (string) を含みます。
campaign_country_report
国別に分類されたキャンペーンレベルのパフォーマンスメトリクス。
主キー:campaign_id (string)、date (date、YYYY-MM-DD)、country (string)。
すべての共有メトリクス列とaccount_id (string) を含みます。
カスタムレポート
カスタムレポートでは、必要な正確な内訳ディメンションとメトリクスフィールドを選択できます。source_table: custom_reportを設定し、connector_options.reddit_ads_options.custom_report_optionsの下にレポート定義を提供して宣言します。
カスタムレポートには、destination_tableの名前が必要です。
カスタムレポートの主キーは、選択された内訳列で構成されます。メトリクスフィールドはデータ値として保存されます。
カスタムレポートの内訳とフィールド
**サポートされている内訳** — 少なくとも1つの時間ディメンション (DATE HOURまたは) を含める必要があります。宛先列名は括弧内に表示されます。
DATE (日付)、HOUR(時間)、AD_ACCOUNT_ID(アカウントID)、AD_GROUP_ID(広告グループID)、AD_ID(広告ID)、CAMPAIGN_ID(キャンペーンID)、COMMUNITY(コミュニティ)、COUNTRY(国)、DMA(DMA)、GALLERY_ITEM_ID(投稿ID)、GENDER(性別)、INTEREST(興味)、KEYWORD(キーワード)、OS_TYPE(OSタイプ)、PLACEMENT(プレースメント)、REGION(地域)。
サポートされているフィールド(宛先列名が小文字のトークンであること):
コア配信:IMPRESSIONS(long)、CLICKS(long)、SPEND(decimal(19,2))、CPC(decimal(19,2))、ECPM(decimal(19,2))、CTR(double)、CONVERSION_ROAS(double)。
ビデオ:VIDEO_STARTED、VIDEO_PLAYS_EXPANDED、VIDEO_PLAYS_WITH_SOUND、VIDEO_WATCHED_3_SECONDS、VIDEO_WATCHED_5_SECONDS、VIDEO_WATCHED_10_SECONDS、VIDEO_WATCHED_25_PERCENT、VIDEO_WATCHED_50_PERCENT、VIDEO_WATCHED_75_PERCENT、VIDEO_WATCHED_95_PERCENT、VIDEO_WATCHED_100_PERCENT、VIDEO_FULLY_VIEWABLE_IMPRESSIONS、VIDEO_VIEWABLE_IMPRESSIONS(すべてlong)。
アプリのインストールコンバージョン: APP_INSTALL_ADD_PAYMENT_INFO_COUNT、APP_INSTALL_ADD_TO_CART_COUNT、APP_INSTALL_APP_LAUNCH_COUNT、APP_INSTALL_COMPLETED_TUTORIAL_COUNT、APP_INSTALL_INSTALL_COUNT、APP_INSTALL_MMP_INSTALL_COUNT、APP_INSTALL_MMP_TOTAL_INSTALL_COUNT、APP_INSTALL_SKAN_INSTALL_COUNT、APP_INSTALL_SKAN_TOTAL_INSTALL_COUNT、APP_INSTALL_LEVEL_ACHIEVED_COUNT、APP_INSTALL_PURCHASE_COUNT、APP_INSTALL_SEARCH_COUNT、APP_INSTALL_SIGN_UP_COUNT、APP_INSTALL_SPEND_CREDITS_COUNT、APP_INSTALL_VIEW_CONTENT_COUNT (すべてlong)。
その他: PRIORITY(string)。