문서 이름 일치 정책 설정
처음에는 Balanced 모드로 시작하세요. 대부분의 호텔은 3분 이내에 설정을 마칩니다.
이 가이드는 AVA가 예약 이름과 여권 또는 신분증 이름을 얼마나 엄격하게 비교할지 제어하는 방법을 안내합니다.
위치
Settings → Security → General Settings → Document Name Matching빠른 참고
| 설정 | 제어 내용 | 일반적인 결과 |
|---|---|---|
| Strict | 가장 엄격한 일치 기준 | 더 많은 게스트가 프런트 데스크 검토로 넘어감 |
| Balanced | 기본 일치 기준 | 보안성과 셀프 체크인의 원활함을 균형 있게 유지 |
| Lenient | 낮은 일치 기준 | 더 축약된 이름이 자동으로 통과함 |
| Custom | 수동 임계값과 규칙 | 설정한 값에 따라 결과가 달라짐 |
Strict 모드는 bin, binti, binte, bte, S/O, D/O 같은 부칭 표기를 생략한 이름도 허용합니다.
그래도 안전하지 않은 부분 일치는 차단합니다.
두 이름이 같은 스크립트로 제공되면 AVA는 먼저 해당 원문 스크립트 텍스트를 비교합니다. 이 방식은 선택한 모드를 바꾸지 않으면서 태국어 및 CJK 예약의 일치 정확도를 높입니다.
이름이 서로 다른 스크립트를 사용하면 AVA는 토큰 포함 여부를 확인하기 위해 결정적인 음역도 검사합니다. 이를 통해 짧은 음역 토큰 하나만으로 불완전한 Lenient 일치가 승인되는 것을 막습니다. 정확히 일치하는 원문 스크립트 이름은 계속 허용됩니다.
두 토큰 문서 이름
문서 이름이 두 토큰으로 구성되면, 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에서 모드를 선택합니다.
-
시나리오 미리보기 카드를 확인합니다.
-
Save General Settings를 클릭합니다.
✓ 선택한 정책이 새 체크인 시도에 적용됩니다.
미리보기 카드는 이제 표준 선별 시나리오를 사용합니다. Strict, Balanced, Lenient는 모두 같은 예시 목록을 보여줍니다.
Custom 모드 조정
팀에 검토 SOP가 정해져 있을 때 Custom 모드를 사용하세요.
- 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" | ❌ 검토 | ❌ 검토 | ❌ 검토 |
일반적인 예시
| 이름 쌍 | Strict | Balanced | Lenient |
|---|---|---|---|
| "John Michael Doe" vs "John Michael Doe" | ✓ 통과 | ✓ 통과 | ✓ 통과 |
| "M Taka" vs "Mitsui Takafumi" | ❌ 검토 | ✓ 통과 | ✓ 통과 |
| "K Taka" vs "Mitsui Takafumi" | ❌ 검토 | ❌ 검토 | ❌ 검토 |
| "A Kumar" vs "Arun Kumar" | ❌ 검토 | ✓ 통과 | ✓ 통과 |
| 별칭 또는 결혼 후 성 사례 | ❌ 검토 | ✓ 통과 | ✓ 통과 |
Lenient 모드는 프런트 데스크 업무를 줄일 수 있지만, 경계선에 있는 이름 패턴도 더 많이 허용합니다.
문제 해결
검토로 넘어가는 게스트가 너무 많음
보이는 내용: 정상적인 게스트가 많이 직원 검토로 넘어갑니다.
해결:
- Strict를 Balanced로 바꿉니다.
- Custom에서는 임계값을 약간 낮춥니다.
- OTA 이름이 자주 축약된다면 약어 매칭을 활성화합니다.
축약된 이름이 너무 많이 통과함
보이는 내용: 짧은 이름에 대해 더 엄격한 검사가 필요합니다.
해결:
- Lenient를 Balanced 또는 Strict로 바꿉니다.
- Custom의 임계값을 높입니다.
- 성 접두어 길이 또는 포함 범위를 높입니다.
변경 사항이 적용되지 않는 것 같음
보이는 내용: 수정한 뒤에도 결과가 달라지지 않습니다.
해결:
- Save General Settings를 다시 클릭합니다.
- 페이지를 새로고침합니다.
- 새 체크인 흐름으로 테스트합니다.
Custom 값이 저장 후 바뀜
보이는 내용: 저장한 Custom 값이 입력한 것과 다르게 보입니다.
해결:
- Document Name Matching을 다시 엽니다.
- 허용 범위와 입력값을 비교합니다.
- 범위 안의 값으로 다시 저장합니다.
아직 막혔나요?
다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 재시도 후에도 이름 매칭 결과가 일관되지 않음
- ❌ 설정은 저장되지만 동작이 바뀌지 않음
- ❌ 현지 규정 준수 규칙에 맞게 Custom 값을 조정해야 함
도움이 되는 정보:
- 선택한 모드
- Custom 값(사용한 경우)
- 예약 이름과 문서 이름 예시 2~3개