Supernova 홈
문서 메뉴

Microsoft Ads#

OAuth, 앱 자격 증명, 개발자 토큰, 계정 ID를 사용해 Microsoft Ads에 연결합니다. 이 소스는 titan.microsoft_ads 아래에 고정 테이블 6개를 기록합니다.

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

Microsoft Ads 연결#

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

  2. OAuth, 앱 자격 증명, 개발자 토큰, 계정 ID를 입력합니다.

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

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

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

동기화 동작#

엔터티 테이블과 성과 보고서는 설정 중에 선택한 계정을 사용합니다.

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

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

테이블 참조#

campaigns#

titan.microsoft_ads.campaigns의 소스 열 수는 8개입니다.

microsoft_ads.campaigns열 8개
idstringpk

id 소스 필드.

account_idstring

accountId 소스 필드.

namestring

name 소스 필드.

statusstring

status 소스 필드.

budget_typestring

budgetType 소스 필드.

daily_budgetfloat

dailyBudget 소스 필드.

start_datestring

startDate 소스 필드.

end_datestring

endDate 소스 필드.

ad_groups#

titan.microsoft_ads.ad_groups의 소스 열 수는 7개입니다.

microsoft_ads.ad_groups열 7개
idstringpk

id 소스 필드.

campaign_idstring

campaignId 소스 필드.

namestring

name 소스 필드.

statusstring

status 소스 필드.

cpc_bidfloat

cpcBid 소스 필드.

start_datestring

startDate 소스 필드.

end_datestring

endDate 소스 필드.

ads#

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

microsoft_ads.ads열 7개
idstringpk

id 소스 필드.

ad_group_idstring

adGroupId 소스 필드.

typestring

type 소스 필드.

titlestring

title 소스 필드.

descriptionstring

description 소스 필드.

statusstring

status 소스 필드.

final_urlsjson

finalUrls 소스 필드.

campaign_performance#

titan.microsoft_ads.campaign_performance의 소스 열 수는 8개입니다.

microsoft_ads.campaign_performance열 8개
campaign_idstringpk

campaignId 소스 필드.

time_perioddatepk

timePeriod 소스 필드.

impressionsinteger

impressions 소스 필드.

clicksinteger

clicks 소스 필드.

spendfloat

spend 소스 필드.

average_cpcfloat

averageCpc 소스 필드.

ctrfloat

ctr 소스 필드.

conversionsinteger

conversions 소스 필드.

ad_group_performance#

titan.microsoft_ads.ad_group_performance의 소스 열 수는 8개입니다.

microsoft_ads.ad_group_performance열 8개
ad_group_idstringpk

adGroupId 소스 필드.

time_perioddatepk

timePeriod 소스 필드.

impressionsinteger

impressions 소스 필드.

clicksinteger

clicks 소스 필드.

spendfloat

spend 소스 필드.

average_cpcfloat

averageCpc 소스 필드.

ctrfloat

ctr 소스 필드.

conversionsinteger

conversions 소스 필드.

keyword_performance#

titan.microsoft_ads.keyword_performance의 소스 열 수는 9개입니다.

microsoft_ads.keyword_performance열 9개
keyword_idstringpk

keywordId 소스 필드.

time_perioddatepk

timePeriod 소스 필드.

keyword_textstring

keywordText 소스 필드.

ad_group_idstring

adGroupId 소스 필드.

impressionsinteger

impressions 소스 필드.

clicksinteger

clicks 소스 필드.

spendfloat

spend 소스 필드.

average_cpcfloat

averageCpc 소스 필드.

quality_scoreinteger

qualityScore 소스 필드.

삭제와 이력#

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