LOGGER™는 콘솔 리포트와 같은 조회 기능을 REST API로 제공하므로, 방문 · 유입 · 전환 집계 수치를 사내 시스템과 마케팅 자동화 도구에서 정기적으로 불러올 수 있습니다. API 연동은 요금에 포함되어 있으며, 호출 한도는 서비스별 하루 1,000회(MCP와 합산)입니다. 따라서 집계 리포트를 정해진 주기로 조회하는 구조로 설계하고, 원본 행동 데이터를 실시간으로 공급해야 하는 경우에는 구축형 데이터 파이프라인을 검토합니다.
어떤 업무에 API 연동이 필요한가
웹분석 리포트는 담당자가 콘솔에 접속해 확인하는 것이 기본입니다. 그러나 매일 같은 수치를 확인해 메시지 발송 대상이나 광고 예산을 조정하는 업무라면, 수치를 사내 시스템이 직접 불러와 조건에 따라 다음 작업을 실행하도록 구성하는 편이 효율적입니다. 비즈스프링이 소개한 광고대행사 사례에서도 여러 매체의 성과 데이터를 매일 자동으로 수집하고 LOGGER™의 행동 데이터와 결합해, 수작업 보고서를 대시보드로 대체했습니다.
| 업무 | 필요한 데이터 | LOGGER 리포트 예 | 조회 주기 예시 |
|---|---|---|---|
| 장바구니 · 상담 이탈 대상 메시지 발송 | 전환 단계별 도달 · 이탈 수치 | 전환 퍼널 | 하루 1 ~ 2회 |
| 검색광고 예산 · 입찰 조정 | 키워드 · 매체별 주문 · 매출 | 검색광고 성과, 캠페인 성과 | 하루 1회 |
| 사내 BI · 경영 대시보드 | 방문 · 유입 · 매출 일별 합계 | 요약 대시보드, 방문 트래픽 분석 | 하루 1회 |
| 이상 징후 알림 | 전환율 · 방문수 · AI 유입 변화 | KPI 모니터링, AI 유입 분석 | 매일 아침 1회 |
| 캠페인 종료 후 정산 보고 | 캠페인별 방문 · 회원가입 · 주문 · 매출 | 캠페인 성과 | 캠페인 종료 시 1회 |
REST API로 데이터를 가져오는 순서
- 1
토큰 발급
POST /apis/v1/auth/token 에 로그인 ID, 비밀번호, scope(read)를 전송해 조회 전용 토큰을 받습니다. 토큰은 12시간 뒤 만료되므로 자동화 프로그램은 만료 전에 다시 발급하도록 구성합니다.
- 2
서비스 확인
GET /apis/v1/services 로 조회할 수 있는 서비스(loggerId) 목록을 확인합니다. 계정이 접근할 수 있는 서비스만 조회됩니다.
- 3
리포트와 스키마 확인
GET /v1/reports 로 리포트 코드를, GET /v1/reports/{code}/schema 로 차원 · 지표 · 필터를 확인합니다. 스키마는 자주 바뀌지 않으므로 한 번 확인한 뒤 프로그램에 저장해 두면 호출 수를 줄일 수 있습니다.
- 4
데이터 조회
GET /v1/reports/{code}/data 에 loggerId, 기간(ps · pe), groupBy, filter 를 지정해 조회합니다. groupBy 는 한 요청에 하나만 지정하고, 다른 기준은 filter 로 좁혀 조회합니다.
- 5
결과 저장과 활용
받은 집계 값을 사내 데이터베이스나 마케팅 자동화 도구에 저장하고, 미리 정한 조건에 해당할 때 메시지 발송 · 캠페인 조정 작업을 실행합니다.
하루 1,000회 한도 안에서 설계하는 원칙
호출 한도는 같은 서비스를 조회하는 모든 계정(주계정 · 부계정 · 파트너)의 호출을 합산합니다. 한도의 목적은 API를 데이터 대량 내보내기 용도로 쓰지 못하게 하는 것이므로, 자동화도 원본 행을 반복해서 가져오는 방식이 아니라 필요한 집계 값을 정해진 주기로 조회하는 방식으로 설계합니다.
- 조회할 리포트와 주기를 먼저 표로 정리하고 하루 호출 수를 계산합니다. 예시: 리포트 6종을 매일 아침 1회, 전환 퍼널을 하루 4회 조회하면 하루 10회입니다.
- 같은 날 여러 시스템이 같은 수치를 쓰면 한 번 조회한 결과를 사내 저장소에 두고 공유합니다.
- 잔여 호출 수는 GET /v1/usage?loggerId= 또는 응답 헤더 X-RateLimit-Remaining 으로 확인합니다.
- 429 응답을 받으면 재시도를 반복하지 말고 자정 이후에 다시 호출하도록 구성합니다.
마케팅 자동화 시나리오 예시
- 단계 1LOGGER 집계 조회정해진 시각에 REST API로 리포트 조회
- 단계 2조건 판단전환율 하락, 키워드 매출 변화 등 기준 비교
- 단계 3실행메시지 발송, 입찰 · 예산 조정, 알림
- 단계 4결과 재측정다음 조회에서 변화 확인
| 시나리오 | 판단 조건 예시 | 실행 작업 |
|---|---|---|
| 전환율 이상 알림 | 전환율이 최근 4주 같은 요일 평균보다 20% 이상 낮음 | 담당자 채널(Slack 등)에 근거 수치 전송 |
| 키워드 예산 재배분 | 키워드별 매출 대비 광고비 비율이 기준을 넘음 | 광고 관리 도구에서 입찰 조정 후보 목록 작성 |
| 상담 이탈 후속 연락 | 상담 양식 화면 도달 대비 상담 완료 비율 하락 | CRM 담당자에게 후속 연락 목록 전달 |
| 캠페인 종료 보고 | 캠페인 종료일 도래 | 캠페인별 방문 · 주문 · 매출 표를 보고서로 작성 |
개발 없이 시작하려면 Claude의 예약 작업에 LOGGER MCP와 Slack을 연결하는 방법도 있습니다. LOGGER 매뉴얼의 활용 사례는 매일 아침 어제 수치를 조회해 조건에 해당하는 날에만 Slack으로 알리는 지시문을 소개합니다. 실행은 도구가 맡고, 알림을 받은 담당자가 원인을 확인하고 조치를 판단합니다.
원본 행동 데이터가 실시간으로 필요하다면
REST API는 리포트 단위의 집계 값을 조회하는 통로입니다. 방문자가 페이지를 열 때마다 원본 이벤트를 사내 시스템으로 바로 전송하는 웹훅 방식이나, 모든 행동 로그를 사내 데이터 웨어하우스에 적재하는 방식은 API가 아니라 구축형(On-Premise) · 별도 구축 사업의 실시간 데이터 파이프라인으로 설계합니다.
- 일 · 주 단위 집계 수치로 판단하는 업무
- 사내 BI 대시보드의 정기 갱신
- 조건에 따른 알림 · 메시지 발송
- 추가 비용 없이 요금제 안에서 시작
- 방문 이벤트를 발생 즉시 사내 시스템에 전송해야 하는 경우
- 원본 행동 로그 전체를 데이터 웨어하우스 · AI 시스템에 적재하려는 경우
- 데이터를 외부 서버에 둘 수 없는 보안 정책
- 추천 · 개인화 모델 학습용 원천 데이터가 필요한 경우
자주 묻는 질문
Q. REST API는 별도 요금이 있나요?
없습니다. MCP와 REST API 연동은 LOGGER 요금에 포함되어 있으며, Basic(월 8,000원~, 월 5만 PV 기준, 부가세 별도)부터 이용할 수 있습니다.
Q. 하루 1,000회를 넘으면 어떻게 되나요?
429(RATE_LIMITED) 응답과 Retry-After 헤더가 반환됩니다. 재시도를 반복하지 말고 한국 시각 자정 이후에 다시 호출합니다. 같은 서비스를 조회하는 모든 계정의 호출이 합산되므로 여러 시스템이 함께 쓰면 조회 계획을 공유합니다.
Q. API로 원본 방문 로그 전체를 받을 수 있나요?
REST API는 리포트 단위의 집계 데이터를 조회하는 기능이며, 대량 내보내기 용도로 쓰지 못하도록 호출 한도를 두고 있습니다. 많은 자료는 콘솔의 리포트 다운로드 · 리포트 통합 다운로드를 이용하고, 원본 행동 데이터의 실시간 공급은 구축형 데이터 파이프라인으로 문의합니다.
Q. API로 LOGGER 설정을 바꿀 수 있나요?
REST API 연동 토큰은 조회 전용입니다. 캠페인 등 설정 변경은 LOGGER 콘솔에서 하거나, 읽기 · 쓰기 권한으로 연결한 MCP에서 현재 값과 변경할 값을 확인한 뒤 진행합니다.