结账时的地址验证

目标

本文档介绍了在电子商务结账流程中结合使用地点自动补全、Address Validation API1和地图的方法，以便 捕获高质量的地址。

前提条件

Google 建议您熟悉以下内容：

  • 地点自动补全 JavaScript 开发者 文档.
    • 从技术角度了解地点自动补全 的工作原理及其实现选项。
  • 地点自动补全的**结账实现**指南。
    • 在电子商务结账流程中实现地点自动补全的最佳实践示例。
  • Address Validation API 产品 文档， 重点是构建验证 逻辑。
    • 从技术角度了解 Address Validation API 的工作原理，并查看确定地址质量的信号。

什么是地址验证？

Address Validation API 是一项接受地址的服务。 它可以识别地址组成部分并对其进行验证。它还可以对地址进行标准化处理，以方便邮寄，并找到地址的最优纬度/经度坐标。 （可选）对于美国和波多黎各的地址，您可以启用 Coding Accuracy Support System (CASS™)。

为什么需要在结账时进行地址验证？

在订购流程中收集准确的地址：
这是促进成功送达、提高准时 履单率和减少高昂的地址更正费用的重要一步。

引导客户快速准确地输入地址：
地点自动补全功能可加快地址输入速度并减少输入错误，让 客户轻松完成结账。地址验证可提供有关整体地址质量的反馈，进行标准化和拼写错误等更正，并增强元数据，例如提供住宅或商业指示器（在 部分地区提供）。

实现概览

本部分概述了电子商务结账流程的推荐地址输入工作流。该流程包含三个步骤：

  1. 使用地点自动补全功能初步捕获地址。
  2. 使用 Address Validation API 确认输入的地址。
  3. 在地图上显示输入的地址的位置，让客户对送货充满信心。

接下来，我们将分别深入探讨每个步骤。

第 1 步：地址输入流程 - 使用地点自动补全服务

在地址输入表单的第一行使用 JavaScript API 实现 地点 自动补全 功能。

地点自动补全功能会在客户输入地址详细信息时向其提供建议。使用 JavaScript API 实现后，当用户开始输入时，地址输入表单字段下方会显示一个下拉列表，其中显示来自自动补全服务的结果，这些结果会随着每次按键操作而更新。用户输入足够的信息以找到地址后，便可从下拉列表中选择该地址。此操作会自动使用地址数据填充表单字段。

您可以使用地点自动补全功能为用户提供两种表单输入样式：一种是显示所有地址字段，另一种是显示单个输入字段。此单个输入字段会提示用户在输入时开始搜索，而不是单独输入地址组成部分。自动补全功能填充地址后，工作流会使用地址数据展开表单字段，让客户查看和进行修改，例如添加公寓或单元号。

以下示例展示了如何使用单个输入字段显示此流程：

图片

第 2 步：使用 Address Validation API 验证地址

用户输入地址后，Google 建议您在结账时调用 Address Validation API ，以确认地址有效且完整。当用户点击地址表单上的“下一步”或“继续”按钮时，触发对 Address Validation API 的调用。此按钮通常会转到付款页面。

Google 建议您针对每笔交易调用 Address Validation API。

以下流程图展示了在结账流程中端到端集成 Address Validation API 的示例：

图片

本文档稍后将讨论地址接受场景。

第 3 步：提供直观确认

用户输入地址后，通过在地图上显示送货地址，为用户提供直观的送货地址确认信息。这能再次保证客户地址信息填写正确，还可减少无法送达或自提的情况。

地图可以在结账流程中显示，也可以添加到交易确认电子邮件内。这些用例均可通过以下 API 实现。

Maps JavaScript API 提供了一个交互式地图，用于显示用户位置。 Maps Static API 允许在网页中或在电子邮件的后续阶段嵌入图片。

深入了解 - 地址接受场景

Address Validation API 响应可以分为三种主要场景：

  • 修复（手形图标） - 地址质量较低。 您应提示用户提供更多信息。
  • 确认—地址质量较高，但与输入地址相比有所更改。您可能会提示用户进行 确认。
  • 接受—地址质量较高。您可以 接受提供的地址。

