Supernova 홈
문서 메뉴

Snapchat Ads#

앱 자격 증명을 사용하는 OAuth와 광고 계정 ID를 사용해 Snapchat Ads에 연결합니다. 이 소스는 titan.snapchat_ads 아래에 고정 테이블 5개를 기록합니다.

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

Snapchat Ads 연결#

  1. 앱을 열고 앱 연결을 선택한 뒤 Snapchat Ads 항목을 선택합니다.

  2. 앱 자격 증명을 사용하는 OAuth와 광고 계정 ID를 입력합니다.

  3. 테이블을 확인한 뒤 소스를 저장합니다.

  4. 첫 실행이 완료될 때까지 동기화 기록을 확인합니다.

자격 증명은 비밀 정보로 저장됩니다. 레이크 열이 되거나 쿼리 결과에 나타나지 않습니다.

동기화 동작#

캠페인, 광고 스쿼드, 광고 엔터티를 각 성과 테이블과 함께 동기화합니다.

새 소스는 연결할 때 동기화한 다음 설정된 일정을 따릅니다. 기본 반복 간격은 4시간입니다. 실행이 중단되어도 완료한 진행 상황을 유지하며 안전하게 재시도합니다.

모든 레이크 테이블에는 시스템 열인 _synced_at과 _deleted도 있습니다. 아래 열 참조에는 소스 열만 나열합니다.

테이블 참조#

campaigns#

titan.snapchat_ads.campaigns의 소스 열 수는 9개입니다.

snapchat_ads.campaigns열 9개
idstringpk

id 소스 필드.

ad_account_idstring

adAccountId 소스 필드.

namestring

name 소스 필드.

statusstring

status 소스 필드.

objectivestring

objective 소스 필드.

start_timedatetime

startTime 소스 필드.

end_timedatetime

endTime 소스 필드.

created_atdatetime

createdAt 소스 필드.

updated_atdatetime

updatedAt 소스 필드.

ad_squads#

titan.snapchat_ads.ad_squads의 소스 열 수는 10개입니다.

snapchat_ads.ad_squads열 10개
idstringpk

id 소스 필드.

campaign_idstring

campaignId 소스 필드.

namestring

name 소스 필드.

statusstring

status 소스 필드.

typestring

type 소스 필드.

bid_microinteger

bidMicro 소스 필드.

daily_budget_microinteger

dailyBudgetMicro 소스 필드.

optimization_goalstring

optimizationGoal 소스 필드.

created_atdatetime

createdAt 소스 필드.

updated_atdatetime

updatedAt 소스 필드.

ads#

titan.snapchat_ads.ads의 소스 열 수는 7개입니다.

snapchat_ads.ads열 7개
idstringpk

id 소스 필드.

ad_squad_idstring

adSquadId 소스 필드.

namestring

name 소스 필드.

statusstring

status 소스 필드.

typestring

type 소스 필드.

created_atdatetime

createdAt 소스 필드.

updated_atdatetime

updatedAt 소스 필드.

campaign_stats#

titan.snapchat_ads.campaign_stats의 소스 열 수는 6개입니다.

snapchat_ads.campaign_stats열 6개
campaign_idstringpk

campaignId 소스 필드.

start_timedatetimepk

startTime 소스 필드.

impressionsinteger

impressions 소스 필드.

swipesinteger

swipes 소스 필드.

spendfloat

spend 소스 필드.

video_viewsinteger

videoViews 소스 필드.

ad_squad_stats#

titan.snapchat_ads.ad_squad_stats의 소스 열 수는 6개입니다.

snapchat_ads.ad_squad_stats열 6개
ad_squad_idstringpk

adSquadId 소스 필드.

start_timedatetimepk

startTime 소스 필드.

impressionsinteger

impressions 소스 필드.

swipesinteger

swipes 소스 필드.

spendfloat

spend 소스 필드.

video_viewsinteger

videoViews 소스 필드.

삭제와 이력#

행은 소스 키로 병합됩니다. 소스에서 행 삭제를 입증할 수 있으면 Supernova는 행을 유지하고 _deleted를 설정합니다. 따라서 쿼리에서 이력을 포함할지 선택할 수 있습니다. 현재 상태를 조회하는 쿼리에는 where not _deleted 필터를 사용하세요.