Objetivo
En este documento, se describen los métodos para combinar Place Autocomplete, la API de Address Validation1 y Maps en una confirmación de compra de comercio electrónico con el objetivo de capturar direcciones de alta calidad.
Requisitos previos
Google recomienda que te familiarices con lo siguiente:
- Place Autocomplete, documentación para desarrolladores de JavaScript
- Comprende desde un punto de vista técnico cómo funciona Place Autocomplete y sus opciones de implementación.
- Guía de implementación de Checkout para Place Autocomplete
- Ejemplos de prácticas recomendadas para la implementación de Place Autocomplete en la confirmación de compra de un comercio electrónico.
- Documentación del producto de la API de Address Validation, con un enfoque en Cómo compilar tu lógica de validación
- Comprende desde un punto de vista técnico cómo funciona la API de Address Validation y revisa los indicadores que determinan la calidad de la dirección.
¿Qué es la validación de direcciones?
La API de Address Validation es un servicio que acepta una dirección. Identifica los componentes de la dirección y los valida. También estandariza la dirección para el envío por correo y encuentra las coordenadas de latitud y longitud más conocidas para ella. De manera opcional, para las direcciones de Estados Unidos y Puerto Rico, puedes habilitar el Coding Accuracy Support System (CASS™).¿Por qué necesitas la validación de direcciones en la confirmación de compra?
Recopila direcciones exactas durante el proceso de pedido:
Este es un paso importante para promover entregas exitosas, aumentar el cumplimiento a tiempo y reducir los costosos cargos por corrección de direcciones.
Guía a los clientes para que ingresen la dirección de forma rápida y precisa:
La función de autocompletar lugares acelera el ingreso de la dirección y reduce los errores de entrada, lo que permite que los clientes avancen fácilmente por la confirmación de la compra. Address Validation proporciona comentarios sobre la calidad general de la dirección, realiza correcciones, como la estandarización y los errores ortográficos, y mejora los metadatos, por ejemplo, proporcionando un indicador residencial o comercial (disponible en regiones seleccionadas).
Descripción general de la implementación
En esta sección, se describe el flujo de trabajo recomendado para ingresar direcciones en las confirmaciones de compra de comercio electrónico. El proceso consta de tres pasos:
- Usa Place Autocomplete para capturar la dirección inicialmente.
- Usa la API de Address Validation para confirmar la dirección ingresada.
- Muestra la ubicación de la dirección ingresada en un mapa para que los clientes tengan confianza en la entrega.
A continuación, analizaremos cada paso por separado.
Paso 1: Flujo de entrada de la dirección (con el servicio Place Autocomplete)
Implementa Place Autocomplete con la API de JavaScript en la primera línea del formulario de entrada de dirección.
Place Autocomplete proporciona sugerencias al cliente a medida que ingresa los detalles de su dirección. Cuando se implementa con la API de JavaScript, a medida que los usuarios comienzan a escribir, aparece un menú desplegable debajo del campo del formulario de entrada de dirección, que muestra los resultados del servicio de Autocomplete que se actualizan con cada pulsación de tecla. Una vez que el usuario ingresó suficiente información para encontrar la dirección, la selecciona en el menú desplegable. Esta acción completa automáticamente los campos del formulario con los datos de la dirección.
Con Place Autocomplete, puedes proporcionar al usuario dos estilos de entrada de formulario: una pantalla con todos los campos de dirección o una pantalla con un solo campo de entrada. Este único campo de entrada le solicita al usuario que comience a buscar mientras escribe, en lugar de ingresar los componentes de la dirección de forma individual. Una vez que el autocompletado rellena la dirección, el flujo de trabajo expande los campos del formulario con los datos de la dirección, lo que permite que el cliente revise y realice ediciones, por ejemplo, agregar un número de apartamento o unidad.
Este es un ejemplo de cómo podría aparecer este flujo, con un solo campo de entrada:
Paso 2: Usa la API de Address Validation para validar direcciones
Después de que el usuario ingresa la dirección, Google te recomienda que llames a la API de Address Validation en la confirmación de compra para confirmar que la dirección sea válida y esté completa. Activa una llamada a la API de Address Validation cuando el usuario haga clic en el botón Siguiente o Continuar en el formulario de dirección. Este botón suele dirigir a la página de pago.
Google recomienda llamar a la API de Address Validation para cada transacción.
En el siguiente diagrama de flujo, se ilustra un ejemplo de integración de extremo a extremo de la API de Address Validation en una confirmación de compra:
En este documento, se analizan las situaciones de aceptación de direcciones más adelante.
Paso 3: Proporciona una confirmación visual
Una vez ingresada la dirección, proporciona al usuario una confirmación visual de la ubicación de entrega mostrándola en un mapa. Esto ofrece al cliente una garantía adicional de que la dirección es correcta y reduce los inconvenientes de entrega o retiro.
El mapa se puede mostrar durante el proceso de confirmación de compra o incluirse en el correo electrónico de confirmación de la transacción. Ambos casos de uso se pueden lograr con las siguientes APIs.
| La API de Maps JavaScript proporciona un mapa interactivo para mostrar la ubicación del usuario. | La API de Maps Static permite incorporar imágenes en la página web o en una etapa posterior en un correo electrónico. |
|---|---|
 |
 |
