---
title: Reddit Ads
description: Reddit Adsを接続して同期の動作を把握し、書き込まれるすべてのテーブルと列をクエリします。
species: reference
---
# 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 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルには[システム列](/docs/concepts/your-lake#システム列) `_synced_at` と `_deleted` もあります。以下の列リファレンスにはソースの列のみを記載しています。

## テーブルリファレンス

### `campaigns`

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

```columns table=reddit_ads.campaigns
id                                      string pk           ソースのフィールド `id`。
name                                    string              ソースのフィールド `name`。
account_id                              string              ソースのフィールド `accountId`。
status                                  string              ソースのフィールド `status`。
objective                               string              ソースのフィールド `objective`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `ad_groups`

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

```columns table=reddit_ads.ad_groups
id                                      string pk           ソースのフィールド `id`。
campaign_id                             string              ソースのフィールド `campaignId`。
name                                    string              ソースのフィールド `name`。
status                                  string              ソースのフィールド `status`。
targeting_criteria                      json                ソースのフィールド `targetingCriteria`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `ads`

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

```columns table=reddit_ads.ads
id                                      string pk           ソースのフィールド `id`。
ad_group_id                             string              ソースのフィールド `adGroupId`。
name                                    string              ソースのフィールド `name`。
status                                  string              ソースのフィールド `status`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `campaign_metrics`

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

```columns table=reddit_ads.campaign_metrics
campaign_id                             string pk           ソースのフィールド `campaignId`。
date                                    date pk             ソースのフィールド `date`。
impressions                             integer             ソースのフィールド `impressions`。
clicks                                  integer             ソースのフィールド `clicks`。
spend                                   float               ソースのフィールド `spend`。
ecpm                                    float               ソースのフィールド `ecpm`。
cpc                                     float               ソースのフィールド `cpc`。
ctr                                     float               ソースのフィールド `ctr`。
```

### `ad_group_metrics`

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

```columns table=reddit_ads.ad_group_metrics
ad_group_id                             string pk           ソースのフィールド `adGroupId`。
date                                    date pk             ソースのフィールド `date`。
impressions                             integer             ソースのフィールド `impressions`。
clicks                                  integer             ソースのフィールド `clicks`。
spend                                   float               ソースのフィールド `spend`。
ecpm                                    float               ソースのフィールド `ecpm`。
cpc                                     float               ソースのフィールド `cpc`。
ctr                                     float               ソースのフィールド `ctr`。
```

### `ad_metrics`

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

```columns table=reddit_ads.ad_metrics
ad_id                                   string pk           ソースのフィールド `adId`。
date                                    date pk             ソースのフィールド `date`。
impressions                             integer             ソースのフィールド `impressions`。
clicks                                  integer             ソースのフィールド `clicks`。
spend                                   float               ソースのフィールド `spend`。
ecpm                                    float               ソースのフィールド `ecpm`。
cpc                                     float               ソースのフィールド `cpc`。
ctr                                     float               ソースのフィールド `ctr`。
```

## 削除と履歴

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