---
title: Microsoft Ads
description: Microsoft Ads에 연결하고 동기화 동작을 파악하며 기록되는 모든 테이블과 열을 쿼리합니다.
species: reference
---
# Microsoft Ads

OAuth, 앱 자격 증명, 개발자 토큰, 계정 ID를 사용해 Microsoft Ads에 연결합니다. 이 소스는 `titan.microsoft_ads` 아래에 고정 테이블 6개를 기록합니다.
```sql
select
  id,
  account_id,
  name
from titan.microsoft_ads.campaigns
limit 10
```

## Microsoft Ads 연결

1. **앱**을 열고 **앱 연결**을 선택한 뒤 **Microsoft Ads** 항목을 선택합니다.
2. OAuth, 앱 자격 증명, 개발자 토큰, 계정 ID를 입력합니다.
3. 테이블을 확인한 뒤 소스를 저장합니다.
4. 첫 실행이 완료될 때까지 **동기화 기록**을 확인합니다.

자격 증명은 비밀 정보로 저장됩니다. 레이크 열이 되거나 쿼리 결과에 나타나지 않습니다.

## 동기화 동작

엔터티 테이블과 성과 보고서는 설정 중에 선택한 계정을 사용합니다.

새 소스는 연결할 때 동기화한 다음 설정된 일정을 따릅니다. 기본 반복 간격은 4시간입니다. 실행이 중단되어도 완료한 진행 상황을 유지하며 안전하게 재시도합니다.

모든 레이크 테이블에는 [시스템 열](/docs/concepts/your-lake#시스템-열)인 `_synced_at`과 `_deleted`도 있습니다. 아래 열 참조에는 소스 열만 나열합니다.

## 테이블 참조

### `campaigns`

`titan.microsoft_ads.campaigns`의 소스 열 수는 8개입니다.

```columns table=microsoft_ads.campaigns
id                                      string pk           `id` 소스 필드.
account_id                              string              `accountId` 소스 필드.
name                                    string              `name` 소스 필드.
status                                  string              `status` 소스 필드.
budget_type                             string              `budgetType` 소스 필드.
daily_budget                            float               `dailyBudget` 소스 필드.
start_date                              string              `startDate` 소스 필드.
end_date                                string              `endDate` 소스 필드.
```

### `ad_groups`

`titan.microsoft_ads.ad_groups`의 소스 열 수는 7개입니다.

```columns table=microsoft_ads.ad_groups
id                                      string pk           `id` 소스 필드.
campaign_id                             string              `campaignId` 소스 필드.
name                                    string              `name` 소스 필드.
status                                  string              `status` 소스 필드.
cpc_bid                                 float               `cpcBid` 소스 필드.
start_date                              string              `startDate` 소스 필드.
end_date                                string              `endDate` 소스 필드.
```

### `ads`

`titan.microsoft_ads.ads`의 소스 열 수는 7개입니다.

```columns table=microsoft_ads.ads
id                                      string pk           `id` 소스 필드.
ad_group_id                             string              `adGroupId` 소스 필드.
type                                    string              `type` 소스 필드.
title                                   string              `title` 소스 필드.
description                             string              `description` 소스 필드.
status                                  string              `status` 소스 필드.
final_urls                              json                `finalUrls` 소스 필드.
```

### `campaign_performance`

`titan.microsoft_ads.campaign_performance`의 소스 열 수는 8개입니다.

```columns table=microsoft_ads.campaign_performance
campaign_id                             string pk           `campaignId` 소스 필드.
time_period                             date pk             `timePeriod` 소스 필드.
impressions                             integer             `impressions` 소스 필드.
clicks                                  integer             `clicks` 소스 필드.
spend                                   float               `spend` 소스 필드.
average_cpc                             float               `averageCpc` 소스 필드.
ctr                                     float               `ctr` 소스 필드.
conversions                             integer             `conversions` 소스 필드.
```

### `ad_group_performance`

`titan.microsoft_ads.ad_group_performance`의 소스 열 수는 8개입니다.

```columns table=microsoft_ads.ad_group_performance
ad_group_id                             string pk           `adGroupId` 소스 필드.
time_period                             date pk             `timePeriod` 소스 필드.
impressions                             integer             `impressions` 소스 필드.
clicks                                  integer             `clicks` 소스 필드.
spend                                   float               `spend` 소스 필드.
average_cpc                             float               `averageCpc` 소스 필드.
ctr                                     float               `ctr` 소스 필드.
conversions                             integer             `conversions` 소스 필드.
```

### `keyword_performance`

`titan.microsoft_ads.keyword_performance`의 소스 열 수는 9개입니다.

```columns table=microsoft_ads.keyword_performance
keyword_id                              string pk           `keywordId` 소스 필드.
time_period                             date pk             `timePeriod` 소스 필드.
keyword_text                            string              `keywordText` 소스 필드.
ad_group_id                             string              `adGroupId` 소스 필드.
impressions                             integer             `impressions` 소스 필드.
clicks                                  integer             `clicks` 소스 필드.
spend                                   float               `spend` 소스 필드.
average_cpc                             float               `averageCpc` 소스 필드.
quality_score                           integer             `qualityScore` 소스 필드.
```

## 삭제와 이력

행은 소스 키로 병합됩니다. 소스에서 행 삭제를 입증할 수 있으면 Supernova는 행을 유지하고 `_deleted`를 설정합니다. 따라서 쿼리에서 이력을 포함할지 선택할 수 있습니다. 현재 상태를 조회하는 쿼리에는 `where not _deleted` 필터를 사용하세요.