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

Objetivo

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

Pré-requisitos

O Google recomenda ter familiaridade com os seguintes itens:

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 para ele. Opcionalmente, para endereços nos Estados Unidos e em Porto Rico, é possível ativar o Sistema de suporte de precisão de codificação (CASSTM, na sigla em inglês).

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

Colete endereços precisos durante o processo de pedido:
Essa é uma etapa importante para promover entregas bem-sucedidas, aumentar o prazo e reduzir as cobranças caras 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. Usar o Place Autocomplete para capturar inicialmente o endereço.
  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 de entrega aos clientes.

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 para o cliente enquanto ele digita os detalhes de 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 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 fornecer dois estilos de entrada de formulário ao usuário com o Place Autocomplete: um com todos os campos de endereço ou um 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 componentes de endereço individualmente. Depois que o endereço é preenchido automaticamente, 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, adicionar o número de um 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 em 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 momento do pagamento 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 em cada transação.

O fluxograma 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 exibir o local 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.

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

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. Você pode solicitar uma confirmação.
  • 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 da 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 informações sobre sinais 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 prosseguir:

  1. Confirme se o endereço foi retornado pela API, e o processo de finalização da compra vai continuar usando o endereço correto.
  2. Selecione o endereço como foi 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 sinalizado para análise downstream antes do envio, se o processo permitir.
  3. O cliente cancela ou desiste do modal, retornando à etapa de inserção do endereço no processo de finalização da compra, onde pode reinserir o endereço do zero, iniciando o processo de novo.

Confira um exemplo 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 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 a 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 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ê ofereça aos clientes até duas chances para inserir o endereço e, na segunda tentativa, aceite a inscrição, mesmo que ela não seja validada. 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:aceita automaticamente a 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 é uma boa ilustração de por que essa verificação é recomendada. Pode haver uma lacuna entre o término da construção de um novo edifício e o momento em que o endereço dele é preenchido 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 artigo Como melhorar a finalização de compras, a entrega e as operações com endereços confiáveis e assista ao webinar Como melhorar a finalização de compras, a entrega 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. Licenciado não exclusivo do Serviço Postal dos Estados Unidos. As marcas registradas a seguir são do United States Postal Service® e usadas com permissão: CASSTM, USPS®, DPV®. ↩