본문으로 건너뛰기

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는 처리된 각 예약을 한 번만 셉니다. 세션 맵이 완전하면 그 맵을 사용합니다. 세션 맵이 없거나 잘렸다면 원시 로그 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_submission_logs의 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는 선택한 보기에서 첫 성공 단계 기준으로 세션을 묶습니다.

  • 시간 구간은 UTC를 사용합니다.
  • Analytics 응답은 이를 timezone: UTC로 표시합니다.
  • 현지 인력 배치의 피크를 비교하기 전에 호텔 시간대를 확인하세요.
  • 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개).

호텔의 현지 날짜 범위 사용​

Analytics는 선택한 날짜 범위를 읽을 때 호텔에 구성된 시간대를 사용합니다. 예약 업데이트 시간이 아니라 체크인 및 체크아웃 활동 타임스탬프로 세션을 필터링합니다. 해당 현지 날짜 범위 안의 단계만 선택한 날짜의 차트와 완료 결과에 반영됩니다. 이후 예약 업데이트로 그 날짜의 과거 또는 미래 완료 단계가 추가되지는 않습니다. Successful Check‑Outs 카드는 예외이며 종료 이벤트의 완료 날짜를 사용합니다.

현지 영업일 비교

다른 시간대에서 Analytics를 검토하더라도 호텔의 달력 날짜를 기준으로 날짜를 선택하세요.

게스트가 pre-arrival 이후 계속 진행하는 경우​

Pre‑Arrival 보기는 배타적인 범주가 아니라 멤버십 코호트입니다. 세션은 Pre‑Arrival 코호트와 Check‑In 코호트에 모두 속할 수 있습니다. Pre‑Arrival 활동이 시작되면 게스트가 플로우를 중단하더라도 세션이 대상이 됩니다. PRE_ARRIVAL에 도달하면 세션이 완료됩니다. 기록된 플로우 활동 없이 pre-arrival 링크만 연 경우에는 대상이 되지 않습니다. 관찰된 전체 체크인 마일스톤이 있으면 세션은 올바른 Check‑In 총계에 계속 포함됩니다.

게스트 활동Analytics 보기
기록된 플로우 활동 없이 링크를 엶Pre‑Arrival에 포함되지 않음
Pre‑Arrival을 시작했지만 중단함Pre‑Arrival, 미완료
pre-arrival만 완료함Pre‑Arrival, 완료
pre-arrival을 완료한 후 기기 체크인을 완료함Pre‑Arrival 및 Check‑In

이렇게 하면 혼합 여정이 관련된 두 코호트에 모두 표시됩니다. 순수한 pre-arrival 여정은 All Check‑Ins에서 계속 제외됩니다.

키 인코딩이 마지막으로 기록된 단계인 경우​

AVA는 KEY_ENCODED를 Full Check-In 분류 신호로 취급합니다. 세션에 KEY_COLLECTION 또는 KEY_RETRIEVED 단계가 없어도 적용됩니다. 세션은 Full Check‑In 및 All Check‑Ins에 표시됩니다.

KEY_ENCODED는 Completion Rate의 완료 마일스톤으로 계산되지 않습니다. 따라서 Full Check-In 총계는 늘리지만 완료 세션 수는 늘리지 않을 수 있습니다.

완료율이 변할 수 있음

키카드 인코딩을 사용하는 숙소에서는 Full Check-In 완료율이 조금 낮아질 수 있습니다. 다른 완료 마일스톤 없이 세션이 KEY_ENCODED에서 끝날 때 발생합니다.

Successful Check-Outs는 완료 날짜를 사용함​

Successful Check‑Outs 카드는 성공한 종료 이벤트에 도달한 각 고유 체크아웃을 셉니다. AVA는 체크아웃이 성공한 호텔 현지 달력 날짜에 해당 건수를 귀속합니다. 체크아웃 시도, 퍼널 단계, Completion Rate 및 Avg Completion Time은 시작 날짜에 귀속됩니다.

예를 들어 월요일에 시작해 화요일에 성공한 체크아웃은 화요일의 Successful Check‑Outs에 표시됩니다. 해당 시도와 퍼널 활동은 월요일 체크아웃 Analytics에 남습니다.

PMS 체크인과 여정 완료 구분​

