Documentation menu

Snapchat Ads#

Connect Snapchat Ads with OAuth using your app credentials plus an ad account id. The source writes 5 fixed tables under titan.snapchat_ads.

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

Connect Snapchat Ads#

  1. Open Apps, choose Connect app, and select Snapchat Ads.

  2. Enter OAuth using your app credentials plus an ad account id.

  3. Review the tables, then save the source.

  4. Watch Sync history until the first run completes.

Credentials are stored as secrets. They never become lake columns or appear in query results.

Sync behavior#

Campaign, ad squad, and ad entities sync beside their performance tables.

A new source syncs when you connect it and then follows its schedule. The default recurring interval is 4 hours. An interrupted run keeps its completed progress and retries safely.

Every lake table also has the system columns _synced_at and _deleted; the column reference below lists source columns only.

Table reference#

campaigns#

titan.snapchat_ads.campaigns has 9 source columns.

snapchat_ads.campaigns9 columns
idstringpk

Source field id.

ad_account_idstring

Source field adAccountId.

namestring

Source field name.

statusstring

Source field status.

objectivestring

Source field objective.

start_timedatetime

Source field startTime.

end_timedatetime

Source field endTime.

created_atdatetime

Source field createdAt.

updated_atdatetime

Source field updatedAt.

ad_squads#

titan.snapchat_ads.ad_squads has 10 source columns.

snapchat_ads.ad_squads10 columns
idstringpk

Source field id.

campaign_idstring

Source field campaignId.

namestring

Source field name.

statusstring

Source field status.

typestring

Source field type.

bid_microinteger

Source field bidMicro.

daily_budget_microinteger

Source field dailyBudgetMicro.

optimization_goalstring

Source field optimizationGoal.

created_atdatetime

Source field createdAt.

updated_atdatetime

Source field updatedAt.

ads#

titan.snapchat_ads.ads has 7 source columns.

snapchat_ads.ads7 columns
idstringpk

Source field id.

ad_squad_idstring

Source field adSquadId.

namestring

Source field name.

statusstring

Source field status.

typestring

Source field type.

created_atdatetime

Source field createdAt.

updated_atdatetime

Source field updatedAt.

campaign_stats#

titan.snapchat_ads.campaign_stats has 6 source columns.

snapchat_ads.campaign_stats6 columns
campaign_idstringpk

Source field campaignId.

start_timedatetimepk

Source field startTime.

impressionsinteger

Source field impressions.

swipesinteger

Source field swipes.

spendfloat

Source field spend.

video_viewsinteger

Source field videoViews.

ad_squad_stats#

titan.snapchat_ads.ad_squad_stats has 6 source columns.

snapchat_ads.ad_squad_stats6 columns
ad_squad_idstringpk

Source field adSquadId.

start_timedatetimepk

Source field startTime.

impressionsinteger

Source field impressions.

swipesinteger

Source field swipes.

spendfloat

Source field spend.

video_viewsinteger

Source field videoViews.

Deletes and history#

Rows are merged by their source key. When the source can prove that a row was deleted, Supernova keeps the row and sets _deleted so queries can choose whether to include history. Filter current-state queries with where not _deleted.