본문으로 건너뛰기

Command Center 분석 이해하기

빠른 설정

대부분의 호텔은 3분 이내에 Completion Rate, Biggest Drop-Off, Issues를 확인합니다.

이 안내서는 Command Center의 각 Analytics 차트가 어떻게 계산되는지 설명합니다. 추가로 보일 수 있는 체크인 커버리지 카드와 STB EVA 내보내기도 설명합니다.

이동 경로: Main Menu → Command Center → Analytics

더 빠른 분석 로딩

이제 이 탭은 더 넓은 날짜 범위를 더 빠르게 읽기 위해 일별 롤업을 사용합니다. 롤업 데이터가 없거나 롤업 호출이 실패하면 AVA는 실시간 경로로 되돌아갑니다.

큰 날짜 범위는 더 오래 걸릴 수 있음

큰 날짜 범위는 여전히 로드가 오래 걸릴 수 있습니다. 매우 바쁜 숙소에서는 멈춘 것처럼 보이기 전에 더 좁은 날짜 범위 오류가 먼저 반환될 수 있습니다. 이것은 Analytics 탭에만 적용됩니다.

데모 세션

데모 체크인은 Status와 예약 상세에 계속 표시됩니다. 하지만 Analytics의 총계, 이탈, 시간 분석, 이슈, 최근 활동에는 포함되지 않습니다.

보고서 다운로드 없음

주요 Analytics 차트에는 브라우저 PDF 다운로드가 없습니다. STB EVA submissions 패널이 보이면 다운로드 아이콘으로 CSV를 내보낼 수 있습니다. 이 내보내기는 대시보드 집계와 동일한 EVA 제출 로그 소스를 사용합니다.

Codex 또는 Claude용 MCP 설정 복사​

빠른 설정

이 작업은 1분이 채 걸리지 않습니다. 토큰은 짧게 유지되며 현재 브라우저 세션을 사용합니다.

Analytics 데이터를 AI 클라이언트로 보내고 싶을 때 이 버튼을 사용하세요. 복사된 토큰에는 전체 Streamliner MCP 범위도 포함됩니다. 지원되는 클라이언트는 재시작 후 설정 도구를 사용할 수 있습니다. 복사하면 AVA가 클라이언트별 모달과 붙여넣기 안내를 보여줍니다.

버튼복사되는 내용적합한 경우
Copy Codex MCP Configmcp_servers.streamliner가 있는 TOML MCP 설정Codex
Copy Claude MCP ConfigmcpServers.streamliner가 있는 JSON MCP 설정Claude Code 또는 Claude Desktop

  1. Main Menu → Command Center → Analytics로 이동합니다.

  2. Copy Codex MCP Config 또는 Copy Claude MCP Config를 클릭합니다.

  3. 버튼이 **Creating MCP token...**으로 바뀔 때까지 기다립니다.

  4. 클라이언트용 모달 안내를 읽습니다.

  5. 복사한 설정을 AI 클라이언트 구성 파일에 붙여넣습니다.

  6. 새 MCP 서버를 읽을 수 있도록 클라이언트를 재시작합니다.

    ✓ Claude 설정은 JSON을 사용합니다. ✓ Codex 설정은 TOML을 사용합니다. ✓ 두 설정 모두 짧게 유지되는 STREAMLINER_MCP_TOKEN을 포함합니다.

새 토큰만 사용

이 변경 전에 복사한 토큰이 있다면 새 설정을 다시 복사하세요. 이전 토큰은 갱신할 때까지 이전 범위를 유지합니다.

각 설정을 붙여넣는 위치

Codex는 ~/.codex/config.toml을 사용합니다.

Claude는 Claude Desktop Developer 구성 파일을 사용하며, 보통 claude_desktop_config.json입니다.

모달에 표시되는 내용​

모달은 설정 복사가 성공했음을 확인합니다. 그다음 해당 클라이언트의 파일 경로, 붙여넣기 위치, 재시작 단계를 보여줍니다.

Codex를 사용하는 경우

  1. Codex를 실행하는 컴퓨터에서 ~/.codex/config.toml을 엽니다.

  2. 복사한 TOML 블록을 파일 최상위에 붙여넣습니다.

  3. 파일을 저장한 뒤 Codex를 재시작합니다.

    ✓ mcp_servers.streamliner가 이미 있으면 그 섹션을 교체합니다.