Successful Check‑Ins는 AVA가 PMS CHECKIN 요청을 완료했음을 확인합니다. OPERA에서는 AVA가 PMS로 SCI 코드를 보낸 시점입니다. 기록된 체크인 증거가 SUCCESS 또는 PARTIAL일 때만 마일스톤을 셉니다. 대기 중이거나 실패한 이전 마일스톤 데이터는 성공한 PMS 체크인으로 계산되지 않습니다. 체크인 활동 증거가 없으면 체크아웃만 진행된 여정을 제외합니다.

Completion Rate와 Avg Completion Time은 구성된 종료 또는 객실 접근 신호를 계속 사용합니다. 이를 통해 여정 성과와 PMS 마일스톤을 분리합니다.

발생한 일Successful Check‑Ins완료 지표
PMS CHECKIN 성공 후 키카드 인코딩 실패PMS 체크인으로 계산미완료 여정 또는 실패로 표시될 수 있음
대기 중이거나 실패한 이전 CHECKIN 표식만 남음계산하지 않음선택한 보기의 기존 완료 규칙을 따름
성공한 PMS CHECKIN 없이 객실 할당이 대기열에 들어감계산하지 않음선택한 보기의 기존 완료 규칙을 따름
PMS CHECKIN과 객실 접근이 모두 성공PMS 체크인으로 계산종료 신호가 성공하면 완료로 계산

체크아웃 커버리지 카드​

AVA는 PMS가 완전한 출발 범위 코호트를 제공할 때만 체크아웃 커버리지를 표시합니다. Check-Out 보기에서 두 카드를 볼 수 있으며, 이 카드는 체크인 활동과 별도로 AVA 체크아웃 활동을 측정합니다.

카드표시 내용중요한 이유
Eligible Check-Out Units선택한 기간에 출발하는 고유 확인 또는 하위 예약 단위체크아웃 커버리지 분모입니다
AVA Check-Out Share지속적인 AVA 체크아웃 활동이 있는 적격 단위의 비율해당 기간 출발 건의 AVA 사용률을 보여줍니다
커버리지는 출발 날짜 사용

체크아웃 커버리지는 호텔 시간대의 각 예약 출발 날짜를 사용합니다. 체크인 커버리지는 도착 날짜를 사용하므로 두 카드가 서로 다른 단위를 포함할 수 있습니다. 검색만 한 조회와 PMS 또는 프런트 데스크 동기화 단계는 계산하지 않습니다.

PMS별 체크아웃 커버리지​

Cloudbeds, Mews 및 OPERA는 체크아웃 커버리지를 위한 기본 출발 코호트를 제공합니다. 지원되지 않는 PMS 어댑터는 비율 대신 Unavailable을 표시할 수 있습니다. OPERA에서 예약 페이지가 불완전해도 Unavailable이 표시됩니다. AVA는 일부 출발 데이터로 비율을 계산하지 않습니다.

체크아웃 커버리지를 사용할 수 없음​

보이는 현상: 체크아웃 커버리지 카드가 비율 대신 Unavailable을 표시합니다.

발생 이유: AVA가 완전한 출발 범위 커버리지 데이터를 확인할 수 없습니다. PMS가 출발 코호트를 지원하지 않거나 OPERA 예약 페이지가 불완전할 수 있습니다. 오해를 부를 결과를 표시하는 대신 비율을 숨깁니다.

해결:

  1. Check-Out과 올바른 날짜 범위를 선택했는지 확인합니다.

  2. PMS 동기화가 끝난 후 Analytics 탭을 새로 고칩니다.

  3. 몇 분 후 같은 범위를 다시 시도합니다.

  4. 카드가 계속 사용할 수 없으면 지원팀에 문의합니다.

    ✓ 사용할 수 없는 카드는 결과를 아직 신뢰할 수 없다는 뜻입니다. 0이라는 뜻은 아닙니다.

체크아웃 전환은 필수 마일스톤을 사용함​

Check‑Out에서 AVA는 필수 체크아웃 마일스톤으로 전환율을 계산합니다. 게스트는 Checkout Started에서 Checkout Complete으로 바로 이동할 수 있으며, AVA는 이를 잘못된 이탈 없이 완료로 계산합니다. 선택적 단계는 Optional checkout activity에 표시되지만 전환율을 낮추지 않습니다.

