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 fin de capturar direcciones de alta calidad.
Requisitos previos
Google recomienda familiarizarte con los siguientes aspectos:
- Documentación para desarrolladores de JavaScript de Place Autocomplete
- Comprende desde el punto de vista técnico el funcionamiento de Place Autocomplete y sus opciones de implementación.
- Guía de implementación de Place Autocomplete para la implementación de confirmación de la compra.
- Ejemplos de prácticas recomendadas para la implementación de Place Autocomplete en un proceso de confirmación de compra de comercio electrónico.
- API de Address Validation documentación del producto, con un enfoque en Compila tu lógica de validación.
- Comprende desde el 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 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 Sistema de asistencia de precisión de la codificación (CASSTM).¿Por qué necesitas la validación de 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 las entregas exitosas, aumentar la entrega a tiempo y reducir los costos elevados por corrección de direcciones.
Guía a los clientes para que ingresen la dirección de forma rápida y precisa:
Place Autocomplete acelera el ingreso de direcciones y reduce los errores de entrada, lo que permite a los clientes avanzar fácilmente en el proceso de confirmación de la compra. Address Validation proporciona comentarios sobre la calidad general de las direcciones, realiza correcciones como errores ortográficos y de estandarización, y mejora los metadatos, como proporcionar 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 el ingreso de direcciones en las confirmaciones de compras de comercio electrónico. El proceso se compone de tres pasos:
- Utiliza Place Autocomplete para captar inicialmente la dirección.
- 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 en la entrega.
A continuación, analizaremos cada paso de forma individual.
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 ofrece 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 la dirección que muestra los resultados del servicio Autocomplete que se actualizan cada vez que se presiona una tecla. Una vez que el usuario haya ingresado 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 dos estilos de entrada de formulario al usuario: una pantalla con todos los campos de dirección o una con un solo campo de entrada. Este único campo de entrada le indica 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 propaga 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 haga cambios, por ejemplo, agregar un número de departamento o unidad.
A continuación, se muestra un ejemplo de cómo podría aparecer este flujo, utilizando 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 llamar a la API de Address Validation durante 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 Next o Continue en el formulario de dirección. Este botón suele llevar a la página de pagos.
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
Después de ingresar la dirección, muéstrala en un mapa al usuario para confirmar su ubicación de entrega. Esto le ofrece al cliente una mayor certeza de que la dirección es correcta y reduce las fallas de entrega o retiro.
El mapa se puede mostrar durante el proceso de confirmación de la compra o enviarse 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 en el que se muestra la ubicación del usuario. | La API de Maps Static permite incorporar imágenes en la página web o en una etapa posterior de 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:
- 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 cambios desde la dirección de entrada. Puedes solicitar la confirmación.
- Aceptar: La dirección es de alta calidad. Puedes aceptar la dirección proporcionada.
Este concepto se aborda en la sección Compila tu lógica de validación de los documentos 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 la entrada de una dirección. Para obtener información sobre los indicadores específicos que la API de Address Validation muestra para indicar una dirección de baja calidad, consulta Corrige una dirección en la documentación de Cómo compilar 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 dirección para verificar los datos que ingresó. Una vez que se haya corregido la dirección, el servicio debe volver a enviarla a la API de Address Validation para asegurarse de que las correcciones sean válidas.
También puedes destacar errores específicos de la línea de dirección mediante 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 la API de Address Validation muestra para indicar que se debe confirmar una dirección, consulta Confirma una dirección en la documentación de Cómo compilar tu lógica de validación.
Con frecuencia, tu sistema solicitará a un usuario que confirme una dirección. Por ejemplo, un cliente escribe mal el nombre de la ciudad, y la API de Address Validation corregiría el error. Debes confirmar esta corrección con el cliente. Esto se debe a que los cambios que realiza la API podrían alterar fundamentalmente lo que se ingresó originalmente.
Usa una ventana modal intersticial a fin de mostrar la información al cliente y habilita tres opciones para continuar:
- Confirma la dirección como la muestra la API y el proceso de confirmación de la compra continuará con la dirección corregida.
- Selecciona la dirección como se ingresó originalmente e ignora 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 revisión posterior antes del envío, si tu proceso lo permite.
- El cliente cancela o cancela el modo modal, y lo devuelve a la etapa de entrada de direcciones del proceso de confirmación de la compra, en la que puede volver a ingresar la dirección desde cero y comenzar el proceso de nuevo.
En la captura de pantalla de la derecha, se puede ver un ejemplo de esto.
Aceptar
En esta sección, se muestra cómo aceptar una dirección. Para obtener información sobre los indicadores específicos que la API de Address Validation muestra para indicar que una dirección es de buena calidad y debe aceptarse, consulta Acepta una dirección en la documentación sobre cómo compilar 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, la probable captura del pago, sin mensajes al cliente sobre la calidad de la dirección. La API confirmó que la dirección que ingresó el cliente es de buena calidad y es de un entregable.
Recomendamos usar los datos de dirección que muestra la API de Address Validation en el pedido, ya que podrían contener correcciones y adiciones menores, como las siguientes:
- Uso de mayúsculas
- Correcciones de formato, por ejemplo:
- 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 tu implementación no bloquee a los clientes la confirmación de la compra debido a que ingresan una dirección no válida. Construir lógica de manera que se evite la posibilidad de un bucle infinito si la API indica reiteradamente que su entrada no es válida
Google recomienda que les proporciones a los clientes hasta dos oportunidades para que ingresen su dirección y, en el segundo intento, aceptes su entrada, incluso si no se valida. En el segundo intento, el objetivo es permitirles continuar sin importar la validación.
Dos métodos sugeridos para aceptar el segundo intento:
- Forzar continuidad: Muéstrale al cliente una ventana modal que explique que la dirección no se está validando, pero permite que la opción continúe 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 validan, 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 garantiza que detectes cualquier error.
La construcción de un edificio nuevo ofrece un buen ejemplo de por qué se recomienda esta verificación. Puede haber un intervalo entre el momento en que se termina la construcción de un edificio nuevo y el momento en que la dirección de ese edificio se completa en las bases de datos de direcciones postales. Los clientes deben tener la opción de forzar el proceso a través de la página de confirmación de compras con la dirección escrita, incluso si no se valida.
Una vez que se haya completado una sesión de confirmación de la compra, puedes usar el método provideValidationFeedback de manera opcional para enviar a Google comentarios 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 de acuerdo con los flujos de entrada de direcciones recomendados.
Próximos pasos
Descarga el informe sobre Mejora la confirmación de la compra, la entrega y las operaciones con direcciones confiables y consulta el seminario en línea Cómo mejorar la confirmación de la compra, la entrega y las operaciones con la validación de direcciones .
Lectura adicional sugerida:
- 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 Servicio Postal de Estados Unidos. Las siguientes marcas comerciales pertenecen al United States Postal Service® y se utilizan con el permiso correspondiente: CASSTM, USPS®, DPV®. ↩