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 com o objetivo de capturar endereços de alta qualidade.

Pré-requisitos

O Google recomenda que você conheça os seguintes recursos:

  • Documentação do desenvolvedor JavaScript do Place Autocomplete.
    • Entender, de um ponto de vista técnico, como o Place Autocomplete funciona e as opções de implementação.
  • Guia de implementação de finalização de compra do Place Autocomplete.
    • Exemplos de práticas recomendadas de implementação do Place Autocomplete em uma finalização de compra de e-commerce.
  • Documentação do produto da API Address Validation, com foco em Criar sua lógica de validação.
    • Entenda do ponto de vista técnico como a API Address Validation funciona e analise os indicadores que determinam a qualidade do endereço.

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

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

Por que a validação do endereço é necessária 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 do atendimento e reduzir as cobranças de correção de endereço caras.

Ajude os clientes a inserir o endereço com rapidez e precisão:
O Place Autocomplete acelera a inserção de endereços e reduz erros de entrada, permitindo que os clientes naveguem facilmente para a finalização da compra. A Address Validation fornece feedback sobre a qualidade geral do endereço, faz correções como padronização e erros ortográficos e melhora os metadados, como fornecer um indicador residencial ou comercial (disponível em algumas regiões).

Visão geral da implementação

Nesta seção, descrevemos o fluxo de trabalho de inserção de endereço recomendado para checkouts 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. Exibir a localização do endereço inserido em um mapa para dar confiança aos clientes de entrega.

A seguir, detalharemos 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 inserção de endereço.

O Place Autocomplete dá sugestões para o cliente quando ele insere os detalhes de endereço. Quando essa implementação é feita com a API JavaScript, à medida que os usuários começam a digitar, uma lista suspensa aparece no campo do formulário de inserção de endereço, mostrando os resultados do serviço Autocomplete, que são atualizados a cada tecla pressionada. 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 de endereço.

Você pode fornecer dois estilos de entrada de formulário ao usuário com o Place Autocomplete: uma exibição com todos os campos de endereço ou uma 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 dele, permitindo que o cliente revise e faça edições, por exemplo, adicionando o número de um apartamento ou unidade.

Veja 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 insere 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 está 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 os cenários de aceitação de endereço posteriormente.

Etapa 3: fornecer confirmação visual

Após a inserção do endereço, ofereça ao usuário uma confirmação visual do local de entrega mostrando-o em um mapa. Isso oferece ao cliente uma garantia adicional de que o endereço está correto e reduz falhas de 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. Ambos os casos de uso podem ser realizados com as APIs a seguir.

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.

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

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

  • Corrigir: o endereço tem baixa qualidade. Solicitar mais informações.
  • Confirmar: o endereço é de alta qualidade, mas tem mudanças em relação ao endereço de entrada. É possível que você solicite confirmação.
  • Aceitar: o endereço é de alta qualidade. É possível aceitar o endereço fornecido.

Esse conceito é abordado na seção Criar sua lógica de validação dos documentos da API Address Validation. Discutiremos cada cenário nesta seção.

Corrigir

imagem

Nesta seção, mostramos 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, o serviço precisará reenviá-lo à API Address Validation para garantir que as correções feitas sejam válidas.

Você também pode destacar erros específicos de linhas de endereço usando os indicadores retornados no nível do addressComponents. Confira um exemplo na captura de tela à direita.

Confirmar

imagem

Nesta seção, mostramos 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, o sistema pedirá que um usuário confirme um endereço. Por exemplo, um cliente digita errado o nome da cidade, que seria corrigido pela API Address Validation. Confirme essa correção com o cliente. Isso ocorre porque as alterações feitas pela API podem alterar fundamentalmente o que foi inserido originalmente.

Use um modal intersticial para exibir as informações ao cliente, ativando três opções para prosseguir:

  1. Confirme o endereço retornado pela API e o processo de finalização de compra vai continuar 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 sinalizado para análise downstream antes do envio, se o processo permitir.
  3. O cliente cancela ou desiste do modal, retornando ao estágio de inserção do endereço no processo de finalização da compra, em que é possível inserir o endereço do zero, iniciando o processo novamente.

Confira um exemplo na captura de tela à direita.

Aceitar

Nesta seção, mostramos como aceitar um endereço. Para informações sobre sinais 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".

Neste 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. 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 ele pode conter pequenas correções e adições, como as seguintes:

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

Considerações sobre a implementação

Ao criar sua 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 a lógica de uma maneira que evite a possibilidade de um loop infinito se a API indicar repetidamente que a entrada dela é 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 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:

  • Force-proceed:mostre ao cliente um modal que explica que o endereço não está validando, mas permita a opção de continuar com o endereço inserido.
  • 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 que o pedido seja enviado. Essa medida extra garante que você detecte erros.

A construção de novos edifícios mostra bem por que essa verificação é recomendada. Pode haver uma lacuna entre a conclusão 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 o próximo passo na página de finalização de compra com o endereço digitado, mesmo que ele não seja validado.

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

Conclusão

Este documento apresenta uma visão geral de um fluxo de finalização de compra que implementa o preenchimento automático, 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 Melhorar a finalização de compra, a entrega e as operações com endereços confiáveis e confira o webinar Como melhorar a finalização de compra, a entrega e as operações com o Address Validation .

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 Serviço Postal dos Estados Unidos® e usadas com permissão: CASSTM, USPS®, DPV®. ↩