Este documento describe un proceso para crear un sistema de verificación de direcciones para manejar una variedad de respuestas de la API de Address Validation. Abarca cómo Crea tu lógica para usar correctamente la respuesta y, así, investigar otras señales de la API, y cuándo y cómo solicitar más información a los clientes.
En general, la respuesta de la API determina las siguientes formas en las que tu sistema administrar una dirección:
- Corregir: La dirección es de baja calidad. Deberías solicitar más información.
- Confirmar: La dirección es de alta calidad, pero tiene cambia desde la dirección de entrada. Podrías solicitar confirmación.
- Aceptar: La dirección es de alta calidad. Puedes acepte la dirección proporcionada.
Propósito clave
Este documento te ayuda a modificar tu sistema para analizar mejor la respuesta de la API y determinará las próximas acciones que se deben realizar con las direcciones proporcionadas. Lo siguiente pseudocódigo ilustra un flujo posible.
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.
La lógica exacta depende de tu situación; consulta la Guía para la implementación para obtener más información. También puede usar nuestra implementación de código abierto de esta lógica que se encuentra en la Biblioteca de componentes extendidos.
Descripción general del flujo de trabajo
En la siguiente tabla, se resumen dos acciones para tu sistema:
- El flujo de trabajo a utilizar basado en el comportamiento de corrección, confirmación y aceptación.
- Los primeros indicadores que se deben verificar a partir de la respuesta. Los indicadores
que se describen aquí provienen de la propiedad
verdicty no son la única indicadores que hay que verificar, pero brindan un indicador inicial de la dirección calidad. Cada tipo de comportamiento corresponde a una sección de este documento. que describan indicadores adicionales que quizás también debas investigar.
| El comportamiento del sistema | |||
|---|---|---|---|
| Corregir la dirección |
La respuesta de
|
||
| Confirmar la dirección |
La respuesta de
|
||
| Aceptar la dirección |
La respuesta de la API de Address Validation indica una dirección de excelente calidad.
|
||
Asesoramiento para la implementación
Cuando diseñes la respuesta de tu sistema a las señales de la API de Address Validation las siguientes recomendaciones pueden ayudarte a crear una respuesta más eficaz un modelo de responsabilidad compartida. Sin embargo, estas son solo recomendaciones, así que ten en cuenta que la implementación adecuada se adecúe a tu modelo de negocio.
| Orientación | Detalles | |
|---|---|---|
| Nivel de riesgo |
Ten en cuenta el nivel de tolerancia a tu situación cuando equilibras enviar instrucciones y acepta la dirección tal como se ingresó. |
La API de Address Validation devuelve una variedad de indicadores que puedes incorporar con tu nivel de riesgo para optimizar tu validación el proceso de administración de recursos. Por ejemplo, si una dirección tiene un número de calle sin confirmar, puedes aun así lo aceptan. Por otro lado, si las operaciones de tu empresa requieren mayor precisión de direcciones, podrías preguntar al usuario. Por un ejemplo que pueden pertenecer a una categoría, consulta Número de calle no confirmado de EE.UU. en Aceptar dirección: ejemplos. |
| Aceptar direcciones |
Se recomienda que permitas que el sistema acepte la entrada original si el cliente no responde los mensajes. |
En estos casos, es posible que el cliente haya ingresado una dirección que no esté en en el sistema, como en las construcciones nuevas. |
| Proporcionar comentarios |
Cuando vuelvas a emitir una solicitud de validación de dirección, puedes
también puedes enviar una solicitud al extremo |
Esto permite que Google sepa cómo manejaste la respuesta final en última instancia. Consulta Cómo administrar direcciones actualizadas. |
Corregir una dirección
Corrige una dirección cuando los resultados indican claramente que la dirección no es entregable. El sistema puede pedirle al cliente que proporcione la información información, después de lo cual vuelves a emitir tu flujo de trabajo para obtener un entregable web.
Corregir indicadores
La API de Address Validation proporciona varios indicadores para informarte si un la dirección IP debe corregirse.
1. Nivel de detalle de la validación y componentes faltantes
Estos dos indicadores proporcionan el mejor indicador de una dirección problemática:
- Cuando el campo
validationGranularitytenga el valorOTHER, el sistema investigar las señales de los componentes de la dirección para saber dónde se produjo y cómo solucionarlo. - Cada vez que el objeto
addressprocesado previamente muestra unmissingComponentTypes, el sistema debería comprobar ese componente. Los componentes faltantes también hacen que una dirección esté incompleta y no se pueda entregar.
2. Otros indicadores
La API de Address Validation también proporciona otros indicadores diagnosticar problemas específicos:
| Componentes sospechosos | Cuando el nivel de confirmación enum para un componente es
UNCOMFIRMED_AND_SUSPICIOUS, es probable que el componente
incorrecto.
|
|---|---|
| Componente sin resolver | Un unresolvedToken es una parte de la entrada que no se reconoce como una parte válida de una dirección. |
3. Indicadores de dirección de EE.UU.
Ciertos campos aplicables solo a las direcciones de EE.UU. proporcionan una señal útil de que el dirección no se puede entregar y debe corregirse. Para una dirección que requiere corregir, deberías ver lo siguiente:
dpvConfirmation
|
Puede ser N, D o vacío.
|
|---|
Para obtener más información sobre dpvConfirmation, consulta
Administra direcciones de Estados Unidos.
Ejemplos de corrección de direcciones
Confirma una dirección
Tú confirmas una dirección cuando el veredicto indica que la API de Address Validation inferimos o realizaste cambios para abordar componentes con el fin de producir dirección validada. En estos casos, tienes una dirección de entrega, pero prefieres mayor confianza de que la dirección resultante es la que pretende el cliente.
Para proporcionarle al cliente la instrucción correcta, tu lógica identificaría
los componentes marcados por el servicio para determinar qué acción o marca la API
al componente, como inferred, replaced o spellCorrected.
Consulta AddressComponent en la referencia.
Confirma los indicadores
La API de Address Validation proporciona varios indicadores para informarte si un dirección de correo electrónico debe confirmarse.
1. Nivel de detalle de la validación
Es aceptable usar un validationGranularity de ROUTE o mejor, pero cualquiera de los dos
PREMISE o SUBPREMISE proporcionan un indicador más sólido de entregabilidad.
2. Otros indicadores
Cuando decides confirmar la entrada de la dirección con el cliente, el veredicto también proporciona la siguiente información para determinar qué componentes investigar:
| Datos inferidos | Cuando el campo hasInferredComponents es true,
sabes que la API completó la información que recopiló de otra dirección
o los componentes de la solución.
|
|---|---|
| Datos reemplazados | Cuando el campo hasReplacedComponents es true, el
La API reemplazó los datos ingresados con datos que consideró que la dirección era válida.
|
3. Indicadores de dirección de EE.UU.
Ciertos campos aplicables solo a las direcciones de EE.UU. indican que tu lógica debe confirmar los detalles con el cliente. Se aplica cualquiera de las siguientes opciones:
dpvConfirmation
|
S
Para obtener más información sobre |
|---|---|
| Respuesta en la dirección | Contiene el campo missingComponentType con el valor de
subpremise
|
Ejemplos de confirmación de dirección
Cómo aceptar una dirección
Se acepta una dirección cuando el veredicto proporciona un alto grado de confianza que La dirección es entregable y se puede usar sin más interacción con el cliente en el proceso descendente.
Aceptar indicadores
La API de Address Validation proporciona varios indicadores para informarte si un dirección de correo electrónico debe confirmarse.
1. Nivel de detalle de la validación
Es aceptable un validationGranularity de PREMISE o mejor, pero en algunos casos
casos, ROUTE aún indica una dirección de entrega.
2. Otros indicadores
Un veredicto para una dirección de alta calidad también debe proporcionar lo siguiente:
- No hay datos reemplazados. En este caso, es
hasReplacedComponents: FALSE. - No hay componentes inferidos. En este caso, es
hasInferredComponents: FALSE.
3. Indicadores de dirección de EE.UU.
Algunos campos aplicables solo a las direcciones de EE.UU. indican una dirección de alta calidad. al que se pueden enviar. Si la dirección es aceptable en EE.UU., debes ver la lo siguiente:
dpvConfirmation
|
Y
Para obtener más información sobre |
|---|