Command Center Analytics 이해하기
대부분의 호텔은 Completion Rate, Biggest Drop‑Off, Issues를 3분 안에 검토합니다.
이 가이드는 Command Center에서 AVA가 각 Analytics 차트를 어떻게 계산하는지 설명합니다. 또한 추가로 보일 수 있는 체크인 커버리지 카드도 설명합니다.
이동: Main Menu → Command Center → Analytics
Codex 또는 Claude용 MCP 설정 복사
이 작업은 1분도 걸리지 않습니다. 토큰은 수명이 짧고 현재 브라우저 세션을 사용합니다.
Analytics 데이터를 AI 클라이언트로 보내고 싶을 때 이 버튼을 사용하세요. 복사되는 토큰에는 전체 Streamliner MCP 범위도 포함됩니다. 지원되는 클라이언트는 다시 시작한 뒤 설정 도구를 사용할 수 있습니다. 복사가 끝나면 AVA가 해당 클라이언트용 붙여넣기 안내가 담긴 모달을 보여줍니다.
| 버튼 | 복사되는 내용 | 적합한 용도 |
|---|---|---|
| Copy Codex MCP Config | mcp_servers.streamliner가 포함된 TOML MCP 설정 | Codex |
| Copy Claude MCP Config | mcpServers.streamliner가 포함된 JSON MCP 설정 | Claude Code 또는 Claude Desktop |
-
Copy Codex MCP Config 또는 Copy Claude MCP Config를 클릭합니다.
-
버튼이 **Creating MCP token...**으로 바뀔 때까지 기다립니다.
-
모달에 표시되는 클라이언트별 안내를 읽습니다.
-
복사한 구성을 AI 클라이언트 구성 파일에 붙여넣습니다.
-
새 MCP 서버를 불러오도록 클라이언트를 다시 시작합니다.
✓ Claude 구성은 JSON을 사용합니다. ✓ Codex 구성은 TOML을 사용합니다. ✓ 두 구성 모두 수명이 짧은
STREAMLINER_MCP_TOKEN을 포함합니다.
이 변경 전에 토큰을 복사했다면 새 구성을 다시 복사하세요. 이전 토큰은 갱신할 때까지 이전 범위를 유지합니다.
Codex는 ~/.codex/config.toml을 사용합니다.
Claude는 Claude Desktop Developer config를 사용하며, 보통 claude_desktop_config.json입니다.
모달에 표시되는 내용
모달은 구성을 성공적으로 복사했음을 확인합니다. 그다음 해당 클라이언트의 파일 경로, 붙여넣기 위치, 다시 시작 단계를 보여줍니다.
Codex를 사용하는 경우
-
Codex를 실행하는 기기에서
~/.codex/config.toml을 엽니다. -
복사한 TOML 블록을 파일 최상위에 붙여넣습니다.
-
파일을 저장한 뒤 Codex를 다시 시작합니다.
✓
mcp_servers.streamliner가 이미 있으면 해당 섹션을 교체하세요.
Claude Desktop을 사용하는 경우
-
Claude Desktop을 엽니다.
-
Settings → Developer → Edit Config로 이동합니다.
-
복사한 JSON을
claude_desktop_config.json에 붙여넣습니다. -
파일을 저장한 뒤 Claude Desktop을 완전히 종료했다가 다시 엽니다.
✓ macOS에서는 파일이 보통
~/Library/Application Support/Claude/아래에 있습니다. ✓mcpServers가 이미 있으면streamliner항목만 병합하세요.
빠른 참조
| 보기 | 세션 기준 | 완료 기준 |
|---|---|---|
| Pre‑Arrival | Pre‑Arrival 단계에 도달한 모든 예약 | PRE_ARRIVAL 성공 |
| Check‑In → All | pre-arrival만 있는 예약을 제외하고 early check-in 또는 pre-registration을 포함한 체크인 흐름 단계가 있는 모든 예약 | CHECKIN, KEY_COLLECTION, 또는 GET_DOOR_LOCK_KEY 성공 |
| Check‑In → Early Check‑In | EARLY_CHECKIN_ATTEMPT 또는 ROOM_ASSIGNMENT_QUEUED | EARLY_CHECKIN_ATTEMPT 또는 ROOM_ASSIGNMENT_QUEUED 성공 |
| Check‑In → Pre‑Registration | Pre‑Registration 단계가 있는 모든 예약 | PRE_REGISTRATION 성공 |
| Check‑In → Full Check‑In | CHECKIN, KEY_COLLECTION, 또는 GET_DOOR_LOCK_KEY | CHECKIN, KEY_COLLECTION, 또는 GET_DOOR_LOCK_KEY 성공 |
| Check‑Out | 체크아웃 단계가 있는 모든 예약 | CHECKOUT 또는 COMPLETED_CHECKOUT_PAYMENT 성공 |
Analytics를 열고 보기 선택
-
Main Menu → Command Center로 이동합니다.
-
Analytics 탭을 선택합니다.
-
Pre‑Arrival, Check‑In, 또는 Check‑Out을 선택합니다.
-
Check‑In을 선택했다면 All Check‑Ins, Early Check‑In, Pre‑Registration, 또는 Full Check‑In 하위 탭을 사용합니다.
✓ 모든 차트가 해당 보기와 날짜 범위에 맞게 업데이트됩니다.
AVA가 세션을 만드는 방식
- 세션은 예약당 체크인 기록 1건입니다. 각 게스트를 따로 세지 않습니다.
- 해당 보기에서 최소 한 단계가 기록되면 세션에 포함됩니다.
- 실패한 단계도 합계에 포함되므로 이탈과 문제 지점을 확인할 수 있습니다.
Pre-arrival 세션은 All Check-Ins에 포함되지 않습니다. 해당 항목은 Pre‑Arrival 보기에서 확인하세요.
요약 카드(탭 상단)
| 카드 | 계산 방식 |
|---|---|
| Total Logs | 선택한 보기의 세션 수 |
| Completion Rate | 완료된 세션 ÷ 전체 로그 |
| Avg Completion Time | 첫 성공 단계(보통 Entry)부터 완료까지 걸린 시간 |
| Successful Check‑Ins / Check‑Outs | 해당 보기에서 완료된 세션 수 |
완료로 간주되는 기준은 보기마다 다릅니다. 위의 빠른 참조 표를 확인하세요.
기간을 비교하기 전에 어떤 세션이 완료로 계산되는지 이 표로 확인하세요.
Total Logs가 40이고 Successful Check‑Ins가 28이면 완료율은 **70%**입니다.
체크인 커버리지 카드
AVA가 PMS에서 커버리지 데이터를 받으면 Completion Rate 뒤에 두 개의 추가 카드가 표시될 수 있습니다. 이 기능은 AVA PMS, Cloudbeds, Opera, Mews, eZee에서 사용할 수 있습니다.
| 카드 | 표시 내용 | 중요한 이유 |
|---|---|---|
| Eligible Check-In Units | 선택한 기간의 고유한 confirmation 또는 sub-reservation 단위 수 | 커버리지 분모입니다 |
| AVA Check-In Share | 자격이 있는 단위 중 AVA가 한 번이라도 처리한 비율 | 해당 기간의 AVA 채택률을 보여줍니다 |
이 카드는 전체 예약이 아니라 단위를 집계합니다. 여러 객실이 포함된 예약은 자격이 있는 단위를 두 개 이상 추가할 수 있습니다.
PMS가 OPERA라면 AVA는 자격 단위 수에서 PM, PF, PX pseudo room을 제외합니다. 또한 객실 행 정보가 부족할 때는 상위 수준 객실 유형 필드를 사용하므로 실제 게스트 객실이 올바르게 집계됩니다.
AVA가 sessionsMapMeta.truncated를 true로 표시하면 해당 부분 맵은 무시합니다.
그다음 사용 가능한 경우 전체 체크인 로그를 사용해 점유율을 계산합니다.
AVA가 완전한 로그를 가져올 수 없으면 커버리지 카드는 숨겨집니다.
AVA는 처리된 각 예약을 한 번만 계산합니다. 맵이 완전할 때는 세션 맵을 사용합니다. 세션 맵이 없거나 잘렸다면 원시 로그 식별자를 대신 사용합니다. 이렇게 하면 AVA Check-In Share가 예약 커버리지와 맞게 유지됩니다. 이 값은 100% 이하로 유지되어야 합니다.
같은 날짜 범위를 다시 새로고침하면 AVA가 마지막 커버리지 결과를 잠시 재사용할 수 있습니다. 이렇게 하면 반복 확인 중에도 Analytics 탭이 빠르게 유지됩니다.
체크인 점유율이 이상해 보일 때
보이는 현상: AVA Check-In Share가 예상보다 높습니다.
해결:
- Analytics 탭을 새로고침합니다.
- 날짜 범위가 PMS 보고서와 일치하는지 확인합니다.
- 숙소가 지원되는 PMS를 사용하는지 확인합니다.
- 여전히 이상하면 스크린샷과 함께 지원팀에 문의합니다.
이 카드가 보이지 않으면 현재 PMS 데이터에 단위 커버리지 지표가 포함되어 있지 않을 수 있습니다. 지원되지 않는 PMS 제공업체에서는 이 카드가 표시되지 않습니다.
퍼널 차트(이탈과 단계 시간)
퍼널은 각 단계에 도달한 세션의 비율을 보여줍니다.
- Drop‑off는 각 단계를 바로 이전 단계와 비교합니다.
- Avg Stage Duration은 한 단계 안에서 보낸 시간을, 즉 단계 시작부터 성공까지의 시간을 측정합니다.
- Avg Time to Next Step은 한 성공 단계에서 다음 성공 단계까지 걸린 시간을 측정합니다.
- Slowest Step 카드는 먼저 단계 지속 시간을 사용합니다.
- AVA에 단계 시간이 없으면 다음 단계까지의 지속 시간으로 대체합니다.
- 나중 단계가 이전 단계보다 먼저 발생하면 소요 시간은 0으로 표시됩니다.
가장 먼저 코칭이 필요한 단계를 고르려면 Biggest Drop‑Off 카드를 사용하세요.
Document Upload가 60건이고 이전 단계가 100건이면 drop-off는 **40%**입니다. Document Upload 자체가 20초 걸리면 Avg Stage Duration은 20초입니다. Document Upload가 10:05에 완료되고 Validation이 10:07에 완료되면 Avg Time to Next Step은 2분입니다.
시간 분석(시간대별 볼륨)
Time Analysis는 선택한 보기에서 첫 성공 단계를 기준으로 세션을 묶습니다.
- 숙소의 시간대를 사용합니다.
- Pre‑Arrival은 성공한 PRE_ARRIVAL 단계가 필요합니다.
- 인력 배치를 돕기 위해 Peak Hours와 Rush Periods를 보여줍니다.
가장 바쁜 시간대의 인력 배치를 계획할 때 Peak Hours를 사용하세요.
현지 시각 7:10에 처음 성공한 세션은 07:00 시간대로 집계됩니다.
Issues(최근 실패)
Issues는 가장 최근에 실패한 단계가 있는 세션을 보여줍니다.
- AVA는 실패를 찾기 위해 최근 10개 이벤트를 확인합니다.
- 최근 실패가 없으면 기록상 가장 최근 실패를 사용합니다.
전체 단계 이력을 보려면 View Details를 사용하세요.
이전에 성공한 뒤 3:12에 결제가 실패하면 Issues에는 Payment가 3:12로 표시됩니다. 최근 10개 이벤트가 모두 성공이면 AVA는 기록상 가장 최근 실패를 표시합니다.
최근 활동
Recent Activity는 성공하거나 실패한 핵심 단계를 보여줍니다.
- Check‑In, Check‑Out
- Room Assignment
- Pre‑Registration
- Identity Verification
- Payment
이 목록은 최근 30개 항목까지만 표시됩니다.
가장 최근에 어떤 단계가 완료됐는지 확인할 때 이 목록을 사용하세요.
“Check‑In completed successfully” 또는 Identity Verification 실패 메시지를 볼 수 있습니다.