데이터 허브
데이터 탐색기
데이터 허브 > 데이터 탐색기 는 쿼리를 만들어 바로 결과를 보는 화면입니다. 여기서 만든 쿼리는 그대로 구글 시트 수식, API URL, 예약 내보내기로 옮길 수 있습니다.
1. 쿼리 만들기
- 커넥터 —
all(전체 통합),adstage, 또는 광고 매체 하나를 고릅니다. 커넥터 화면의 데이터 조회 버튼으로 들어오면 미리 선택돼 있습니다. - 필드 — 차원(날짜·캠페인·광고 세트 등)과 지표(광고비·클릭·설치 등)를 체크합니다. 체크한 순서가 결과 컬럼 순서입니다.
- 기본 목록은 windsor.ai 와 같은 이름(
campaign,adset,ad_name,clicks,cpc,cpm,conversions…)입니다. 리포트 필드 전체 보기를 켜면 어트리뷰션 리포트의 모든 지표·차원이 나옵니다. - 필드 옆의 광고 매체 표시는 매체 비용 데이터, AdStage 표시는 SDK 이벤트 데이터입니다.
- 이벤트 지표는 아래 입력란에
purchase_count_total,sign_up_count_app,purchase_value_total처럼 입력해 추가합니다.
- 기본 목록은 windsor.ai 와 같은 이름(
- 기간 — 프리셋(어제, 최근 7/14/30/90일, 이번 달, 지난달, 올해, 최근 12개월) 또는 직접 지정. 프리셋은 조직 타임존 기준 어제까지입니다(오늘은 수집 중인 부분 데이터). 한 번에 최대 366일.
- 필터(선택) — 필드·연산자·값을 고르고, 두 번째 줄부터
AND/OR를 눌러 바꿀 수 있습니다. 복잡한 조건은 JSON 편집에서 windsor.ai 문법으로 씁니다(필터 문법). - 계정(선택) — 연결된 광고 계정 중 일부만 고릅니다. 비우면 전체입니다.
- 최대 행 수(기본 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. 자주 쓰는 쿼리 예
| 목적 | 커넥터 | 필드 |
|---|---|---|
| 채널별 일간 성과 | all | date, datasource, spend, impressions, clicks, installs, revenue, roas_adstage |
| 메타 광고 세트 효율 | facebook | campaign, adset, spend, impressions, clicks, ctr, cpm, conversions, purchases |
| 구글 키워드 비용 | google_ads | campaign, keyword, match_type, spend, clicks, cpc, conversions |
| 네이버 검색어 분석 | naver_searchad | keyword, search_term, spend, clicks, cpc |
| 오가닉 포함 가입·구매 | adstage | date, source, signups, purchases, revenue |
| 게재면(인스타/페북) 비교 | facebook | placement, spend, clicks, installs, revenue |

