adstage
데이터 허브

데이터 탐색기

데이터 허브 > 데이터 탐색기 는 쿼리를 만들어 바로 결과를 보는 화면입니다. 여기서 만든 쿼리는 그대로 구글 시트 수식, API URL, 예약 내보내기로 옮길 수 있습니다.

1. 쿼리 만들기

  1. 커넥터 — all(전체 통합), adstage, 또는 광고 매체 하나를 고릅니다. 커넥터 화면의 데이터 조회 버튼으로 들어오면 미리 선택돼 있습니다.
  2. 필드 — 차원(날짜·캠페인·광고 세트 등)과 지표(광고비·클릭·설치 등)를 체크합니다. 체크한 순서가 결과 컬럼 순서입니다.
    • 기본 목록은 windsor.ai 와 같은 이름(campaign, adset, ad_name, clicks, cpc, cpm, conversions …)입니다. 리포트 필드 전체 보기를 켜면 어트리뷰션 리포트의 모든 지표·차원이 나옵니다.
    • 필드 옆의 광고 매체 표시는 매체 비용 데이터, AdStage 표시는 SDK 이벤트 데이터입니다.
    • 이벤트 지표는 아래 입력란에 purchase_count_total, sign_up_count_app, purchase_value_total 처럼 입력해 추가합니다.
  3. 기간 — 프리셋(어제, 최근 7/14/30/90일, 이번 달, 지난달, 올해, 최근 12개월) 또는 직접 지정. 프리셋은 조직 타임존 기준 어제까지입니다(오늘은 수집 중인 부분 데이터). 한 번에 최대 366일.
  4. 필터(선택) — 필드·연산자·값을 고르고, 두 번째 줄부터 AND/OR 를 눌러 바꿀 수 있습니다. 복잡한 조건은 JSON 편집에서 windsor.ai 문법으로 씁니다(필터 문법).
  5. 계정(선택) — 연결된 광고 계정 중 일부만 고릅니다. 비우면 전체입니다.
  6. 최대 행 수(기본 1,000, 최대 10,000)와 정렬을 정하고 쿼리 실행을 누릅니다.

2. 결과 보기

  • 표 아래 합계 행은 조건에 맞는 전체 행 기준입니다(화면에 보이는 행만이 아닙니다). 지표 비교(예: spend > 100000)나 OR 필터가 있으면 합계를 생략합니다.
  • 금액은 조직 기준 통화, roas*·ctr·cvr* 같은 PERCENT 필드는 ×100 값입니다(250 = 2.5배).
  • 지표가 모두 0인 행은 빠집니다(날짜만 고른 경우는 0도 표시).
  • CSV 버튼으로 결과를 내려받습니다(엑셀에서 한글이 깨지지 않도록 BOM 포함).
  • 화면에는 처음 500행까지만 그립니다. 그보다 많으면 표 아래에 안내가 나오며, CSV 에는 조회한 행 전체가 들어갑니다.

3. 다른 곳에서 같은 쿼리 쓰기

버튼결과
구글 시트 수식=IMPORTDATA("https://api.adstage.app/datahub/v1/...&_renderer=csv") — 셀에 붙여 넣으면 표가 채워집니다
CSV URL / JSON URL엑셀·Power BI·Python·직접 만든 스크립트용 주소
예약 내보내기같은 커넥터·필드·기간·필터로 예약 내보내기 양식을 엽니다

복사한 URL 의 YOUR_DATA_API_KEY 자리에 데이터 API 키를 넣어야 동작합니다.

4. 자주 쓰는 쿼리 예

목적커넥터필드
채널별 일간 성과alldate, datasource, spend, impressions, clicks, installs, revenue, roas_adstage
메타 광고 세트 효율facebookcampaign, adset, spend, impressions, clicks, ctr, cpm, conversions, purchases
구글 키워드 비용google_adscampaign, keyword, match_type, spend, clicks, cpc, conversions
네이버 검색어 분석naver_searchadkeyword, search_term, spend, clicks, cpc
오가닉 포함 가입·구매adstagedate, source, signups, purchases, revenue
게재면(인스타/페북) 비교facebookplacement, spend, clicks, installs, revenue

목차