ドキュメントメニュー

Reddit Ads#

アプリの認証情報を使う OAuth と広告主 ID で Reddit Ads を接続します。このソースは titan.reddit_ads に 6 個の固定テーブルを書き込みます。

sql
select
  id,
  name,
  account_id
from titan.reddit_ads.campaigns
limit 10

Reddit Adsを接続する#

  1. アプリを開き、アプリを接続を選択してから、Reddit Adsを選択します。

  2. アプリの認証情報を使って OAuth 認証を行い、広告主 ID を入力します。

  3. テーブルを確認してからソースを保存します。

  4. 初回の実行が完了するまで同期履歴を確認します。

認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。

同期の動作#

設定時に初回取得する履歴の期間を選択します。エンティティテーブルと指標テーブルは、広告主の範囲に限定されます。

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _synced_at_deleted もあります。以下の列リファレンスにはソースの列のみを記載しています。

テーブルリファレンス#

campaigns#

titan.reddit_ads.campaigns には 7 個のソース列があります。

reddit_ads.campaigns7列
idstringpk

ソースのフィールド id

namestring

ソースのフィールド name

account_idstring

ソースのフィールド accountId

statusstring

ソースのフィールド status

objectivestring

ソースのフィールド objective

created_atdatetime

ソースのフィールド createdAt

updated_atdatetime

ソースのフィールド updatedAt

ad_groups#

titan.reddit_ads.ad_groups には 7 個のソース列があります。

reddit_ads.ad_groups7列
idstringpk

ソースのフィールド id

campaign_idstring

ソースのフィールド campaignId

namestring

ソースのフィールド name

statusstring

ソースのフィールド status

targeting_criteriajson

ソースのフィールド targetingCriteria

created_atdatetime

ソースのフィールド createdAt

updated_atdatetime

ソースのフィールド updatedAt

ads#

titan.reddit_ads.ads には 6 個のソース列があります。

reddit_ads.ads6列
idstringpk

ソースのフィールド id

ad_group_idstring

ソースのフィールド adGroupId

namestring

ソースのフィールド name

statusstring

ソースのフィールド status

created_atdatetime

ソースのフィールド createdAt

updated_atdatetime

ソースのフィールド updatedAt

campaign_metrics#

titan.reddit_ads.campaign_metrics には 8 個のソース列があります。

reddit_ads.campaign_metrics8列
campaign_idstringpk

ソースのフィールド campaignId

datedatepk

ソースのフィールド date

impressionsinteger

ソースのフィールド impressions

clicksinteger

ソースのフィールド clicks

spendfloat

ソースのフィールド spend

ecpmfloat

ソースのフィールド ecpm

cpcfloat

ソースのフィールド cpc

ctrfloat

ソースのフィールド ctr

ad_group_metrics#

titan.reddit_ads.ad_group_metrics には 8 個のソース列があります。

reddit_ads.ad_group_metrics8列
ad_group_idstringpk

ソースのフィールド adGroupId

datedatepk

ソースのフィールド date

impressionsinteger

ソースのフィールド impressions

clicksinteger

ソースのフィールド clicks

spendfloat

ソースのフィールド spend

ecpmfloat

ソースのフィールド ecpm

cpcfloat

ソースのフィールド cpc

ctrfloat

ソースのフィールド ctr

ad_metrics#

titan.reddit_ads.ad_metrics には 8 個のソース列があります。

reddit_ads.ad_metrics8列
ad_idstringpk

ソースのフィールド adId

datedatepk

ソースのフィールド date

impressionsinteger

ソースのフィールド impressions

clicksinteger

ソースのフィールド clicks

spendfloat

ソースのフィールド spend

ecpmfloat

ソースのフィールド ecpm

cpcfloat

ソースのフィールド cpc

ctrfloat

ソースのフィールド ctr

削除と履歴#

行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して _deleted を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには where not _deleted で絞り込んでください。