문서 이름 매칭 정책 설정
처음에는 Balanced 모드로 시작하세요. 대부분의 호텔은 3분 이내에 설정을 완료합니다.
이 가이드에서는 AVA가 예약 이름과 여권 또는 ID 이름을 얼마나 엄격하게 비교할지 제어하는 방법을 설명합니다.
찾는 위치
Settings → Security → General Settings → Document Name Matching정책에는 Reservation Lookup과 Document Upload라는 두 개의 탭이 있습니다. 설정하려는 체크인 단계에 해당하는 탭을 선택하세요. AVA는 현재 활성화된 정책 패널만 표시합니다.
빠른 참고
| 설정 | 제어하는 항목 | 일반적인 결과 |
|---|---|---|
| Strict | 가장 높은 매칭 엄격도 | 더 많은 게스트가 프런트 데스크 검토로 이동 |
| Balanced | 기본 매칭 엄격도 | 보안성을 유지하면서 더 원활한 셀프 체크인 |
| Lenient | 더 낮은 매칭 엄격도 | 더 많은 축약 이름이 자동 통과 |
| Custom | 수동 임계값 및 규칙 | 설정한 값에 따라 결과가 달라짐 |
Strict 모드는 bin, binti, binte, bte, S/O, D/O와 같은 부칭 표기가 생략된 이름을 허용합니다.
그래도 안전하지 않은 부분 매칭은 차단합니다.
두 이름을 같은 스크립트로 사용할 수 있는 경우 AVA는 먼저 해당 원문 스크립트 텍스트를 비교합니다. 이렇게 하면 선택한 모드를 변경하지 않고도 태국어 및 CJK 예약의 매칭 정확도가 향상됩니다.
이름이 서로 다른 스크립트를 사용하는 경우 AVA는 토큰 포함 여부를 확인하기 위해 결정적인 음역도 검사합니다. 이를 통해 짧은 음역 토큰 하나만으로 불완전한 Lenient 매칭이 승인되는 것을 방지합니다. 정확한 원문 스크립트 매칭은 계속 허용됩니다.
문서에 성이 포함되어 있으면 AVA는 예약 성이 선택한 정책 임계값을 충족하도록 요구합니다. 이름이 같은 것만으로는 성이 다른 예약을 승인하지 않습니다. 여권에 성이 없고 예약에 다른 이름이 추가된 경우 AVA는 예약 이름 확인으로 해당 사례를 보냅니다.
두 토큰으로 된 문서 이름
문서에 두 토큰이 있는 경우 AVA는 두 토큰 모두에 대해 의미 있는 근거를 요구합니다.
이 보호 규칙은 Balanced, Lenient, Custom 모드에 적용됩니다. 한 토큰 하나만으로 전체 매칭을 결정하지 못하도록 합니다.
두 문서 토큰이 모두 매칭에 나타나면 AVA는 토큰이 합쳐졌거나 순서가 바뀐 매칭도 계속 허용합니다.
성만 일치하는 경우
두 이름 부분을 모두 사용할 수 있는 경우 공통 성만으로는 매칭을 승인할 수 없습니다.
이는 DELA PAZ와 같은 복합 성을 공유하는 게스트를 보호합니다.
유효한 약어, 별칭, 이름 순서 반전 및 원문 스크립트 근거는 두 문서 토큰이 모두 지원될 때 계속 통과할 수 있습니다. 직원이 게스트를 직접 확인할 때 사용할 수 있는 기존 ACI 직원 재정의 기능도 계속 제공됩니다.
| 이름 쌍 | 결과 | 이유 |
|---|---|---|
| "Alex DELA PAZ" vs "Jordan DELA PAZ" | ❌ 검토 | 공통 성만 매칭을 뒷받침함 |
| "Zilin Zhu" vs "Zhuzilin Zhuzilin" | ❌ 검토 | 한 문서 토큰이 의미 있게 지원되지 않음 |
| "A B" vs "B A" | ✓ 통과 | 순서가 바뀌어도 두 토큰이 모두 존재함 |
| "M Taka" vs "Mitsui Takafumi" | ✓ 통과 | 두 문서 토큰이 여전히 매칭에 나타남 |
매칭 모드 설정
-
Document Name Matching에서 Reservation Lookup 또는 Document Upload를 선택합니다.
-
모드를 선택합니다.
-
시나리오 미리보기 카드를 검토합니다.
-
Save General Settings를 클릭합니다.
✓ 선택한 정책이 새 체크인 시도에 적용됩니다.
미리보기 카드는 이제 표준으로 선별된 시나리오를 사용합니다. Strict, Balanced, Lenient는 동일한 예시 목록을 표시합니다. 결과는 CCI의 토큰 수준 점수와 두 토큰 안전 보호 규칙을 따릅니다.
Custom 모드 조정
팀에 정해진 검토 SOP가 있을 때 Custom 모드를 사용하세요.
- Reservation Lookup 또는 Document Upload를 선택합니다.
- Custom을 선택합니다.
- Base similarity threshold를 설정합니다(80-95).
- 다음 항목을 허용할지 선택합니다.
- Initial + surname prefix matching
- Alias name matching
- 약어 제어를 설정합니다.
- Minimum surname prefix length (3-6)
- Minimum surname coverage (0.30-0.80)
- Require two tokens
- Require single-character initial
- Save General Settings를 클릭합니다.
자동 안전 규칙
AVA는 저장할 때 문서 매칭 값을 정규화합니다.
- 잘못된 모드 값은 Balanced로 재설정됩니다
- Custom 임계값은 80-95 사이여야 합니다
- 최소 성 접두사 길이는 3-6 사이여야 합니다
- 최소 성 포함 범위는 0.30-0.80 사이여야 합니다
"true"및"false"텍스트 값은 실제 토글로 변환됩니다
✓ 범위를 벗어난 값을 입력하면 AVA가 수정된 값을 저장합니다.
부칭 이름
| 이름 쌍 | Strict | Balanced | Lenient |
|---|---|---|---|
| "AHMAD BIN IBRAHIM" vs "AHMAD IBRAHIM" | ✓ 통과 | ✓ 통과 | ✓ 통과 |
| "AHMAD IBRAHIM" vs "AHMAD BIN IBRAHIM" | ✓ 통과 | ✓ 통과 | ✓ 통과 |
| "AHMAD BIN IBRAHIM" vs "AHMAD BIN ABDULLAH" | ❌ 검토 | ❌ 검토 | ❌ 검토 |
말레이어 일반 이름 생략
승인된 선행 말레이어 토큰 하나에만 이 기능을 사용하세요. 이 기능은 Balanced 및 Lenient 모드에서 작동합니다.
말레이어 이름에는 AVA가 안전하게 생략할 수 있는 선행 토큰 하나가 포함되는 경우가 있습니다. AVA는 여전히 나머지 토큰들이 강하게 매칭되어야 한다고 요구합니다.
이는 공유된 말레이어 접두사만으로 통과되는 것을 방지합니다.
Strict 및 Custom 모드에서는 이 예외를 사용하지 않습니다. AVA는 예약 조회, 문서 업로드, 스테이징 제안 및 스테이징된 커밋 검증에 동일한 매처를 적용합니다.
| 이름 쌍 | Strict | Balanced | Lenient |
|---|---|---|---|
| "MOHD AHMAD BIN IBRAHIM" vs "AHMAD BIN IBRAHIM" | ❌ 검토 | ✓ 통과 | ✓ 통과 |
| "MOHD AHMAD BIN IBRAHIM" vs "MOHD AHMAD BIN IBRAHIM" | ✓ 통과 | ✓ 통과 | ✓ 통과 |
| "MOHD AHMAD BIN IBRAHIM" vs "MOHD AHMAD BIN ABDULLAH" | ❌ 검토 | ❌ 검토 | ❌ 검토 |
| "MOHD AHMAD BIN IBRAHIM" vs "AHMAD ABDULLAH" | ❌ 검토 | ❌ 검토 | ❌ 검토 |
한 줄로 인쇄된 말레이시아 신분증
일부 말레이시아 신분증은 전체 이름을 한 줄에 인쇄합니다. AVA는 해당 줄에서 이름과 성의 구분을 추론할 수 있습니다.
Balanced 및 Lenient 모드에서는 예약에서 승인된 선행 토큰 하나가 생략되어도 AVA가 허용할 수 있습니다. 나머지 문서 토큰은 예약 이름과 정확히 일치해야 합니다.
| 문서 이름 | 예약 이름 | Balanced 및 Lenient | Strict 및 Custom |
|---|---|---|---|
MUHAMMAD HAFIZ ABDULLAH | HAFIZ ABDULLAH | ✓ 통과 | ❌ 검토 |
MOHD AHMAD BIN IBRAHIM | AHMAD BIN IBRAHIM | ✓ 통과 | ❌ 검토 |
SITI HAFIZ ABDULLAH | HAFIZ ABDULLAH | ❌ 검토 | ❌ 검토 |
MUHAMMAD AMIR HAMZAH | AMIRA HAMZAH | ❌ 검토 | ❌ 검토 |
이 예외는 추론된 구분이 있는, 인식된 비여권 문서에만 적용됩니다. 여권, 알 수 없는 문서 유형 또는 선행 토큰 두 개가 생략된 경우에는 적용되지 않습니다.
일반적인 예시
| 이름 쌍 | Strict | Balanced | Lenient |
|---|---|---|---|
| "John Michael Doe" vs "John Michael Doe" | ✓ 통과 | ✓ 통과 | ✓ 통과 |
| "Jon Smyth" vs "John Smith" | ❌ 검토 | ✓ 통과 | ✓ 통과 |
| "M Taka" vs "Mitsui Takafumi" | ❌ 검토 | ✓ 통과 | ✓ 통과 |
| "K Taka" vs "Mitsui Takafumi" | ❌ 검토 | ❌ 검토 | ❌ 검토 |
| "A Kumar" vs "Arun Kumar" | ❌ 검토 | ✓ 통과 | ✓ 통과 |
| "HSIEH / YU-CHEN" vs "Hung Yu Chen" | ❌ 검토 | ❌ 검토 | ❌ 검토 |
별칭 이름
별칭은 다음 세 가지 조건이 모두 참일 때만 통과할 수 있습니다.
- Alias name matching이 활성화되어 있습니다.
- ID가 별칭을 제공합니다.
- 선택한 모드에서 별칭이 예약과 일치합니다.
주 이름의 성이 서로 다르다는 사실만으로는 통과하지 않습니다.
| 예약 | ID의 주 이름 | ID가 제공한 별칭 | Balanced 결과 |
|---|---|---|---|
| "Alice Tan" | "Alice Lim" | "Alice Tan" | 별칭 매칭이 활성화되면 ✓ 통과 |
| "Alice Tan" | "Alice Lim" | None | ❌ 검토 |
| "Alice Tan" | "Alice Wong" | "Alice Chen" | ❌ 검토 |
| "Alice Tan" | "Alice Lim" | "Alice Tan" | 별칭 매칭이 비활성화되면 ❌ 검토 |
Lenient 모드는 프런트 데스크 업무를 줄일 수 있지만 경계선상의 이름 패턴도 더 많이 허용합니다.
문제 해결
검토로 보내지는 게스트가 너무 많음
보이는 내용: 유효한 게스트 중 많은 수가 직원 검토로 이동합니다.
해결 방법:
- Strict를 Balanced로 변경합니다.
- Custom에서 임계값을 약간 낮춥니다.
- OTA 이름이 자주 축약되는 경우 약어 매칭을 활성화합니다.
축약 이름이 너무 많이 통과함
보이는 내용: 짧은 이름에 대해 더 엄격한 심사를 원합니다.
해결 방법:
- Lenient를 Balanced 또는 Strict로 변경합니다.
- Custom의 임계값을 높입니다.
- 성 접두사 길이 또는 포함 범위를 높입니다.
변경 사항이 적용되지 않는 것처럼 보임
보이는 내용: 편집 후에도 결과가 바뀌지 않은 것처럼 보입니다.
해결 방법:
- Save General Settings를 다시 클릭합니다.
- 페이지를 새로 고칩니다.
- 새 체크인 흐름으로 테스트합니다.
잘못된 이름 매칭 정책이 변경됨
보이는 내용: 예약 조회와 문서 업로드에서 예상하지 못한 결과가 나타납니다.
해결 방법:
- Settings → Security → General Settings로 돌아갑니다.
저장 후 Custom 값이 변경됨
보이는 내용: 저장된 Custom 값이 입력한 값과 다르게 보입니다.
해결 방법:
- Document Name Matching을 다시 엽니다.
- 허용 범위와 값을 비교합니다.
- 범위 안의 값을 사용하여 다시 저장합니다.
여전히 해결되지 않나요?
다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 재시도 후에도 이름 매칭 결과가 일관되지 않음
- ❌ 설정은 성공적으로 저장되지만 동작이 바뀌지 않음
- ❌ 현지 규정 준수 규칙에 맞게 Custom 값을 조정하는 데 도움이 필요함
다음과 같은 유용한 세부 정보를 포함하세요.
- 선택한 모드
- Custom 값(사용한 경우)
- 예약 이름과 문서 이름의 예시 쌍 2~3개