Strona główna Supernova
Menu dokumentacji

Reddit Ads#

Połącz Reddit Ads przez OAuth, używając danych uwierzytelniających aplikacji i identyfikatora reklamodawcy. Źródło zapisuje 6 stałych tabel w schemacie titan.reddit_ads.

sql
select
  id,
  name,
  account_id
from titan.reddit_ads.campaigns
limit 10

Połącz Reddit Ads#

  1. Otwórz Aplikacje, wybierz Połącz aplikację, a następnie Reddit Ads.

  2. Zaloguj się przez OAuth, używając danych uwierzytelniających aplikacji, i podaj identyfikator reklamodawcy.

  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#

Podczas konfiguracji wybierz początkowy zakres historii. Tabele encji i metryk pozostają ograniczone do wybranego reklamodawcy.

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.reddit_ads.campaigns ma 7 kolumn źródłowych.

reddit_ads.campaigns7 kolumn
idstringpk

Pole źródłowe id.

namestring

Pole źródłowe name.

account_idstring

Pole źródłowe accountId.

statusstring

Pole źródłowe status.

objectivestring

Pole źródłowe objective.

created_atdatetime

Pole źródłowe createdAt.

updated_atdatetime

Pole źródłowe updatedAt.

ad_groups#

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

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

targeting_criteriajson

Pole źródłowe targetingCriteria.

created_atdatetime

Pole źródłowe createdAt.

updated_atdatetime

Pole źródłowe updatedAt.

ads#

titan.reddit_ads.ads ma 6 kolumn źródłowych.

reddit_ads.ads6 kolumn
idstringpk

Pole źródłowe id.

ad_group_idstring

Pole źródłowe adGroupId.

namestring

Pole źródłowe name.

statusstring

Pole źródłowe status.

created_atdatetime

Pole źródłowe createdAt.

updated_atdatetime

Pole źródłowe updatedAt.

campaign_metrics#

titan.reddit_ads.campaign_metrics ma 8 kolumn źródłowych.

reddit_ads.campaign_metrics8 kolumn
campaign_idstringpk

Pole źródłowe campaignId.

datedatepk

Pole źródłowe date.

impressionsinteger

Pole źródłowe impressions.

clicksinteger

Pole źródłowe clicks.

spendfloat

Pole źródłowe spend.

ecpmfloat

Pole źródłowe ecpm.

cpcfloat

Pole źródłowe cpc.

ctrfloat

Pole źródłowe ctr.

ad_group_metrics#

titan.reddit_ads.ad_group_metrics ma 8 kolumn źródłowych.

reddit_ads.ad_group_metrics8 kolumn
ad_group_idstringpk

Pole źródłowe adGroupId.

datedatepk

Pole źródłowe date.

impressionsinteger

Pole źródłowe impressions.

clicksinteger

Pole źródłowe clicks.

spendfloat

Pole źródłowe spend.

ecpmfloat

Pole źródłowe ecpm.

cpcfloat

Pole źródłowe cpc.

ctrfloat

Pole źródłowe ctr.

ad_metrics#

titan.reddit_ads.ad_metrics ma 8 kolumn źródłowych.

reddit_ads.ad_metrics8 kolumn
ad_idstringpk

Pole źródłowe adId.

datedatepk

Pole źródłowe date.

impressionsinteger

Pole źródłowe impressions.

clicksinteger

Pole źródłowe clicks.

spendfloat

Pole źródłowe spend.

ecpmfloat

Pole źródłowe ecpm.

cpcfloat

Pole źródłowe cpc.

ctrfloat

Pole źródłowe ctr.

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.