Strona główna Supernova
Menu dokumentacji

Snapchat Ads#

Połącz Snapchat Ads przez OAuth, używając danych uwierzytelniających aplikacji i identyfikatora konta reklamowego. Źródło zapisuje 5 stałych tabel w schemacie titan.snapchat_ads.

sql
select
  id,
  ad_account_id,
  name
from titan.snapchat_ads.campaigns
limit 10

Połącz Snapchat Ads#

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

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

  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#

Kampanie, zestawy reklam i reklamy są synchronizowane wraz z odpowiadającymi im tabelami wyników.

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

snapchat_ads.campaigns9 kolumn
idstringpk

Pole źródłowe id.

ad_account_idstring

Pole źródłowe adAccountId.

namestring

Pole źródłowe name.

statusstring

Pole źródłowe status.

objectivestring

Pole źródłowe objective.

start_timedatetime

Pole źródłowe startTime.

end_timedatetime

Pole źródłowe endTime.

created_atdatetime

Pole źródłowe createdAt.

updated_atdatetime

Pole źródłowe updatedAt.

ad_squads#

titan.snapchat_ads.ad_squads ma 10 kolumn źródłowych.

snapchat_ads.ad_squads10 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.

typestring

Pole źródłowe type.

bid_microinteger

Pole źródłowe bidMicro.

daily_budget_microinteger

Pole źródłowe dailyBudgetMicro.

optimization_goalstring

Pole źródłowe optimizationGoal.

created_atdatetime

Pole źródłowe createdAt.

updated_atdatetime

Pole źródłowe updatedAt.

ads#

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

snapchat_ads.ads7 kolumn
idstringpk

Pole źródłowe id.

ad_squad_idstring

Pole źródłowe adSquadId.

namestring

Pole źródłowe name.

statusstring

Pole źródłowe status.

typestring

Pole źródłowe type.

created_atdatetime

Pole źródłowe createdAt.

updated_atdatetime

Pole źródłowe updatedAt.

campaign_stats#

titan.snapchat_ads.campaign_stats ma 6 kolumn źródłowych.

snapchat_ads.campaign_stats6 kolumn
campaign_idstringpk

Pole źródłowe campaignId.

start_timedatetimepk

Pole źródłowe startTime.

impressionsinteger

Pole źródłowe impressions.

swipesinteger

Pole źródłowe swipes.

spendfloat

Pole źródłowe spend.

video_viewsinteger

Pole źródłowe videoViews.

ad_squad_stats#

titan.snapchat_ads.ad_squad_stats ma 6 kolumn źródłowych.

snapchat_ads.ad_squad_stats6 kolumn
ad_squad_idstringpk

Pole źródłowe adSquadId.

start_timedatetimepk

Pole źródłowe startTime.

impressionsinteger

Pole źródłowe impressions.

swipesinteger

Pole źródłowe swipes.

spendfloat

Pole źródłowe spend.

video_viewsinteger

Pole źródłowe videoViews.

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.