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.
select
id,
account_id,
name
from titan.microsoft_ads.campaigns
limit 10Połącz Microsoft Ads#
Otwórz Aplikacje, wybierz Połącz aplikację, a następnie Microsoft Ads.
Zaloguj się przez OAuth, a następnie podaj dane uwierzytelniające aplikacji, token deweloperski i identyfikator konta.
Sprawdź tabele, a następnie zapisz źródło.
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.
Pole źródłowe id.
Pole źródłowe accountId.
Pole źródłowe name.
Pole źródłowe status.
Pole źródłowe budgetType.
Pole źródłowe dailyBudget.
Pole źródłowe startDate.
Pole źródłowe endDate.
ad_groups#
titan.microsoft_ads.ad_groups ma 7 kolumn źródłowych.
Pole źródłowe id.
Pole źródłowe campaignId.
Pole źródłowe name.
Pole źródłowe status.
Pole źródłowe cpcBid.
Pole źródłowe startDate.
Pole źródłowe endDate.
ads#
titan.microsoft_ads.ads ma 7 kolumn źródłowych.
Pole źródłowe id.
Pole źródłowe adGroupId.
Pole źródłowe type.
Pole źródłowe title.
Pole źródłowe description.
Pole źródłowe status.
Pole źródłowe finalUrls.
campaign_performance#
titan.microsoft_ads.campaign_performance ma 8 kolumn źródłowych.
Pole źródłowe campaignId.
Pole źródłowe timePeriod.
Pole źródłowe impressions.
Pole źródłowe clicks.
Pole źródłowe spend.
Pole źródłowe averageCpc.
Pole źródłowe ctr.
Pole źródłowe conversions.
ad_group_performance#
titan.microsoft_ads.ad_group_performance ma 8 kolumn źródłowych.
Pole źródłowe adGroupId.
Pole źródłowe timePeriod.
Pole źródłowe impressions.
Pole źródłowe clicks.
Pole źródłowe spend.
Pole źródłowe averageCpc.
Pole źródłowe ctr.
Pole źródłowe conversions.
keyword_performance#
titan.microsoft_ads.keyword_performance ma 9 kolumn źródłowych.
Pole źródłowe keywordId.
Pole źródłowe timePeriod.
Pole źródłowe keywordText.
Pole źródłowe adGroupId.
Pole źródłowe impressions.
Pole źródłowe clicks.
Pole źródłowe spend.
Pole źródłowe averageCpc.
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.