---
title: Snapchat Ads
description: Snapchat Adsを接続して同期の動作を把握し、書き込まれるすべてのテーブルと列をクエリします。
species: reference
---
# Snapchat Ads

アプリの認証情報を使う OAuth と広告アカウント ID で Snapchat Ads を接続します。このソースは `titan.snapchat_ads` に 5 個の固定テーブルを書き込みます。
```sql
select
  id,
  ad_account_id,
  name
from titan.snapchat_ads.campaigns
limit 10
```

## Snapchat Adsを接続する

1. **アプリ**を開き、**アプリを接続**を選択してから、**Snapchat Ads**を選択します。
2. アプリの認証情報を使って OAuth 認証を行い、広告アカウント ID を入力します。
3. テーブルを確認してからソースを保存します。
4. 初回の実行が完了するまで**同期履歴**を確認します。

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

## 同期の動作

キャンペーン、広告セット、広告のエンティティを、それぞれのパフォーマンステーブルとともに同期します。

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

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

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

### `campaigns`

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

```columns table=snapchat_ads.campaigns
id                                      string pk           ソースのフィールド `id`。
ad_account_id                           string              ソースのフィールド `adAccountId`。
name                                    string              ソースのフィールド `name`。
status                                  string              ソースのフィールド `status`。
objective                               string              ソースのフィールド `objective`。
start_time                              datetime            ソースのフィールド `startTime`。
end_time                                datetime            ソースのフィールド `endTime`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `ad_squads`

`titan.snapchat_ads.ad_squads` には 10 個のソース列があります。

```columns table=snapchat_ads.ad_squads
id                                      string pk           ソースのフィールド `id`。
campaign_id                             string              ソースのフィールド `campaignId`。
name                                    string              ソースのフィールド `name`。
status                                  string              ソースのフィールド `status`。
type                                    string              ソースのフィールド `type`。
bid_micro                               integer             ソースのフィールド `bidMicro`。
daily_budget_micro                      integer             ソースのフィールド `dailyBudgetMicro`。
optimization_goal                       string              ソースのフィールド `optimizationGoal`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `ads`

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

```columns table=snapchat_ads.ads
id                                      string pk           ソースのフィールド `id`。
ad_squad_id                             string              ソースのフィールド `adSquadId`。
name                                    string              ソースのフィールド `name`。
status                                  string              ソースのフィールド `status`。
type                                    string              ソースのフィールド `type`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `campaign_stats`

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

```columns table=snapchat_ads.campaign_stats
campaign_id                             string pk           ソースのフィールド `campaignId`。
start_time                              datetime pk         ソースのフィールド `startTime`。
impressions                             integer             ソースのフィールド `impressions`。
swipes                                  integer             ソースのフィールド `swipes`。
spend                                   float               ソースのフィールド `spend`。
video_views                             integer             ソースのフィールド `videoViews`。
```

### `ad_squad_stats`

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

```columns table=snapchat_ads.ad_squad_stats
ad_squad_id                             string pk           ソースのフィールド `adSquadId`。
start_time                              datetime pk         ソースのフィールド `startTime`。
impressions                             integer             ソースのフィールド `impressions`。
swipes                                  integer             ソースのフィールド `swipes`。
spend                                   float               ソースのフィールド `spend`。
video_views                             integer             ソースのフィールド `videoViews`。
```

## 削除と履歴

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