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 Validation¹ 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:

• Documentação para desenvolvedores do Place Autocomplete
  • Do ponto de vista técnico, entenda como o Place Autocomplete funciona e quais são 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 sinais que determinam a qualidade do endereço.

Faça um teste:acesse o console do Google Cloud e ative a API Address Validation.

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

A API Address Validation é um serviço que aceita um endereço. Ele identifica e valida componentes de 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 Coding Precisão Support System (CASSTM).

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.

Oriente os clientes a inserir o endereço com rapidez e precisão:
O Place Autocomplete acelera a inserção de endereços e reduz os erros de entrada, facilitando a finalização da compra. A Address Validation fornece feedback sobre a qualidade geral do endereço, faz correções, como erros de padronização e ortografia e aprimora metadados, como 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 recomendado de inserção de endereço para finalização de compra 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 nos aprofundar em 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 oferece sugestões para o cliente quando ele insere os detalhes de endereço. Quando ela é implementada usando a API JavaScript, conforme os usuários começam a digitar, um menu suspenso aparece abaixo do campo do formulário de inserção 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 inserir informações suficientes para encontrar o endereço, ele o selecionará na lista suspensa. 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.

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

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 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ó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:

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, forneça ao usuário uma confirmação visual do local de entrega exibindo-o 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 exibido 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 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 posteriormente em um e-mail.

Observação :use o geocódigo retornado pela API Address Validation para mostrar o local de um endereço inserido.

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

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

• Correção: o endereço está de baixa qualidade. Você vai precisar pedir mais informações.
• Confirmar: o endereço é de alta qualidade, mas o endereço de entrada sofre alterações. 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 cenário nesta seção.

Dica: a lógica também está disponível como um componente da Web de código aberto na Biblioteca de componentes estendidos.

Corrigir

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 precisa ser reenviado à API Address Validation para garantir que as correções feitas sejam válidas.

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

---

Confirmar

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 solicitará que o usuário confirme um endereço. Por exemplo, um cliente digita incorretamente o nome da cidade, o 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 originalmente inserido.

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

1. Confirme o endereço conforme retornado pela API, e o processo de finalização da 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 à etapa de entrada de 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

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 tem 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 de compra precisa avançar para a próxima etapa, provavelmente a captura do pagamento, sem avisos ao cliente sobre a qualidade. A API confirmou que o endereço informado 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
  • Ordenação correta dos componentes de endereço
• ZIP+4 nos EUA.

Dica :mostre o endereço para o cliente na página de captura de pagamento, mesmo que ninguém chame a atenção para ele.

---

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 maneira a evitar 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 é deixar o cliente continuar, independente da validação.

Dois métodos sugeridos para aceitar a segunda tentativa:

• Avançar:mostre ao cliente um modal explicando que o endereço não é validado, mas permita a opção de continuar 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, de modo que um representante de atendimento ao cliente possa analisá-los antes de o pedido ser enviado. Essa medida extra garante que você detecte erros.

A construção de novos edifícios mostra por que essa verificação é recomendada. Pode haver uma lacuna entre o momento em que a construção do novo edifício é concluída e o endereço dele é preenchido nos bancos de dados de endereços postais. Os clientes precisam ter a opção de forçar a entrada 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 de compra for concluída, você poderá usar o método provideValidationFeedback para enviar feedback ao Google sobre uma tentativa específica de validação de endereço.

Conclusão

Neste documento, apresentamos 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 Maps. 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 Address Validation .

Leitura adicional sugerida:

• Documentação do Place Autocomplete
• Documentação da API Address Validation
• Geração de relatórios da Plataforma Google Maps

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®. ↩