문서 이름 매칭 정책 설정
처음에는 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는 두 토큰 모두에 대해 의미 있는 지원이 있어야 한다고 판단합니다.
이 보호 규칙은 Balanced, Lenient, Custom 모드에 적용됩니다. 한 토큰이 나머지 전체를 혼자 대표하는 것을 막습니다.
두 문서 토큰이 모두 매칭에 반영되면, AVA는 압축되거나 순서가 바뀐 이름도 계속 허용합니다.
| 이름 쌍 | 결과 | 이유 |
|---|---|---|
| "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" | ❌ 검토 | ❌ 검토 | ❌ 검토 |
일반 예시
| 이름 쌍 | 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개