Claude Desktop을 사용하는 경우

  1. Claude Desktop을 엽니다.

  2. Settings → Developer → Edit Config로 이동합니다.

  3. 복사한 JSON을 claude_desktop_config.json에 붙여넣습니다.

  4. 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 엽니다.

    ✓ macOS에서는 보통 ~/Library/Application Support/Claude/ 아래에 있습니다. ✓ mcpServers가 이미 있으면 streamliner 항목만 병합합니다.

빠른 참고​

보기세션으로 간주되는 것완료 규칙
Pre‑ArrivalPre‑Arrival 단계에 도달한 모든 예약PRE_ARRIVAL 성공
Check‑In → All조기 체크인 또는 사전 등록을 포함한 체크인 흐름 단계가 있는 모든 예약(Pre-arrival 전용 제외)CHECKIN, KEY_COLLECTION, 또는 GET_DOOR_LOCK_KEY 중 하나 성공
Check‑In → Early Check‑InEARLY_CHECKIN_ATTEMPT 또는 ROOM_ASSIGNMENT_QUEUEDEARLY_CHECKIN_ATTEMPT 또는 ROOM_ASSIGNMENT_QUEUED 성공
Check‑In → Pre‑RegistrationPre‑Registration 단계가 있는 모든 예약PRE_REGISTRATION 성공
Check‑In → Full Check‑InCHECKIN, KEY_COLLECTION, 또는 GET_DOOR_LOCK_KEYCHECKIN, KEY_COLLECTION, 또는 GET_DOOR_LOCK_KEY 중 하나 성공
Check‑Out체크아웃 단계가 있는 모든 예약CHECKOUT 또는 COMPLETED_CHECKOUT_PAYMENT 성공

Analytics 열기 및 보기 선택​

Check-In/Out Analytics Dashboard

  1. Main Menu → Command Center로 이동합니다.

  2. Analytics 탭을 선택합니다.

  3. Pre‑Arrival, Check‑In, 또는 Check‑Out을 선택합니다.

  4. Check‑In을 선택했다면 하위 탭인 All Check‑Ins, Early Check‑In, Pre‑Registration, Full Check‑In을 사용합니다.

    ✓ 모든 차트가 해당 보기와 날짜 범위로 갱신됩니다.

AVA가 세션을 구성하는 방식​

  • 세션은 예약 체크인 레코드 1개를 뜻합니다(게스트별이 아님).
  • 해당 보기의 단계 중 하나라도 기록되면 세션에 포함됩니다.
  • 데모 태그가 붙은 세션은 이 Analytics 차트에서 제외됩니다.
  • 실패한 단계도 합계에 포함되어 이탈과 이슈를 볼 수 있습니다.
Pre‑Arrival은 별도입니다

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선택한 기간의 고유 확인 또는 하위 예약 단위커버리지 분모입니다
AVA Check-In ShareAVA가 최소 1회 처리한 적격 단위 비율해당 기간의 AVA 사용률을 보여줍니다
단위 vs 예약

이 카드는 전체 예약이 아니라 단위를 셉니다. 다중 객실 예약은 적격 단위를 여러 개 추가할 수 있습니다.

OPERA 예약

PMS가 OPERA라면 AVA는 적격 단위 계산에서 PM, PF, PX 가상 객실을 제외합니다. 또한 객실 행이 비어 있을 때는 상위 수준 객실 유형 필드를 사용해 실제 객실이 올바르게 집계되도록 합니다.

OPERA 예약 패밀리

AVA는 부모 확인 번호를 기준으로 연결된 OPERA 예약 패밀리도 중복 제거합니다. 이렇게 하면 말단 형제 행이 Eligible Check-In Units를 부풀리지 않습니다.

잘린 세션 맵

AVA가 sessionsMapMeta.truncated를 true로 표시하면 해당 부분 맵을 무시합니다. 그다음 가능하면 전체 체크인 로그를 사용해 비율을 계산합니다. 완전한 로그를 가져올 수 없으면 커버리지 카드는 숨겨집니다.

AVA는 처리된 각 예약을 한 번만 셉니다. 세션 맵이 완전하면 그 맵을 사용합니다. 세션 맵이 없거나 잘렸다면 원시 로그 ID를 대신 사용합니다. 이렇게 하면 AVA Check-In Share가 예약 커버리지와 맞게 유지됩니다. 값은 100% 이하로 유지되어야 합니다.

최신 결과는 잠깐 지연될 수 있음

같은 날짜 범위를 다시 새로고치면 AVA가 직전 커버리지 결과를 잠시 재사용할 수 있습니다. 이렇게 하면 반복 확인 중에도 Analytics 탭이 빠르게 유지됩니다.

체크인 점유율이 이상해 보입니다​

