이 문서에서는 주소 확인 시스템을 구축하여 Address Validation API의 다양한 응답을 처리할 수 있습니다 이 가이드에서는 응답을 올바르게 사용하여 다른 신호를 조사하는 로직을 빌드합니다. 고객에게 추가 정보를 요청하는 경우와 방법 등을 파악할 수 있습니다.
일반적으로 API 응답은 시스템이 다음과 같이 주소를 처리합니다.
- 수정: 주소의 품질이 낮습니다. 추가 정보를 입력하라는 메시지가 표시됩니다.
- 확인: 주소의 품질이 우수하지만 변경할 수 없습니다. 다음과 같은 질문을 할 수 있습니다. 확인.
- 수락: 주소의 품질이 우수합니다. 다음과 같은 작업을 할 수 있습니다. 제공된 주소를 수락합니다.
키 용도
이 문서는 API 응답을 가장 잘 분석할 수 있도록 시스템을 수정하는 데 도움을 주고 제공된 주소로 수행할 다음 작업을 결정합니다. 다음 의사코드는 가능한 흐름을 보여줍니다.
if (the API response indicates significant problems in the address)
FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
CONFIRM - confirm with the user that the address is correct
else
ACCEPT - continue with the address returned by the API.
정확한 로직은 상황에 따라 다릅니다. 구현 가이드를 참고하세요. 를 참조하세요. 이 로직의 오픈소스 구현을 사용하여 확장 구성요소 라이브러리에 있습니다.
워크플로 개요
아래 표에는 시스템에서 수행할 두 가지 작업이 요약되어 있습니다.
- 수정, 확인, 수락 동작을 기반으로 사용할 워크플로
- 응답에서 확인해야 할 첫 번째 신호입니다. 신호
verdict속성에서 가져온 것으로, 여기에 설명된 대로 주소 신호를 초기에 표시하고 있습니다. 각 동작 유형은 이 문서의 섹션에 해당합니다. 추가 신호를 설명하는 것을 예로 들 수 있습니다.
| 시스템 동작 | |||
|---|---|---|---|
| 주소 수정하기 |
|
||
| 주소 확인 |
|
||
| 주소 수락 |
Address Validation API 응답은 우수한 주소 품질을 나타냅니다.
|
||
구현 안내
시스템이 Address Validation API의 신호에 응답하는 방식을 설계할 때 다음의 권고 사항이 보다 효과적인 대응 방법을 작성하는 데 있습니다. 그러나 이는 권장사항일 뿐이므로 비즈니스 모델에 적합한지 확인하세요.
| 안내 | 세부정보 | |
|---|---|---|
| 위험 수준 |
광고 노출의 노출 가능성과 관용적인 가치에 대한 판단을 내리는 것이 입력된 주소를 수락하는 것입니다. |
Address Validation API는 다양한 신호와 위험 수준과 통합하여 검증을 최적화할 수 있음 프로세스입니다 예를 들어 주소에 확인되지 않은 번지가 있는 경우 여전히 수락해야 합니다. 반면에 비즈니스 운영에서 더 정밀하지 않다면 사용자에게 메시지를 표시할 수 있습니다. 예를 들어 두 카테고리 중 하나에 속할 수 있습니다. 미국 이외 지역의 미확인 도로 번호를 참고하세요. 주소 수락 - 예시에 입력합니다. |
| 주소 허용 |
시스템에서 원래 항목을 수락하도록 허용하는 것이 좋습니다. 고객이 메시지에 응답하지 않는 경우 |
이 경우 고객이 다른 이메일 주소의 주소를 입력했을 수도 있습니다. 시스템의 상태를 나타냅니다. |
| 의견 보내기 |
주소 확인 요청을 재발급할 때 다음이 가능합니다.
|
이렇게 하면 최종 응답을 어떻게 처리했는지 Google에 알릴 수 있습니다. 업데이트된 주소 처리를 참고하세요. |
주소 수정
결과에 주소가 잘못 표시되어 있는 경우 주소를 수정합니다. 결과물. 그러면 시스템에서 고객에게 필요한 정보를 제공하라는 메시지를 표시할 수 있습니다. 작업한 후 결과물을 받기 위해 워크플로를 다시 발행합니다. 있습니다.
신호 수정
Address Validation API는 수정해야 합니다.
1. 검증 세부사항 및 누락된 구성요소
다음 두 신호는 문제가 있는 주소를 가장 정확하게 나타냅니다.
validationGranularity필드가OTHER일 때마다 시스템은 다음을 실행해야 합니다. 주소 구성요소 신호를 조사하여 오류가 발생한 위치 확인 해결 방법을 찾을 수 있습니다.- 후처리된
address객체가missingComponentTypes필드가 있으면 시스템이 해당 구성요소를 확인해야 합니다. 또한 구성요소가 누락되면 주소가 불완전하여 전송할 수 없게 됩니다.
2. 기타 신호
Address Validation API는 특정 문제 진단:
| 의심스러운 구성요소 | 구성요소에 대한 확인 수준 enum이
UNCOMFIRMED_AND_SUSPICIOUS인 경우 구성요소가 다음과 같을 가능성이 높습니다.
오답입니다.
|
|---|---|
| 해결되지 않은 구성요소 | unresolvedToken 은(는) 주소의 일부분으로 인식되지 않습니다. |
3. 미국 주소 신호
미국 주소에만 적용되는 특정 필드는 주소는 배송할 수 없으며 수정해야 합니다. 다음과 같이 표시됩니다.
dpvConfirmation
|
N 또는 D이거나 비어 있습니다.
|
|---|
dpvConfirmation에 관한 자세한 내용은 다음을 참고하세요.
미국 주소를 처리합니다.
주소 확인
확인 결과에 Address Validation API가 해당한다고 표시되면 주소를 확인합니다. 주소 구성 요소를 변경하여 추론하거나 변경함으로써 확인할 수 있습니다. 이 경우 배송 가능한 주소가 있지만 결과 주소가 있습니다.
고객에게 올바른 메시지를 표시하기 위해 로직에서는
서비스에서 플래그 지정한 구성요소를 사용하여 어떤 작업을 결정하거나 API에 플래그를 지정합니다.
inferred, replaced, spellCorrected 등 구성요소에 적용됩니다.
참조에서 AddressComponent를 참고하세요.
신호 확인
Address Validation API는 주소가 확인되어야 합니다.
1. 검증 세부사항
ROUTE 이상의 validationGranularity가 허용되지만 다음 중 하나입니다.
PREMISE 또는 SUBPREMISE는 더 강력한 업로드 신호를 제공합니다.
2. 기타 신호
고객에게 주소 입력 확인을 결정할 때 결과도 는 조사할 구성요소를 결정할 수 있도록 다음을 제공합니다.
| 추론된 데이터 | hasInferredComponents 필드가 true인 경우
API가 다른 이메일 주소에서 얻은 정보를
구성할 수 있습니다.
|
|---|---|
| 교체된 데이터 | hasReplacedComponents 필드가 true인 경우
API가 입력된 데이터를 유효한 주소로 만드는 것으로 간주되는 데이터로 교체했습니다.
|
3. 미국 주소 신호
미국 주소에만 적용되는 특정 필드는 로직이 고객에게 세부정보를 확인합니다. 다음 중 하나가 적용됩니다.
dpvConfirmation
|
S
|
|---|---|
| 주소 응답 | 다음 값이 있는 missingComponentType 필드 포함
subpremise입니다.
|
주소 수락
확인 결과가 매우 확신할 수 있는 경우 주소를 수락합니다. 배송 가능한 주소이며 추가 고객 상호작용 없이 사용할 수 있습니다. 다운스트림 프로세스로 전송됩니다.
신호 허용
Address Validation API는 주소가 확인되어야 합니다.
1. 검증 세부사항
PREMISE 이상의 validationGranularity가 허용되지만 일부에서는
ROUTE는 여전히 배송 가능한 주소를 나타냅니다.
2. 기타 신호
고품질 주소에 관한 확인 결과는 다음 사항도 제공해야 합니다.
- 대체된 데이터 없음. 이 경우는
hasReplacedComponents: FALSE입니다. - 추론된 구성요소 없음. 이 경우는
hasInferredComponents: FALSE입니다.
3. 미국 주소 신호
미국 주소에만 적용되는 특정 입력란이 고품질 주소를 나타냅니다. 몇 가지 옵션이 있습니다. 허용되는 미국 주소의 경우 있습니다.
dpvConfirmation
|
Y
|
|---|