Objetivo
En este documento, se describen 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 fin de capturar direcciones de alta calidad.
Requisitos previos
Google recomienda que te familiarices con lo siguiente:
- Documentación para desarrolladores de JavaScript de Place Autocomplete.
- 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 las prácticas recomendadas para la implementación de Place Autocomplete en una confirmación de compra de comercio electrónico.
- Documentación del producto de la API de Address Validation, con un enfoque en Crea 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 las direcciones.
¿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 de correos y encuentra las coordenadas de latitud y longitud más conocidas para ella. De forma opcional, para las direcciones de Estados Unidos y Puerto Rico, puedes habilitar el Coding Accuracy Support System (CASS™).¿Por qué necesitas validar la dirección en la confirmación de la compra?
Recopila direcciones precisas durante el proceso de pedido:
Este es un paso importante para promover entregas exitosas, aumentar la entrega a tiempo y reducir los costosos cargos por corrección de direcciones.
Guía a los clientes para que ingresen la dirección con rapidez y precisión:
La función Autocomplete de Place acelera el ingreso de direcciones y reduce los errores de entrada, lo que permite
a los clientes avanzar fácilmente por la confirmación de la compra. Address Validation ofrece comentarios sobre la calidad general de las direcciones, corrige errores como errores ortográficos o de estandarización, y mejora los metadatos (por ejemplo, proporciona un indicador residencial o comercial) (disponible en determinadas regiones).
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 compras del 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 brindar confianza a los clientes sobre las entregas.
A continuación, analizaremos cada paso por separado.
Paso 1: Flujo de entrada de direcciones mediante el servicio Place Autocomplete
Implementa Place Autocomplete con la API de JavaScript en la primera línea del formulario de entrada de direcciones.
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 vez que se presiona una tecla. Una vez que el usuario ingresa suficiente información para encontrar la dirección, la selecciona en el menú desplegable. Esta acción propaga automáticamente los campos del formulario con los datos de la dirección.
Puedes proporcionar dos estilos de entrada de formulario al usuario con Place Autocomplete: una pantalla con todos los campos de dirección o una pantalla con un solo campo de entrada. Este campo de entrada único le solicita al usuario que comience a buscar a medida que escribe, en lugar de ingresar los componentes de la dirección de forma individual. Una vez que Autocompletar propaga la dirección, el flujo de trabajo expande los campos del formulario con los datos de la dirección, lo que permite al cliente revisar y editar, por ejemplo, agregar un número de departamento 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 las direcciones
Después de que el usuario ingrese la dirección, Google recomienda que llames a la API de Address Validation en la confirmación de la 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 dentro de una confirmación de la 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 le ofrece al cliente una mayor certeza 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 la compra o se puede enviar 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 más adelante en un correo electrónico. |
|---|---|
 |
 |
Descripción detallada: abordar las situaciones de aceptación
Las respuestas de la API de Address Validation se pueden categorizar en tres situaciones principales:
- Corregir: La dirección es de baja calidad. Debes solicitar más información.
- Confirmar: La dirección es de alta calidad, pero tiene cambios con respecto a la dirección de entrada. Puedes solicitar 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 muestra 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 Cómo crear tu lógica de validación.
Si la respuesta de la API de Address Validation indica una dirección no válida, redirecciona al cliente al formulario de entrada de direcciones para que verifique los datos que ingresó. Una vez que se corrija la dirección, tu servicio debería volver a enviarla a la API de Address Validation para garantizar que las correcciones realizadas sean válidas.
También puedes destacar errores específicos de la línea 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 muestra 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 Cómo crear tu lógica de validación.
A menudo, tu sistema querrá pedirle al usuario que confirme una dirección. Por ejemplo, un cliente escribe mal el nombre de la ciudad, que la API de Address Validation corregirá. Debes confirmar esta corrección con el cliente. Esto se debe a que los cambios que realiza la API podrían alterar de forma fundamental lo que se ingresó originalmente.
Usa un diálogo modal intersticial para mostrarle la información al cliente y habilitar tres opciones para continuar:
- Confirma la dirección que muestra la API y el proceso de confirmación de la compra continuará con la dirección corregida.
- Selecciona la dirección tal como la ingresaste originalmente, ignorando la corrección de la API de Address Validation. El proceso de confirmación de la compra puede continuar como de costumbre, y el pedido se puede marcar para su revisión posterior antes del envío, si el proceso lo permite.
- El cliente cancela o sale del cuadro modal, lo que lo devuelve a la etapa de entrada de dirección del proceso de confirmación de la compra, donde puede volver a ingresar la dirección desde cero y reiniciar el proceso.
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 muestra 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 Cómo crear tu lógica de validación.
En esta situación, el proceso de confirmación de la compra debería pasar a la siguiente etapa, probablemente la captura de pagos, sin indicaciones para el cliente en cuanto a la calidad de la dirección. La API confirmó que la dirección que ingresó el cliente es de buena calidad y se puede entregar.
Te recomendamos que uses los datos de dirección que se muestran en la API de Address Validation para compararlos con el pedido, ya que podrían contener correcciones y agregados menores, como los siguientes:
- Uso de mayúsculas
- Correcciones de formato, por ejemplo
- De calle a calle
- Orden correcto de los componentes de la dirección
- ZIP+4 en EE.UU.
Consideraciones sobre la implementación
Cuando crees tu lógica de aceptación de direcciones, asegúrate de que la implementación no impida que los clientes confirmen la compra debido a que ingresaron una dirección no válida. Construye la lógica de manera que evite la posibilidad de un bucle infinito si la API indica repetidamente que su 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, aceptar su entrada, incluso si no se valida. En el segundo intento, el objetivo es permitirles continuar sin importar la validación.
Estos son dos métodos sugeridos para aceptar el segundo intento:
- Forzar el procesamiento: Muestra al cliente un cuadro modal en el que se explica que la dirección no se está validando, pero permite la opción de continuar con la dirección que escribió.
- Aceptación silenciosa: 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 que marque las direcciones que no se validen, de modo que un representante del servicio de atención al cliente pueda revisarlas antes de que se envíe el pedido. Esta medida adicional te garantiza que detectes cualquier error.
La construcción de edificios nuevos ofrece una buena ilustración de por qué se recomienda esta verificación. Es posible que haya un intervalo entre el momento en que finaliza la construcción del nuevo edificio y el momento en que la dirección del edificio se propaga en las bases de datos de direcciones postales. Los clientes deben tener la opción de forzar el paso a 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 la compra, puedes usar el método provideValidationFeedback de forma opcional para enviar comentarios a Google sobre un intento de validación de dirección específico.
Conclusión
En este documento, se ofrece una descripción general de un flujo de confirmación de la compra que implementa Autocomplete, Address Validation y la confirmación visual en un mapa de Google Maps. 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 documento Mejora la confirmación de compra, la entrega y las operaciones con direcciones confiables y mira el seminario en línea Cómo mejorar 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: CASSTM, USPS®, DPV®. Ђ