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ê tenha familiaridade com o seguinte:
- Place Autocomplete documentação para
desenvolvedores em JavaScript.
- Entenda, do ponto de vista técnico, como o Place Autocomplete funciona e quais são as opções de implementação.
- Guia de implementação de finalização de compra para o 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 é a 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 para correspondência e encontra as coordenadas de latitude/longitude mais conhecidas para ele. Se quiser, para endereços nos Estados Unidos e em Porto Rico, ative o Coding Accuracy Support System (CASS™).Por que você precisa da 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 cumprimento
no prazo e reduzir as cobranças caras de correção de endereço.
Ajude os clientes a inserir o endereço de forma rápida e precisa:
o preenchimento automático de lugares acelera a entrada de endereços e reduz erros de entrada, permitindo
que os clientes passem facilmente pelo processo de finalização da compra. A validação de endereço dá 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ço em finalizações de compra de e-commerce. O processo consiste em três etapas:
- Use o Place Autocomplete para capturar o endereço inicialmente.
- Use a API Address Validation para confirmar o endereço inserido.
- Mostre o local do endereço inserido em um mapa para dar confiança aos clientes na entrega.
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 enquanto ele insere os detalhes do endereço. Quando implementada usando a API JavaScript, à medida que os usuários começam a digitar, um menu suspenso aparece abaixo do campo 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 inserir informações suficientes para encontrar o endereço, ele o selecionará no menu suspenso. Essa ação preenche automaticamente os campos do formulário com os dados de endereço.
É possível oferecer ao usuário dois estilos de entrada de formulário com o Place Autocomplete: uma exibição com todos os campos de endereço ou uma exibição com um único campo de entrada. Esse campo ú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 inserir o endereço, o fluxo de trabalho vai expandir 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:
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 no checkout 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:
Este documento discute cenários de aceitação de endereço 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 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. 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 incorporar imagens na página da Web ou em um estágio 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:
- 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 pedir 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 da documentação da API Address Validation, e vamos discutir cada cenário nesta seção.
Correção
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 linhas de endereço usando os indicadores retornados no nível 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 pede que um usuário confirme um endereço. Por exemplo, um cliente digita o nome da cidade errado, que é corrigido pela API Address Validation. Confirme essa correção com o cliente. Isso acontece 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:
- Confirme o endereço retornado pela API e o processo de finalização da compra continua usando o endereço corrigido.
- 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.
- O cliente cancela ou sai da caixa de diálogo, 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 sinais 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 deve passar para a próxima etapa, provavelmente a captura de pagamento, sem solicitações ao cliente em relação à qualidade do endereço. A API confirmou que o endereço inserido pelo cliente é de boa qualidade e pode receber entregas.
Recomendamos usar os dados de endereço retornados da API Address Validation em relação ao pedido, porque eles podem conter pequenas correções e adições, como:
- Letras maiúsculas
- Correções de formatação, por exemplo
- Rua para Rua
- Ordem correta dos componentes de 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 que os clientes finalizem a compra por terem inserido 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 validada. Na segunda tentativa, o objetivo é permitir que eles continuem, independente da validação.
Dois métodos sugeridos para aceitar a segunda tentativa:
- Forçar prosseguimento: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, crie um sistema para sinalizar endereços inválidos para que um representante de atendimento ao cliente possa revisá-los antes do envio do pedido. Essa medida extra garante que você detecte qualquer erro.
A construção de um novo edifício é um bom exemplo de 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 é incluído nos bancos de dados de endereços postais. Os clientes precisam ter a opção de prosseguir pela 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 pagamento for concluída, use opcionalmente o método
provideValidationFeedback
para enviar feedback ao Google sobre uma tentativa específica de validação de endereço.
Conclusão
Este documento apresentou uma visão geral de um fluxo de finalização de compra que implementa preenchimento automático, validação de endereço e 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
Baixe o Whitepaper "Melhore a finalização da compra, o envio e as operações com endereços confiáveis" e assista ao Webinar "Melhorar a finalização da compra, o envio e as operações com a validação de endereços ".
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
-
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®, DPV®. ↩