ドキュメントメニュー

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. 初回の実行が完了するまで同期履歴を確認します。

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

同期の動作#

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

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトのスケジュールでは、組織のタイムゾーンで平日の 5:00、10:00、15:00、20:00 と日曜日の 20:00 に同期し、各ソースはその時刻から 30 分以内に開始します。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _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 で絞り込んでください。