---
title: Microsoft Ads
description: Połącz Microsoft Ads, poznaj sposób synchronizacji i wysyłaj zapytania do wszystkich zapisywanych tabel i kolumn.
species: reference
---
# Microsoft Ads

Połącz Microsoft Ads przez OAuth, używając danych uwierzytelniających aplikacji, tokenu deweloperskiego i identyfikatora konta. Źródło zapisuje 6 stałych tabel w schemacie `titan.microsoft_ads`.
```sql
select
  id,
  account_id,
  name
from titan.microsoft_ads.campaigns
limit 10
```

## Połącz Microsoft Ads

1. Otwórz **Aplikacje**, wybierz **Połącz aplikację**, a następnie **Microsoft Ads**.
2. Zaloguj się przez OAuth, a następnie podaj dane uwierzytelniające aplikacji, token deweloperski i identyfikator konta.
3. Sprawdź tabele, a następnie zapisz źródło.
4. Obserwuj **Historię synchronizacji**, aż pierwsze uruchomienie się zakończy.

Dane uwierzytelniające są przechowywane jako sekrety. Nigdy nie stają się kolumnami jeziora ani nie pojawiają się w wynikach zapytań.

## Sposób synchronizacji

Tabele encji i raporty wyników korzystają z konta wybranego podczas konfiguracji.

Nowe źródło synchronizuje się po połączeniu, a następnie zgodnie z harmonogramem. Domyślny interwał cykliczny wynosi 4 godziny. Przerwane uruchomienie zachowuje ukończone postępy i jest bezpiecznie ponawiane.

Każda tabela jeziora ma też [kolumny systemowe](/docs/concepts/your-lake#kolumny-systemowe) `_synced_at` i `_deleted`; poniższa dokumentacja kolumn obejmuje wyłącznie kolumny źródłowe.

## Dokumentacja tabel

### `campaigns`

`titan.microsoft_ads.campaigns` ma 8 kolumn źródłowych.

```columns table=microsoft_ads.campaigns
id                                      string pk           Pole źródłowe `id`.
account_id                              string              Pole źródłowe `accountId`.
name                                    string              Pole źródłowe `name`.
status                                  string              Pole źródłowe `status`.
budget_type                             string              Pole źródłowe `budgetType`.
daily_budget                            float               Pole źródłowe `dailyBudget`.
start_date                              string              Pole źródłowe `startDate`.
end_date                                string              Pole źródłowe `endDate`.
```

### `ad_groups`

`titan.microsoft_ads.ad_groups` ma 7 kolumn źródłowych.

```columns table=microsoft_ads.ad_groups
id                                      string pk           Pole źródłowe `id`.
campaign_id                             string              Pole źródłowe `campaignId`.
name                                    string              Pole źródłowe `name`.
status                                  string              Pole źródłowe `status`.
cpc_bid                                 float               Pole źródłowe `cpcBid`.
start_date                              string              Pole źródłowe `startDate`.
end_date                                string              Pole źródłowe `endDate`.
```

### `ads`

`titan.microsoft_ads.ads` ma 7 kolumn źródłowych.

```columns table=microsoft_ads.ads
id                                      string pk           Pole źródłowe `id`.
ad_group_id                             string              Pole źródłowe `adGroupId`.
type                                    string              Pole źródłowe `type`.
title                                   string              Pole źródłowe `title`.
description                             string              Pole źródłowe `description`.
status                                  string              Pole źródłowe `status`.
final_urls                              json                Pole źródłowe `finalUrls`.
```

### `campaign_performance`

`titan.microsoft_ads.campaign_performance` ma 8 kolumn źródłowych.

```columns table=microsoft_ads.campaign_performance
campaign_id                             string pk           Pole źródłowe `campaignId`.
time_period                             date pk             Pole źródłowe `timePeriod`.
impressions                             integer             Pole źródłowe `impressions`.
clicks                                  integer             Pole źródłowe `clicks`.
spend                                   float               Pole źródłowe `spend`.
average_cpc                             float               Pole źródłowe `averageCpc`.
ctr                                     float               Pole źródłowe `ctr`.
conversions                             integer             Pole źródłowe `conversions`.
```

### `ad_group_performance`

`titan.microsoft_ads.ad_group_performance` ma 8 kolumn źródłowych.

```columns table=microsoft_ads.ad_group_performance
ad_group_id                             string pk           Pole źródłowe `adGroupId`.
time_period                             date pk             Pole źródłowe `timePeriod`.
impressions                             integer             Pole źródłowe `impressions`.
clicks                                  integer             Pole źródłowe `clicks`.
spend                                   float               Pole źródłowe `spend`.
average_cpc                             float               Pole źródłowe `averageCpc`.
ctr                                     float               Pole źródłowe `ctr`.
conversions                             integer             Pole źródłowe `conversions`.
```

### `keyword_performance`

`titan.microsoft_ads.keyword_performance` ma 9 kolumn źródłowych.

```columns table=microsoft_ads.keyword_performance
keyword_id                              string pk           Pole źródłowe `keywordId`.
time_period                             date pk             Pole źródłowe `timePeriod`.
keyword_text                            string              Pole źródłowe `keywordText`.
ad_group_id                             string              Pole źródłowe `adGroupId`.
impressions                             integer             Pole źródłowe `impressions`.
clicks                                  integer             Pole źródłowe `clicks`.
spend                                   float               Pole źródłowe `spend`.
average_cpc                             float               Pole źródłowe `averageCpc`.
quality_score                           integer             Pole źródłowe `qualityScore`.
```

## Usunięcia i historia

Wiersze są scalane według klucza źródłowego. Gdy źródło może potwierdzić usunięcie wiersza, Supernova zachowuje go i ustawia `_deleted`, dzięki czemu zapytania mogą zdecydować, czy uwzględniać historię. Aby pobierać bieżący stan, filtruj zapytania przez `where not _deleted`.