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 um processo de finalização de compra de e-commerce para capturar endereços de alta qualidade.

Pré-requisitos

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

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

A API Address Validation é um serviço que aceita um endereço. Ele identifica e valida os componentes do endereço. Ele também padroniza o endereço de correspondência e encontra as coordenadas de latitude/longitude mais conhecidas. Opcionalmente, para endereços nos Estados Unidos e em Porto Rico, você pode 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 cumprimento no prazo e reduzir as cobranças de correção de endereço.

Guie os clientes para inserir o endereço de forma rápida e precisa
:o preenchimento automático de lugar acelera a inserção de endereços e reduz os erros de entrada, permitindo que os clientes concluam a compra com facilidade. A Address Validation dá feedback sobre a qualidade geral do endereço, faz correções, como padronização e erros ortográficos, e aprimora os metadados, como fornecer um indicador residencial ou comercial (disponível em algumas regiões).

Visão geral da implementação

Esta seção descreve o fluxo de trabalho recomendado para a inserção de endereços em pagamentos de e-commerce. O processo é composto por três etapas:

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

A seguir, vamos analisar cada etapa individualmente.

Etapa 1: fluxo de inserção de endereços usando o serviço Place Autocomplete

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

O Place Autocomplete oferece sugestões ao cliente conforme ele digita 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 de formulário de entrada de endereço, mostrando os resultados do serviço de preenchimento automático que são atualizados a cada tecla pressionada. Depois que o usuário digita 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 de endereço.

Você pode oferecer dois estilos de entrada de formulário ao usuá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 enquanto 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 de validação de endereço no final 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óxima" 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ços mais adiante.

Etapa 3: fornecer confirmação visual

Após a inserção do endereço, mostre para o usuário uma confirmação visual do local de entrega em um mapa. Isso oferece ao cliente mais garantia de que o endereço está correto e reduz falhas 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 alcançados com as seguintes APIs.

A API Maps JavaScript oferece 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 um e-mail mais tarde.

Detalhes: cenários de aceitação de endereços

As respostas da API de validação de endereço podem ser categorizadas em três cenários principais:

  • Corrigir: o endereço tem baixa qualidade. Você precisa pedir mais informações.
  • Confirmar: o endereço é de alta qualidade, mas tem mudanças em relação ao endereço de entrada. Talvez seja necessário confirmar.
  • Aceitar: 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 dos documentos da API Address Validation. Vamos discutir cada um dos cenários desta seção.

Corrigir

imagem

Esta seção mostra como corrigir uma entrada de endereço. Para informações sobre sinais 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 inserção de endereço para verificar os dados inseridos. Depois que o endereço for corrigido, seu serviço precisará ser reenviado para a API de validação de endereço 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. Confira um exemplo na captura de tela à direita.

Confirmar

imagem

Esta seção mostra como confirmar um endereço. Para saber mais sobre os 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, seu sistema vai pedir que o usuário confirme um endereço. Por exemplo, um cliente digita incorretamente o nome da cidade, que seria corrigido pela API Address Validation. Confirme essa correção com o cliente. Isso acontece porque as mudanças feitas pela API podem alterar significativamente 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 de compra continua usando o endereço corrigido.
  2. Selecione o endereço como foi inserido originalmente, ignorando a correção da API Address Validation. O processo de finalização de compra pode continuar normalmente, e o pedido pode ser sinalizado para análise antes do envio, se o processo permitir.
  3. O cliente cancela ou sai do modal, retornando ao estágio de entrada de endereço do processo de finalização da compra, onde 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 saber mais sobre os indicadores específicos que a API Address Validation retorna para indicar que um endereço é de boa qualidade e deve 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 prompts para o cliente em relação à 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 pela API Address Validation no pedido, porque ele pode conter correções e adições menores, como as seguintes:

  • Letras maiúsculas
  • Correções de formatação, por exemplo:
    • Rua para St
    • Ordem correta dos componentes do endereço
  • CEP +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 os clientes de finalizar 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ê dê aos clientes até duas chances de inserir o endereço e, na segunda tentativa, aceite a entrada, mesmo que ela não seja válida. Na segunda tentativa, o objetivo é permitir que eles prossigam, independentemente da validação.

Dois métodos sugeridos para aceitar a segunda tentativa:

  • Forçar o andamento:mostre ao cliente um modal explicando que o endereço não está sendo validado, mas permita que ele continue com o endereço digitado.
  • Aceitação silenciosa:aceite automático da segunda tentativa sem uma etapa de confirmação, mesmo que o endereço não seja totalmente validado.

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

A construção de um novo edifício é um bom exemplo de por que essa verificação é recomendada. Pode haver um intervalo entre o término da construção de um novo edifício e o preenchimento do endereço dele nos bancos de dados de endereços postais. Os clientes precisam ter a opção de forçar a finalização da compra com o endereço digitado, mesmo que ele não seja válido.

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

Conclusão

Este documento forneceu uma visão geral de um fluxo de finalização da compra que implementa a autocompletar, a validação de endereço 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

Faça o download do documento técnico Melhorar a finalização da compra, o envio e as operações com endereços confiáveis e assista o webinar Como melhorar a finalização da compra, o envio e as operações com a validação de endereço .

Leitura adicional sugerida:

Colaboradores

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

  1. Licenciada não exclusiva do Serviço Postal dos Estados Unidos. As marcas comerciais a seguir são do United States Postal Service® e usadas com permissão: CASS™, USPS® e DPV®. ↩