보이는 현상: AVA Check-In Share가 예상보다 높습니다.

해결:

  1. Analytics 탭을 새로고칩니다.
  2. 날짜 범위가 PMS 보고서와 일치하는지 확인합니다.
  3. 숙소가 지원되는 PMS를 사용하는지 확인합니다.
  4. 그래도 이상하면 스크린샷과 함께 지원팀에 문의합니다.

이 카드가 보이지 않는다면 현재 PMS 데이터에 단위 커버리지 메트릭이 없을 수 있습니다. 지원되지 않는 PMS 제공사에는 이 카드가 표시되지 않습니다.

STB EVA 제출 CSV 내보내기​

빠른 설정

이 작업은 1분 이내로 끝납니다. 내보내기는 EVA가 활성화된 Check-In에서만 보입니다.

STB EVA submissions 패널의 작은 다운로드 아이콘으로 선택한 날짜 범위를 내보냅니다.

항목표시 내용할 수 있는 일
STB EVA submissions선택한 기간의 시도, 성공, 실패한 EVA 제출다운로드 아이콘으로 CSV를 받기
CSV contents요약 집계와 EVA API 시도별 1행STB 보고 또는 감사 검토에 사용

  1. Main Menu → Command Center를 엽니다.

  2. Analytics 탭을 선택합니다.

  3. Check-In 보기를 유지합니다.

  4. STB EVA submissions까지 스크롤합니다.

  5. 다운로드 아이콘을 클릭합니다.

  6. 다운로드된 stb-eva-submissions.csv 파일을 저장합니다.

    ✓ 파일에는 거래 ID, 결과 코드, 예약 및 체크인 ID, 오류 메타데이터, 정리된 요청 세부 정보가 포함됩니다. ✓ 여권과 문서 번호는 마스킹됩니다. ✓ MRZ와 base64 필드는 제외됩니다. ✓ 다운로드에 실패하면 AVA가 패널에 로컬 오류 메시지를 표시합니다.

퍼널 차트(이탈과 단계 시간)​

퍼널은 각 단계에 도달한 세션 비율을 보여줍니다.

  • Drop-off는 각 단계를 바로 앞 단계와 비교합니다.
  • Avg Stage Duration은 단계 시작부터 단계 성공까지 그 안에서 보낸 시간을 측정합니다.
  • Avg Time to Next Step은 한 성공 단계에서 다음 성공 단계까지의 시간을 측정합니다.
  • Slowest Step 카드는 먼저 stage duration을 사용합니다.
  • AVA에 stage timing이 없으면 다음 단계 duration으로 되돌아갑니다.
  • 이후 단계가 이전 단계보다 먼저 일어나면 duration은 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는 가장 최근에 실패한 단계가 있는 세션을 보여줍니다.

  • AVA는 최근 10개 이벤트를 확인해 실패를 찾습니다.
  • 최근 실패가 없으면 기록상 가장 최근 실패를 사용합니다.

전체 단계 기록은 View Details로 볼 수 있습니다.

예시

이전에 성공한 뒤 3:12에 결제가 실패했다면, 이슈에는 3:12의 Payment가 표시됩니다. 최근 10개 이벤트가 모두 성공이면 AVA는 기록상 가장 최근 실패를 보여줍니다.

최근 활동​

Recent Activity는 다음과 같은 성공 또는 실패한 주요 단계를 보여줍니다.

  • Check‑In, Check‑Out
  • Room Assignment
  • Pre‑Registration
  • Identity Verification
  • Payment

이 목록은 최신 30개 항목으로 제한됩니다.

이 목록을 사용해 어떤 단계가 가장 최근에 완료됐는지 확인하세요.

예시

“Check‑In completed successfully” 또는 Identity Verification 실패 메시지를 볼 수 있습니다.

최종 단계 분포(세션 종료 지점)​

이 차트는 각 세션의 마지막 단계를 다음 범주로 묶습니다.

  • Success - 전체 완료 단계
  • Timing - 조기 체크인 단계(Room Queued 포함)
  • Partial - 사전 등록
  • Room - 객실 배정 단계(Room Assignment)
  • Documentation - 문서 또는 신분 확인
  • Payment - 결제 단계
  • Early - Entry / Fetch 단계

실패가 마지막 성공 이후에 발생하면 실패 단계가 최종 단계가 됩니다.

이 차트를 사용해 가장 흔한 중단 지점을 확인하세요.

예시

50개 세션 중 20개가 Check‑In(success)에서 끝나고, 10개가 Early Check‑In(timing), 8개가 Document Upload(documentation), 12개가 Payment(payment)에서 끝날 수 있습니다.