Address Validation API 文档的 构建验证 逻辑 部分介绍了此概念，我们将在 本部分讨论每种场景。

修复

图片

本部分介绍了如何修复地址输入。如需了解 Address Validation API 返回的用于指示地址质量较低的特定 信号，请参阅构建验证逻辑文档中的修复地址 。

如果 Address Validation API 的响应表明地址无效，请将客户重定向到地址输入表单，以检查其输入的数据。 修复地址后，您的服务应重新发送到 Address Validation API，以确保所做的更正有效。

您还可以使用在 addressComponents 级别返回的信号来突出显示特定的地址行错误。您可以在右侧的屏幕截图中看到一个示例。

确认

图片

本部分介绍了如何确认地址。如需了解 Address Validation API 返回的用于指示应确认地址的特定 信号，请参阅构建验证逻辑文档中的确认地址 。

您的系统通常会提示用户确认地址。例如，客户拼错了城市名称，然后 Address Validation API 会更正该名称。您应向客户确认此修复。这是因为 API 所做的更改可能会从根本上改变最初输入的内容。

使用插页式模态框向客户显示信息，并提供三个选项以继续：

  1. 确认 API 返回的地址，结账流程继续，使用更正后的地址。
  2. 选择最初输入的地址，忽略 Address Validation API 的更正。结账流程可以正常继续，如果您的流程允许，则可以在发货前标记订单以供下游审核。
  3. 客户取消或退出模态框，返回到结账流程的地址输入阶段，他们可以在其中从头开始重新输入地址，重新开始该流程。

您可以在右侧的屏幕截图中看到一个示例。

接受

本部分介绍了如何接受地址。如需了解 Address Validation API 返回的用于指示地址质量良好且应接受的特定 信号，请参阅接受 地址 在构建验证逻辑文档中。

在这种情况下，结账流程应进入下一阶段（可能是付款捕获），而不会向客户提示有关地址质量的信息。 API 已确认客户输入的地址质量良好且可送达。

我们建议您根据订单使用 Address Validation API 返回的地址数据，因为其中可能包含细微的更正和添加内容，例如：

  • 大写字母
  • 格式更正，例如
    • 将“Street”更正为“St”
    • 正确排序地址组成部分
  • 美国的 ZIP+4。

实现方面的注意事项

构建地址接受逻辑时，请确保您的实现不会因客户输入无效地址而阻止客户结账。构建逻辑的方式应能防止 API 反复指示其输入无效时出现无限循环的可能性。

Google 建议您为客户提供最多两次输入地址的机会，并在第二次尝试时接受其输入，即使该输入未通过验证也是如此。在第二次尝试时，目标是让他们继续操作，无论是否通过验证。

以下是接受第二次尝试的两种建议方法：

  • 强制继续： 向客户显示一个模态框，说明地址未通过验证，但允许客户选择继续使用其输入的地址。
  • 静默接受： 自动接受第二次尝试，无需确认步骤，即使地址未完全通过验证也是如此。

如果可能，请将系统设计为标记未通过验证的地址，以便客户服务代表可以在订单发货前对其进行审核。这项额外措施可确保您发现任何错误。

新建建筑的施工很好地说明了为什么建议进行此检查。新建建筑完工与该建筑的地址填充到邮政地址数据库之间可能存在时间差。客户应可以选择使用其输入的地址强制继续结账页面，即使该地址未通过验证也是如此。

结账会话完成后，您可以选择使用 provideValidationFeedback 方法向 Google 发送有关特定地址验证尝试的反馈。

总结

本文档概述了在 Google 地图上实现自动补全、地址验证和直观确认的结账流程。您可以将本文档作为设计实现的起点，遵循推荐的地址输入流程。

后续步骤

建议您进一步阅读以下内容：

贡献者

Henrik Valve | 解决方案工程师
Thomas Anglaret | 解决方案工程师
Sarthak Ganguly | 解决方案工程师

  1. 美国邮政总局的非独占被许可人。以下商标归 United States Postal Service® 所有，并经许可使用：CASS™、USPS®、DPV®。 ↩