电子商务结帐地址验证

目标

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

前提条件

Google 建议您熟悉以下内容：

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

什么是地址验证？

Address Validation API 是一项接受地址的服务。它会识别地址组成部分并验证这些组成部分。该服务还会对地址进行标准化处理以方便邮寄，并找到地址的最优纬度/经度坐标。（可选）对于美国和波多黎各的地址，您可以启用编码准确性支持系统 (CASS™)。

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

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

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

实现概览

本部分概述了电子商务结账流程中建议的地址输入工作流。此流程包括三个步骤：

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

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

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

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

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

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

以下示例展示了此流程可能呈现的方式（使用单个输入字段）：

图片

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

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

Google 建议为每笔交易调用 Address Validation API。

以下流程图展示了在结账流程中端到端集成地址验证 API 的示例：

图片

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

第 3 步：提供视觉确认

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

该地图可以在结账过程中显示，也可以添加到交易确认电子邮件内。以下 API 可用于实现这两种使用情形。

Maps JavaScript API 提供了一个互动式地图，用于显示用户位置。 借助 Maps Static API，您可以在网页中或稍后在电子邮件中嵌入图片。

深入探讨 - 地址接受场景

Address Validation API 响应可分为三种主要情形：

  • 修正 - 地址质量低。 您应该提示用户提供更多信息。
  • 确认 - 地址质量高，但与输入地址相比有变化。系统可能会提示您进行确认。
  • 接受 - 地址质量高。您可以接受提供的地址。

Address Validation API 文档的构建验证逻辑部分介绍了这一概念，我们将在本部分中讨论每种情形。

修复

图片

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

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

您还可以使用 addressComponents 级别返回的信号来突出显示特定的地址行错误。右侧的屏幕截图显示了相关示例。

确认

图片

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

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

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

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

右侧的屏幕截图显示了相关示例。

接受

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

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

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

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

实现方面的注意事项

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

Google 建议您允许客户最多两次输入地址，并在第二次尝试时接受其输入，即使该地址未通过验证也是如此。在第二次尝试中，目标是无论验证结果如何，都允许用户继续操作。

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

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

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

新建建筑很好地说明了为什么建议进行此检查。新建筑物完工后，可能需要一段时间才能将该建筑物的地址填充到邮政地址数据库中。即使客户输入的地址未通过验证，也应允许客户强制继续完成结账流程。

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

总结

本文档简要介绍了在结账流程中实现自动补全、地址验证和 Google 地图上的直观确认功能。您可以先参考本文档来设计实现，然后按照建议的地址输入流程进行操作。

后续步骤

下载通过可靠的地址提升结账、配送和运营效率 白皮书，并观看通过地址验证提升结账、配送和运营效率 网络研讨会。

建议的延伸阅读内容：

贡献者

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

  1. 美国邮政总局的非独家许可方。以下商标归美国邮政服务公司® 所有，并经许可使用：CASS™、USPS®、DPV®。↩