최종 단계 분포에서 세션 열기​

  1. Final Step Distribution의 막대 구간을 선택합니다.

  2. 열리는 세션 목록을 검토합니다.

    ✓ 목록에 확인 번호, 게스트, 객실, 최신 실패가 표시됩니다.

  3. 아무 세션에서나 Open details를 선택합니다.

    ✓ 해당 세션의 Reservation Details 패널이 열립니다.

세션 목록 vs 예약

이 목록은 그룹 예약이 아니라 세션을 보여줍니다. 반복 실패를 빠르게 찾는 데 사용하세요.

Device Analytics(선택 사항)​

Device Analytics는 체크인/체크아웃 세션의 장치 세부 정보를 사용합니다.

게스트가 장치 정보를 제공하지 않았다면 이 차트는 비어 있을 수 있습니다.

이 보기를 사용해 OS별로 키오스크와 모바일 사용량을 비교하세요.

예시

대부분의 세션이 iOS라면 모바일 체크인 흐름을 최적화할 수 있습니다.

제한 및 데이터 최신성​

  • Analytics는 조회당 최대 90일을 지원합니다.
  • 일별 롤업이 있으면 넓은 범위는 먼저 롤업 데이터에서 로드됩니다.
  • 결과 집합이 너무 크면 매우 바쁜 숙소는 더 작은 범위가 필요할 수 있습니다.
  • AVA가 날짜 범위를 좁히라고 하면 기간을 줄이고 다시 시도합니다.
  • 성능을 위해 세션 목록은 제한됩니다(단계당 약 200개, 전체 2,000개).

문제 해결​

모든 차트가 0입니다​

보이는 현상: 요약 카드가 0이고 차트가 비어 있습니다.

해결:

  1. 날짜 범위를 넓힙니다.
  2. Status에 로그가 있는지 확인합니다.
  3. 요금제에 Analytics가 포함되어 있는지 확인합니다.

완료율이 예상보다 낮습니다​

보이는 현상: 많은 게스트가 체크인했는데도 완료율이 낮습니다.

확인:

  • 데모 체크인은 제외되므로 테스트 세션은 Total Logs를 올리지 않습니다.
  • Pre‑Arrival 세션은 All Check‑Ins에 포함되지 않습니다.
  • All Check‑Ins는 Full Check‑In 단계만 완료로 봅니다.
  • Early Check‑In과 Pre‑Registration은 별도 하위 탭으로 추적됩니다.

커버리지 카드가 없습니다​

보이는 현상: 기본 요약 카드만 보입니다.

해결:

  1. Check-In에 머뭅니다.

  2. PMS 연결이 활성 상태인지 확인합니다.

  3. 동기화가 끝난 뒤 페이지를 새로고칩니다.

  4. 날짜 범위가 바쁘다면 몇 분 뒤 다시 새로고칩니다.

    ✓ PMS가 예약 커버리지를 지원하면 Eligible Check-In Units와 AVA Check-In Share가 Completion Rate 뒤에 나타납니다.

커버리지 카드가 그대로입니다​

보이는 현상: 새로고침 후에도 Eligible Check-In Units 또는 AVA Check-In Share가 그대로입니다.

해결:

  1. 1분 기다립니다.
  2. Analytics 탭을 다시 새로고칩니다.
  3. 날짜 범위가 기대하는 PMS 업데이트와 일치하는지 확인합니다.
  4. 여전히 이상하면 PMS 동기화가 끝났는지 확인합니다.

Analytics가 계속 로드되거나 범위를 좁히라고 요청함​

보이는 현상: Analytics 탭이 오래 돌아가거나, 시간 초과가 뜨거나, 날짜 범위를 좁히라고 요청합니다.

이유: 범위가 클수록 처리 시간이 더 걸립니다. 매우 바쁜 숙소는 더 빨리 요청 한계에 도달할 수도 있습니다.

해결:

  1. 요청이 끝날 때까지 최대 2분 기다립니다.

  2. 페이지가 계속 시간 초과되거나 범위를 좁히라고 하면 더 작은 날짜 범위를 시도합니다.

  3. Analytics 탭을 새로고치고 다시 시도합니다.

  4. 작은 날짜 범위도 계속 실패하면 선택한 날짜와 함께 지원팀에 문의합니다.

    ✓ 범위가 작아질수록 더 빨리 끝나며 문제의 원인이 범위 크기인지 데이터 가용성인지 구분하는 데 도움이 됩니다.

MCP 설정 복사 실패​

