Validação de endereço para a finalização de compra de e-commerce

Objetivo

Este documento descreve métodos para combinar o Place Autocomplete, a API Address Validation1 e o Maps em uma finalização de compra de e-commerce com o objetivo de capturar endereços de alta qualidade.

Pré-requisitos

O Google recomenda que você esteja familiarizado com o seguinte:

O que é a validação de endereço?

A API Address Validation é um serviço que aceita um endereço. Ela identifica os componentes do endereço e os valida. Ela também padroniza o endereço para correspondência e encontra as coordenadas de latitude/longitude mais conhecidas para ele. Opcionalmente, para endereços nos Estados Unidos e em Porto Rico, é possível ativar o Coding Accuracy Support System (CASS™).

Por que você precisa da validação de endereço na finalização da compra?

Coletar endereços precisos durante o processo de pedido:
Essa é uma etapa importante para promover entregas bem-sucedidas, aumentar o atendimento no prazo e reduzir cobranças caras de correção de endereço.

Orientar os clientes a inserir o endereço de forma rápida e precisa
O Place Autocomplete acelera a entrada de endereços e reduz erros de entrada, permitindo que os clientes passem facilmente pela finalização da compra. A API Address Validation fornece feedback sobre a qualidade geral do endereço, faz correções, como padronização e erros de ortografia, e melhora os metadados, como fornecer um indicador residencial ou comercial (disponível em regiões selecionadas).

Visão geral da implementação

Esta seção descreve o fluxo de trabalho recomendado para entrada de endereços em finalizações de compra de e-commerce. O processo é composto por três etapas:

  1. Use o Place Autocomplete para capturar inicialmente o endereço.
  2. Use a API Address Validation para confirmar o endereço inserido.
  3. Mostre a localização do endereço inserido em um mapa para dar confiança aos clientes.

Em seguida, vamos analisar cada etapa individualmente.

Etapa 1: fluxo de entrada de endereço usando o serviço Place Autocomplete

Implemente o Place Autocomplete usando a API JavaScript na primeira linha do formulário de entrada de endereço.

O Place Autocomplete fornece sugestões ao cliente à medida que ele insere os detalhes do endereço. Quando implementado usando a API JavaScript, à medida que os usuários começam a digitar, um menu suspenso aparece abaixo do campo do formulário de entrada de endereço, mostrando resultados do serviço Autocomplete que são atualizados a cada pressionamento de tecla. Depois que o usuário insere informações suficientes para encontrar o endereço, ele o seleciona no menu suspenso. Essa ação preenche automaticamente os campos do formulário com os dados do endereço.

É possível fornecer ao usuário dois estilos de entrada de formulário com o Place Autocomplete: uma tela com todos os campos de endereço ou uma tela com um único campo de entrada. Esse campo de entrada único solicita que o usuário comece a pesquisar à medida que digita, em vez de inserir os componentes do endereço individualmente. Depois que o preenchimento automático preenche o endereço, o fluxo de trabalho expande os campos do formulário com os dados do endereço, permitindo que o cliente revise e faça edições, por exemplo, adicionando um número de apartamento ou unidade.

Confira um exemplo de como esse fluxo pode aparecer, usando um único campo de entrada:

imagem

Etapa 2: usar a API Address Validation para validar endereços

Depois que o usuário inserir o endereço, o Google recomenda que você chame a API Address Validation na finalização da compra para confirmar se o endereço é válido e completo. Acione uma chamada para a API Address Validation quando o usuário clicar no botão "Próximo" ou "Continuar" no formulário de endereço. Esse botão geralmente leva à página de pagamento.

O Google recomenda chamar a API Address Validation para cada transação.

O diagrama de fluxo a seguir ilustra um exemplo de integração completa da API Address Validation em uma finalização de compra:

imagem

Este documento discute cenários de aceitação de endereço mais tarde.

Etapa 3: fornecer confirmação visual

Após a inserção do endereço, mostre ao usuário uma confirmação visual do local de entrega exibindo-o em um mapa. Isso dá ao cliente uma garantia a mais de que o endereço está correto e reduz erros na entrega ou retirada.

O mapa pode ser mostrado durante o processo de finalização da compra ou enviado no e-mail de confirmação da transação. Esses dois casos de uso podem ser realizados com as APIs a seguir.

A API Maps JavaScript fornece um mapa interativo para mostrar a localização do usuário. A API Maps Static permite a incorporação de imagens na página da Web ou em uma etapa posterior em um e-mail.

Análise detalhada: cenários de aceitação de endereço

As respostas da API Address Validation podem ser categorizadas em três cenários principais:

  • Fix : o endereço é de baixa qualidade. Você precisa solicitar mais informações.
  • Confirm: o endereço é de alta qualidade, mas tem mudanças em relação ao endereço de entrada. Talvez seja necessário solicitar a confirmação.
  • Accept: o endereço é de alta qualidade. Você pode aceitar o endereço fornecido.

Esse conceito é abordado na seção Criar sua lógica de validação da documentação da API Address Validation, e vamos discutir cada cenário nesta seção.

Correção

imagem