Análisis detallado: Situaciones de aceptación de direcciones
Las respuestas de la API de Address Validation se pueden clasificar en tres situaciones principales:
- Corrección: La dirección es de baja calidad. Debes solicitar más información.
- Confirm: La dirección es de alta calidad, pero tiene cambios con respecto a la dirección de entrada. Es posible que se te solicite confirmación.
- Aceptar: La dirección es de alta calidad. Puedes aceptar la dirección proporcionada.
Este concepto se aborda en la sección Crea tu lógica de validación de la documentación de la API de Address Validation, y analizaremos cada situación en esta sección.
Corregir
En esta sección, se muestra cómo corregir una entrada de dirección. Para obtener información sobre los indicadores específicos que devuelve la API de Address Validation para indicar una dirección de baja calidad, consulta Cómo corregir una dirección en la documentación de Crea tu lógica de validación.
Si la respuesta de la API de Address Validation indica que la dirección no es válida, redirecciona al cliente al formulario de entrada de dirección para que verifique los datos que ingresó. Una vez que se haya corregido la dirección, tu servicio debe volver a enviar la solicitud a la API de Address Validation para garantizar que las correcciones realizadas sean válidas.
También puedes destacar errores específicos en las líneas de dirección con los indicadores que se muestran a nivel de addressComponents. Puedes ver un ejemplo de esto en la captura de pantalla de la derecha.
Confirmar
En esta sección, se muestra cómo confirmar una dirección. Para obtener información sobre los indicadores específicos que devuelve la API de Address Validation para indicar que se debe confirmar una dirección, consulta Cómo confirmar una dirección en la documentación de Crea tu lógica de validación.
A menudo, tu sistema querrá solicitarle a un usuario que confirme una dirección. Por ejemplo, un cliente escribe mal el nombre de la ciudad, que luego se corregiría con la API de Address Validation. Debes confirmar esta solución con el cliente. Esto se debe a que los cambios que realiza la API pueden alterar fundamentalmente lo que se ingresó originalmente.
Usa un modal intersticial para mostrar la información al cliente, lo que permite tres opciones para continuar:
- Confirma la dirección que devolvió la API y el proceso de confirmación de compra continúa con la dirección corregida.
- Selecciona la dirección tal como se ingresó originalmente, sin tener en cuenta la corrección de la API de Address Validation. El proceso de confirmación de compra puede continuar con normalidad, y el pedido se puede marcar para su revisión posterior antes del envío, si tu proceso lo permite.
- El cliente cancela el modal o sale de él, lo que lo devuelve a la etapa de ingreso de la dirección del proceso de confirmación de la compra, donde puede volver a ingresar la dirección desde cero y comenzar el proceso de nuevo.
Puedes ver un ejemplo de esto en la captura de pantalla de la derecha.
Aceptar
En esta sección, se muestra cómo aceptar una dirección. Si deseas obtener información sobre los indicadores específicos que devuelve la API de Address Validation para indicar que una dirección es de buena calidad y se debe aceptar, consulta Cómo aceptar una dirección en la documentación de Crea tu lógica de validación.
En este caso, el proceso de confirmación de la compra debería pasar a la siguiente etapa, probablemente la captura del pago, sin que se le muestre al cliente ningún mensaje sobre la calidad de la dirección. La API confirmó que la dirección que ingresó el cliente es de buena calidad y que se puede realizar la entrega.
Te recomendamos que uses los datos de dirección que devuelve la API de Address Validation en el pedido, ya que pueden contener correcciones y adiciones menores, como las siguientes:
- Uso de mayúsculas
- Correcciones de formato, por ejemplo:
- Calle a St
- Orden correcto de los componentes de la dirección
- ZIP+4 en EE.UU.
Consideraciones sobre la implementación
Cuando desarrolles la lógica de aceptación de direcciones, asegúrate de que tu implementación no impida que los clientes completen la compra por ingresar una dirección no válida. Construye la lógica de manera que se evite la posibilidad de un bucle infinito si la API indica repetidamente que la entrada no es válida.
Google recomienda que les brindes a los clientes hasta dos oportunidades para ingresar su dirección y, en el segundo intento, aceptes su entrada, incluso si no se valida. En el segundo intento, el objetivo es permitir que continúe independientemente de la validación.
A continuación, se sugieren dos métodos para aceptar el segundo intento:
- Forzar la continuación: Mostrarle al cliente un modal en el que se explique que la dirección no se valida, pero permitirle continuar con la dirección que ingresó.
- Aceptación silenciosa: Se acepta automáticamente el segundo intento sin un paso de confirmación, incluso si la dirección no se valida por completo.
Si es posible, diseña tu sistema para marcar las direcciones que no se validan, de modo que un representante de atención al cliente pueda revisarlas antes de que se envíe el pedido. Esta medida adicional garantiza que detectes cualquier error.
La construcción de un edificio nuevo ofrece una buena ilustración de por qué se recomienda esta verificación. Es posible que haya un lapso entre la finalización de la construcción de un edificio nuevo y el momento en que la dirección de ese edificio se complete en las bases de datos de direcciones postales. Los clientes deben tener la opción de forzar la continuación del proceso en la página de confirmación de la compra con la dirección que escribieron, incluso si no se valida.
Una vez que se complete una sesión de confirmación de compra, puedes usar el método provideValidationFeedback para enviar comentarios a Google sobre un intento específico de validación de dirección.
Conclusión
En este documento, se proporcionó una descripción general de un flujo de confirmación de compra que implementa Autocomplete, Address Validation y la confirmación visual en un mapa de Google. Usa este documento como punto de partida para diseñar tu implementación, siguiendo los flujos de entrada de direcciones recomendados.
Próximos pasos
Descarga el Informe técnico sobre cómo optimizar la confirmación de compra, la entrega y las operaciones con direcciones confiables y mira el seminario web sobre cómo optimizar la confirmación de compra, la entrega y las operaciones con la Validación de direcciones .
Lecturas adicionales sugeridas:
- Documentación de Place Autocomplete
- Documentación de la API de Address Validation
- Informes de Google Maps Platform
Colaboradores
Henrik Valve | Ingeniero de soluciones
Thomas Anglaret | Ingeniero de soluciones
Sarthak Ganguly | Ingeniero de soluciones
-
Licenciatario no exclusivo del United States Postal Service. Las siguientes marcas son propiedad del United States Postal Service® y se utilizan con el permiso correspondiente: CASS™, USPS® y DPV®. ↩