adstage
데이터 허브

예약 내보내기

데이터 허브 > 예약 내보내기 는 쿼리를 정해진 시각에 실행해 결과를 보냅니다. 조직 소유자·관리자만 만들고 바꿀 수 있습니다.

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 합니다.

{
  "task": { "id": "…", "name": "Daily channel summary" },
  "data": [ { "date": "2026-11-13", "datasource": "google_ads", "spend": 152000 } ],
  "meta": { "connector": "all", "date_from": "2026-11-13", "date_to": "2026-11-13", "currency": "KRW", "totals": { "spend": 152000 } }
}
헤더값
Content-Typeapplication/json 또는 text/csv; charset=utf-8
X-AdStage-Export-Id예약 내보내기 id
X-AdStage-Timestamp보낸 시각(유닉스 초)
X-AdStage-Signaturesha256= + HMAC-SHA256(서명 키, 타임스탬프 + . + 본문)

응답이 2xx 가 아니면 실패로 기록합니다. 리다이렉트는 따라가지 않습니다. 30초 안에 응답하세요.

3. 웹훅 서명 검증

웹훅을 만들면 서명 키(whsec_…)를 한 번 보여줍니다. 받는 쪽에서 아래처럼 검증하고, 타임스탬프가 5분 넘게 지난 요청은 버리세요.

Node.js

const crypto = require('crypto');
 
function verify(req, rawBody, secret) {
  const ts = req.headers['x-adstage-timestamp'];
  const sig = req.headers['x-adstage-signature'] || '';
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
  const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(`${ts}.${rawBody}`).digest('hex');
  return sig.length === expected.length && crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
}

Python

import hmac, hashlib, time
 
def verify(headers, raw_body: bytes, secret: str) -> bool:
    ts = headers["X-AdStage-Timestamp"]
    if abs(time.time() - int(ts)) > 300:
        return False
    expected = "sha256=" + hmac.new(secret.encode(), f"{ts}.".encode() + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(headers.get("X-AdStage-Signature", ""), expected)

4. 실행 기록과 실패

  • 목록에서 마지막 실행 시각·결과(SUCCESS + 행 수 / FAILED + 이유)와 다음 실행 시각을 볼 수 있습니다.
  • 지금 실행(▶)으로 바로 한 번 보내 볼 수 있습니다. 다음 예약 시각은 바뀌지 않습니다.
  • 실패해도 다음 주기에 다시 실행합니다. 10번 연속 실패하면 자동으로 꺼집니다. 원인(URL·수신자·필드)을 고친 뒤 다시 켜세요.
  • 수정할 때 URL 칸을 비워 두면 저장된 URL 을 그대로 씁니다(화면에는 URL 이 일부만 보입니다).

목차