Esta seção mostra como corrigir uma entrada de endereço. Para informações sobre indicadores específicos que a API Address Validation retorna para indicar um endereço de baixa qualidade, consulte Corrigir um endereço na documentação Criar sua lógica de validação.

Se a resposta da API Address Validation indicar um endereço inválido, redirecione o cliente para o formulário de entrada de endereço para verificar os dados inseridos. Depois que o endereço for corrigido, seu serviço precisará reenviar para a API Address Validation para garantir que as correções feitas sejam válidas.

Também é possível destacar erros específicos de linha de endereço usando os indicadores retornados no nível addressComponents. Um exemplo disso pode ser visto na captura de tela à direita.

Confirmar

imagem

Esta seção mostra como confirmar um endereço. Para informações sobre indicadores específicos que a API Address Validation retorna para indicar que um endereço precisa ser confirmado, consulte Confirmar um endereço na documentação Criar sua lógica de validação.

Muitas vezes, o sistema vai solicitar que um usuário confirme um endereço. Por exemplo, um cliente digita o nome da cidade incorretamente, que é corrigido pela API Address Validation. Você precisa confirmar essa correção com o cliente. Isso ocorre porque as mudanças feitas pela API podem alterar fundamentalmente o que foi inserido originalmente.

Use um modal intersticial para mostrar as informações ao cliente, permitindo três opções para continuar:

  1. Confirme o endereço retornado pela API e o processo de finalização da compra continua usando o endereço corrigido.
  2. Selecione o endereço inserido originalmente, ignorando a correção da API Address Validation. O processo de finalização da compra pode continuar normalmente, e o pedido pode ser marcado para revisão downstream antes do envio, se o processo permitir.
  3. O cliente cancela ou sai do modal, retornando à etapa de entrada de endereço do processo de finalização da compra, em que ele pode inserir o endereço do zero, reiniciando o processo.

Um exemplo disso pode ser visto na captura de tela à direita.

Aceitar

Esta seção mostra como aceitar um endereço. Para informações sobre indicadores específicos que a API Address Validation retorna para indicar que um endereço é de boa qualidade e precisa ser aceito, consulte Aceitar um endereço na documentação Criar sua lógica de validação.

Nesse cenário, o processo de finalização da compra precisa passar para a próxima etapa, provavelmente a captura de pagamento, sem avisos ao cliente sobre a qualidade do endereço. A API confirmou que o endereço inserido pelo cliente é de boa qualidade e pode ser entregue.

Recomendamos usar os dados de endereço retornados da API Address Validation no pedido, porque eles podem conter pequenas correções e adições, como as seguintes:

  • Letras maiúsculas
  • Correções de formatação, por exemplo
    • Rua para St
    • Ordem correta dos componentes do endereço
  • ZIP+4 nos EUA.

Considerações sobre a implementação

Ao criar a lógica de aceitação de endereço, verifique se a implementação não impede que os clientes finalizem a compra devido à inserção de um endereço inválido. Crie uma lógica que impeça a possibilidade de um loop infinito se a API indicar repetidamente que a entrada é inválida.

O Google recomenda que você ofereça aos clientes até duas chances de inserir o endereço e, na segunda tentativa, aceite a entrada, mesmo que ela não seja validada. Na segunda tentativa, o objetivo é permitir que eles continuem, independentemente da validação.

Dois métodos sugeridos para aceitar a segunda tentativa:

  • Forçar a continuação:mostre ao cliente um modal explicando que o endereço não está sendo validado, mas permita a opção de continuar com o endereço digitado.
  • Aceitação silenciosa:aceite automaticamente a segunda tentativa sem uma etapa de confirmação, mesmo que o endereço não seja totalmente validado.

Se possível, crie seu sistema para marcar endereços que não são validados, para que um representante de atendimento ao cliente possa revisá-los antes do envio do pedido. Essa medida extra garante que você detecte erros.

A construção de um novo prédio oferece uma boa ilustração de por que essa verificação é recomendada. Pode haver uma lacuna entre o momento em que a construção de um novo prédio é concluída e quando o endereço desse prédio é preenchido nos bancos de dados de endereços postais. Os clientes precisam ter a opção de forçar a continuação na página de finalização da compra com o endereço digitado, mesmo que ele não seja validado.

Depois que uma sessão de finalização da compra for concluída, use opcionalmente o provideValidationFeedback método para enviar feedback ao Google sobre uma tentativa específica de validação de endereço.

Conclusão

Este documento oferece uma visão geral de um processo de finalização da compra que implementa o preenchimento automático, o Address Validation e a confirmação visual em um mapa do Google. Use este documento como ponto de partida para projetar sua implementação, seguindo os fluxos de entrada de endereço recomendados.

Próximas etapas

Leituras sugeridas:

Colaboradores

Henrik Valve | Engenheiro de soluções
Thomas Anglaret | Engenheiro de soluções
Sarthak Ganguly | Engenheiro de soluções

  1. Licenciado não exclusivo do United States Postal Service. As marcas comerciais a seguir são do United States Postal Service® e usadas com permissão: CASS™, USPS®, DPV®. ↩