데이터 허브
예약 내보내기
데이터 허브 > 예약 내보내기 는 쿼리를 정해진 시각에 실행해 결과를 보냅니다. 조직 소유자·관리자만 만들고 바꿀 수 있습니다.
1. 만들기
가장 쉬운 방법은 데이터 탐색기에서 쿼리를 확인한 뒤 예약 내보내기 버튼을 누르는 것입니다. 커넥터·필드·기간·필터가 채워진 양식이 열립니다.
| 항목 | 설명 |
|---|---|
| 이름 | 메일 제목·슬랙 메시지에 표시됩니다 |
| 대상 | 이메일(CSV 첨부), 슬랙, 웹훅(HTTPS POST) |
| 수신자 / URL | 이메일은 최대 10명. 슬랙은 https://hooks.slack.com/... Incoming Webhook URL. 웹훅은 https:// URL(사설망·IP 주소·localhost 불가) |
| 본문 형식 | 웹훅만: JSON 또는 CSV |
| 커넥터·필드 | 데이터 탐색기와 같습니다. 저장할 때 필드·필터를 검사해 오류면 저장되지 않습니다 |
| 계정 | 선택. 쉼표로 구분한 계정 id. 탐색기에서 계정을 골라 넘어오면 채워져 있고, 커넥터를 바꾸면 비워집니다. 비우면 전체 계정 |
| 기간 | 실행 시점 기준 프리셋. 매일 보내는 요약은 yesterday, 주간은 last_7d 가 알맞습니다 |
| 주기 | 매시간(매시 5분), 매일(지정 시 5분), 매주(지정 요일·시 5분). 시각은 조직 타임존 기준 |
| 사용 | 끄면 실행되지 않습니다 |
한 번에 최대 10,000행을 보냅니다. 조직당 최대 50개까지 만들 수 있습니다.
2. 목적지별 결과
이메일 — 제목 [AdStage] 이름 — 시작일 ~ 종료일, 본문에 합계 요약, 결과 전체를 CSV 로 첨부합니다(엑셀에서 한글이 깨지지 않도록 BOM 포함).
슬랙 — 이름·조직·기간·행 수, 합계, 처음 15행을 표로 보냅니다. 전체 데이터가 필요하면 이메일이나 웹훅을 쓰세요.
웹훅 — 지정한 URL 로 POST 합니다.
| 헤더 | 값 |
|---|---|
Content-Type | application/json 또는 text/csv; charset=utf-8 |
X-AdStage-Export-Id | 예약 내보내기 id |
X-AdStage-Timestamp | 보낸 시각(유닉스 초) |
X-AdStage-Signature | sha256= + HMAC-SHA256(서명 키, 타임스탬프 + . + 본문) |
응답이 2xx 가 아니면 실패로 기록합니다. 리다이렉트는 따라가지 않습니다. 30초 안에 응답하세요.
3. 웹훅 서명 검증
웹훅을 만들면 서명 키(whsec_…)를 한 번 보여줍니다. 받는 쪽에서 아래처럼 검증하고, 타임스탬프가 5분 넘게 지난 요청은 버리세요.
Node.js
Python
4. 실행 기록과 실패
- 목록에서 마지막 실행 시각·결과(
SUCCESS+ 행 수 /FAILED+ 이유)와 다음 실행 시각을 볼 수 있습니다. - 지금 실행(▶)으로 바로 한 번 보내 볼 수 있습니다. 다음 예약 시각은 바뀌지 않습니다.
- 실패해도 다음 주기에 다시 실행합니다. 10번 연속 실패하면 자동으로 꺼집니다. 원인(URL·수신자·필드)을 고친 뒤 다시 켜세요.
- 수정할 때 URL 칸을 비워 두면 저장된 URL 을 그대로 씁니다(화면에는 URL 이 일부만 보입니다).