보이는 현상: Copy Codex MCP Config 또는 Copy Claude MCP Config를 클릭한 뒤 버튼에 오류가 표시됩니다.

해결:

  1. Analytics 탭에 그대로 머뭅니다.
  2. 복사 버튼을 다시 시도합니다.
  3. 토큰 요청이 시간 초과되면 페이지를 새로고치고 다시 시도합니다.
  4. 오류가 계속되면 정확한 메시지와 함께 지원팀에 문의합니다.

설정은 복사됐지만 클라이언트가 연결되지 않음​

보이는 현상: 모달은 열리지만 Codex 또는 Claude가 Streamliner 서버를 불러오지 못합니다.

해결:

  1. 설정을 올바른 파일에 붙여넣었는지 확인합니다.
  2. STREAMLINER_MCP_TOKEN 값이 여전히 있는지 확인합니다.
  3. 클라이언트를 완전히 재시작합니다.
  4. 설정에 너무 오래 걸렸다면 새 설정을 다시 복사합니다.

설정 도구가 없음​

보이는 현상: 클라이언트는 연결되지만 설정 작업이 보이지 않습니다.

해결:

  1. Analytics에서 새 설정을 복사합니다.
  2. 클라이언트를 완전히 재시작합니다.
  3. 붙여넣은 STREAMLINER_MCP_TOKEN이 최신인지 확인합니다.
  4. 아직 남아 있는 이전 Streamliner 설정 블록은 제거합니다.

설정 쓰기가 시간 초과됨​

보이는 현상: 설정 저장이 멈춘 것처럼 보이다가 시간 초과 또는 취소 메시지로 돌아갑니다.

해결:

  1. Analytics에서 새 설정을 복사합니다.

  2. 클라이언트를 완전히 재시작합니다.

  3. 설정 변경을 다시 시도합니다.

  4. 다시 실패하면 토큰 또는 세션이 만료됐는지 확인합니다.

    ✓ 유효한 설정 업데이트는 멈추지 않고 완료되어야 합니다.

설정 쓰기에서 인증 실패​

보이는 현상: 상점/숙소 설정을 저장할 때 인증 오류가 발생합니다.

해결:

  1. Analytics에서 새 설정을 복사합니다.

  2. 클라이언트를 완전히 재시작합니다.

  3. 같은 호텔에서 설정 변경을 다시 시도합니다.

  4. 호텔을 바꿨다면 전환 후 설정을 새로 복사합니다.

    ✓ 새 오류는 새 MCP 설정/토큰을 생성하라고 안내해야 합니다.

브라우저 PDF 다운로드가 여전히 없음​

보이는 현상: 전체 Analytics 차트에 Download report 버튼이 있을 것으로 기대합니다.

해결:

  1. 현재 Analytics 탭에서는 이것이 정상입니다.
  2. 화면의 차트와 날짜 범위를 사용합니다.
  3. 제출 세부 정보가 필요하면 STB EVA submissions의 다운로드 아이콘을 사용합니다.
  4. 다른 내보내기 경로가 필요하면 지원팀에 문의합니다.

STB EVA 내보내기가 없음​

보이는 현상: STB EVA submissions 아래에 다운로드 아이콘이 보이지 않습니다.

해결:

  1. Check-In으로 전환합니다.
  2. Settings → Check-in → Government Integration에서 싱가포르용 EVA가 활성화되어 있는지 확인합니다.
  3. Analytics 데이터가 로드된 뒤 페이지를 새로고칩니다.
  4. 여전히 패널이 숨겨져 있다면 선택한 날짜 범위에 EVA 제출이 없을 수 있습니다.

CSV 내보내기 실패​

보이는 현상: 다운로드 아이콘을 눌러도 파일이 내려받아지지 않습니다.

해결:

  1. Analytics 요약이 로드된 뒤 다시 시도합니다.
  2. 날짜 범위를 좁힙니다.
  3. 브라우저가 다운로드를 허용하는지 확인합니다.
  4. 로컬 오류가 사라진 뒤 다시 시도합니다.
  5. 여전히 실패하면 지원팀에 문의합니다.

계속 해결되지 않나요?​

다음 경우 success@vouch-technologies.com으로 문의하세요.

  • ❌ Status에는 데이터가 있는데 Analytics가 비어 있음
  • ❌ 날짜 범위를 바꿔도 차트가 갱신되지 않음
  • ❌ Issues 목록의 타임스탬프가 잘못됨

함께 보내면 좋은 정보:

  • 선택한 날짜 범위
  • Analytics 탭 스크린샷
  • 샘플 예약의 확인 번호