Menu dokumentacji

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 _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.

microsoft_ads.campaigns8 kolumn
idstringpk

Pole źródłowe id.

account_idstring

Pole źródłowe accountId.

namestring

Pole źródłowe name.

statusstring

Pole źródłowe status.

budget_typestring

Pole źródłowe budgetType.

daily_budgetfloat

Pole źródłowe dailyBudget.

start_datestring

Pole źródłowe startDate.

end_datestring

Pole źródłowe endDate.

ad_groups#

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

microsoft_ads.ad_groups7 kolumn
idstringpk

Pole źródłowe id.

campaign_idstring

Pole źródłowe campaignId.

namestring

Pole źródłowe name.

statusstring

Pole źródłowe status.

cpc_bidfloat

Pole źródłowe cpcBid.

start_datestring

Pole źródłowe startDate.

end_datestring

Pole źródłowe endDate.

ads#

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

microsoft_ads.ads7 kolumn
idstringpk

Pole źródłowe id.

ad_group_idstring

Pole źródłowe adGroupId.

typestring

Pole źródłowe type.

titlestring

Pole źródłowe title.

descriptionstring

Pole źródłowe description.

statusstring

Pole źródłowe status.

final_urlsjson

Pole źródłowe finalUrls.

campaign_performance#

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

microsoft_ads.campaign_performance8 kolumn
campaign_idstringpk

Pole źródłowe campaignId.

time_perioddatepk

Pole źródłowe timePeriod.

impressionsinteger

Pole źródłowe impressions.

clicksinteger

Pole źródłowe clicks.

spendfloat

Pole źródłowe spend.

average_cpcfloat

Pole źródłowe averageCpc.

ctrfloat

Pole źródłowe ctr.

conversionsinteger

Pole źródłowe conversions.

ad_group_performance#

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

microsoft_ads.ad_group_performance8 kolumn
ad_group_idstringpk

Pole źródłowe adGroupId.

time_perioddatepk

Pole źródłowe timePeriod.

impressionsinteger

Pole źródłowe impressions.

clicksinteger

Pole źródłowe clicks.

spendfloat

Pole źródłowe spend.

average_cpcfloat

Pole źródłowe averageCpc.

ctrfloat

Pole źródłowe ctr.

conversionsinteger

Pole źródłowe conversions.

keyword_performance#

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

microsoft_ads.keyword_performance9 kolumn
keyword_idstringpk

Pole źródłowe keywordId.

time_perioddatepk

Pole źródłowe timePeriod.

keyword_textstring

Pole źródłowe keywordText.

ad_group_idstring

Pole źródłowe adGroupId.

impressionsinteger

Pole źródłowe impressions.

clicksinteger

Pole źródłowe clicks.

spendfloat

Pole źródłowe spend.

average_cpcfloat

Pole źródłowe averageCpc.

quality_scoreinteger

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.