직접 PMS 체크아웃이 이탈로 보임​

보이는 현상: 게스트가 PMS에서 체크아웃을 완료했지만 청구서 또는 결제 단계를 건너뛰었습니다.

해결:

  1. Command Center → Analytics에서 Check‑Out을 선택합니다.

  2. 마지막 필수 단계인 Checkout Complete를 찾습니다.

  3. Optional checkout activity에서 청구서, 요금 또는 결제 이벤트를 확인합니다.

    ✓ 직접 PMS 체크아웃도 최종 전환에 포함됩니다.

필수 단계 이탈에서 예약 보기​

필수 체크아웃 이탈에는 View list 작업이 포함될 수 있습니다. 이를 사용하여 필수 단계 하나에는 도달했지만 다음 단계에는 도달하지 못한 예약을 찾습니다.

  1. Command Center → Analytics에서 Check‑Out을 선택합니다.
  2. 이탈 수가 있는 필수 단계 전환을 찾습니다.
  3. View list를 클릭합니다.
  4. 확인 번호, 게스트 이름, 객실 및 최신 실패 세부 정보를 검토합니다.
  5. Download CSV를 클릭하여 표시된 예약을 저장합니다.

AVA는 일치하는 모든 세션이 표시된 이탈 수와 같을 때만 View list를 표시합니다.

실패한 체크아웃 결제 검토​

결제는 Optional checkout activity 아래에 표시됩니다. 실패한 결제가 나열되면 View failed reservations를 클릭하고 예약 상세와 실패 메시지를 검토하세요. CSV에는 Confirmation number, Guest name, Room, Failure step 및 Failure message가 포함됩니다.

Successful Check-Outs가 다른 날짜에 표시됨​

보이는 현상: 체크아웃은 하루에 시작했지만 Successful Check‑Outs는 다른 날 증가합니다.

해결:

  1. 종료 체크아웃 이벤트가 성공한 시점을 확인합니다.

  2. 해당 타임스탬프를 호텔 현지 달력 날짜와 비교합니다.

  3. 시도 또는 퍼널 단계를 비교할 때 체크아웃 시작 날짜를 검토합니다.

    ✓ 체크아웃이 자정을 넘기거나 지연 후 완료될 때는 정상입니다.

문제 해결​

모든 차트가 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. 여전히 실패하면 지원팀에 문의합니다.

퍼널 예약 목록이 없음​

보이는 현상: 필수 이탈 또는 실패한 결제에 목록 작업이 없습니다.

해결:

  1. Check‑Out과 올바른 날짜 범위를 선택했는지 확인합니다.
  2. 전환에 0이 아닌 이탈 또는 실패한 결제 수가 있는지 확인합니다.
  3. 데이터 로딩이 끝난 후 Analytics 탭을 새로 고칩니다.
  4. 매핑이 계속 불완전하면 Status에서 예약을 검색합니다.

AVA는 표시된 모든 수를 안전하게 일치시킬 수 없으면 목록 작업을 숨깁니다.

시간 분석이 잘못된 현지 시간을 사용함​

보이는 현상: 피크 시간이 호텔 현지 시간과 일치하지 않습니다.

해결:

  1. Analytics 응답의 timeAnalysis.timezone 값을 확인합니다.
  2. UTC 구간은 호텔 현지 시간이 아니라 UTC로 취급합니다.
  3. merchantTimezone을 사용하여 현지 인력 배치에 맞게 구간을 변환합니다.
  4. Settings → Essentials → Hotel Basic Details에서 호텔 시간대를 확인합니다.

Analytics에 다른 날짜의 단계가 표시됨​

보이는 현상: 선택한 날짜에 다른 달력 날짜의 완료가 포함된 것처럼 보입니다.

해결:

  1. Settings → Essentials → Hotel Basic Details에서 호텔 시간대를 확인합니다.
  2. 호텔 현지 달력 날짜를 사용하여 날짜 범위를 다시 선택합니다.
  3. Analytics 탭을 새로 고칩니다.
  4. 결과가 계속 이상하면 선택한 날짜와 예약 번호를 함께 지원팀에 문의합니다.

계속 해결되지 않나요?​

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

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

함께 보내면 좋은 정보:

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