目标
本文档介绍了如何在电子商务结账流程中组合使用地点自动补全、地址验证 API1 和 Google 地图,以捕获优质地址。
前提条件
Google 建议您熟悉以下内容:
- 地点自动补全 JavaScript 开发者文档。
- 从技术角度了解地点自动补全的运作方式及其实现选项。
- 地点自动补全的结账实现指南。
- 电子商务结账页上地点自动补全实现最佳实践示例。
- Address Validation API 产品文档,重点关注构建验证逻辑。
- 从技术层面了解 Address Validation API 的运作方式,并查看用于确定地址质量的信号。
什么是地址验证?
Address Validation API 是一项接受地址的服务。它会识别地址组成部分并对其进行验证。它还会对邮寄地址进行标准化处理,并为其查找已知的最佳纬度/经度坐标。(可选)对于美国和波多黎各的地址,您可以启用编码准确性支持系统 (CASS™)。为什么需要在结账时验证地址?
在订购过程中收集准确的地址:
这是促进成功配送、提高按时履单率并降低昂贵的地址更正费用的重要一步。
引导客户快速准确地输入地址:
地点自动补全功能可加快地址输入速度并减少输入错误,让客户能够轻松完成结账流程。地址验证功能会针对地址的整体质量提供反馈,进行标准化和拼写错误等更正,并增强元数据,例如提供住宅或商业指示器(部分地区提供)。
实现概览
本部分概述了适用于电子商务结账的建议地址输入工作流。该流程包括以下三个步骤:
- 使用地点自动补全功能初始捕获地址。
- 使用 Address Validation API 确认输入的地址。
- 在地图上显示输入地址的位置,让客户对配送有信心。
接下来,我们将分别深入探讨每个步骤。
第 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 允许在网页中或稍后在电子邮件中嵌入图片。 |
---|---|
深入探讨 - 地址接受情况
地址验证 API 响应可分为以下三个主要场景:
- 解决方法:地址质量不佳。 您应提示用户提供更多信息。
- 确认 - 地址质量较高,但与输入的地址有所不同。系统可能会提示您进行确认。
- 接受 - 地址质量较高。您可以接受所提供的地址。
Address Validation API 文档的构建验证逻辑部分介绍了此概念,我们将在本部分讨论每种场景。
修复
本部分介绍了如何修正地址输入。如需了解 Address Validation API 返回的特定信号以指示地址质量较低,请参阅“构建验证逻辑”文档中的修正地址部分。
如果 Address Validation API 的响应指示地址无效,请将客户重定向到地址输入表单,以检查他们输入的数据。修正地址后,您的服务应重新发送到 Address Validation API,以确保所做的更正有效。
您还可以使用 addressComponents
级别返回的信号突出显示特定的地址行错误。如右侧的屏幕截图所示,您可以看到一个这样的示例。
确认
本部分介绍了如何确认地址。如需了解 Address Validation API 返回的特定信号(用于指明应确认地址),请参阅“构建验证逻辑”文档中的确认地址部分。
通常,您的系统会提示用户确认地址。例如,客户拼错了城市名称,然后 Address Validation API 会对其进行更正。您应与客户确认此解决方法。这是因为 API 所做的更改可能会从根本上改变原始输入内容。
使用插页式模态窗口向客户显示信息,并提供三种继续操作选项:
- 确认 API 返回的地址,然后系统会使用更正后的地址继续结账流程。
- 选择原始输入的地址,忽略 Address Validation API 提供的更正信息。结账流程可以照常继续,并且在发货前可以将订单标记为需要下游审核(如果您的流程允许)。
- 客户取消或退出模态窗口,返回到结账流程的地址输入阶段,在该阶段,他们可以从头开始重新输入地址,从而重新开始流程。
如右侧的屏幕截图所示,就是一个这样的示例。
接受
本部分介绍了如何接受地址。如需了解 Address Validation API 返回的特定信号,以指示地址质量良好且应接受,请参阅“构建验证逻辑”文档中的接受地址部分。
在这种情况下,结账流程应进入下一个阶段(可能是收款),而不会向客户提示地址质量问题。API 已确认客户输入的地址质量良好,可送达。
我们建议您针对订单使用 Address Validation API 返回的地址数据,因为其中可能包含一些小更正和补充信息,例如:
- 大写字母
- 格式更正,例如
- 将街道更改为 St
- 地址组成部分的正确排序
- 美国的邮政编码+4 位数字。
实现方面的注意事项
构建地址接受逻辑时,请确保您的实现不会因客户输入无效地址而阻止其结账。构建逻辑的方式应能防止在 API 反复指明其条目无效时出现无限循环的可能性。
Google 建议您最多给客户两次机会输入地址,并在客户第二次尝试时接受其输入的内容,即使该内容无法验证也是如此。在第二次尝试时,目标是让用户无论验证结果如何都能继续操作。
接受第二次尝试的两种建议方法:
- 强制继续:向客户显示一个模态窗口,说明地址无法验证,但允许客户选择继续使用输入的地址。
- 静默接受:自动接受第二次尝试,而无需执行确认步骤,即使地址未完全验证也无妨。
如果可能,请将系统设计为标记无法验证的地址,以便客户服务代表在订单发货前进行检查。这项额外措施可确保您发现任何错误。
新建筑施工是一个很好的例子,可以说明为何建议进行此检查。新建筑物建成与邮政地址数据库中填充该建筑物的地址之间可能存在时间差。客户应有权选择使用输入的地址强制继续完成结账页,即使该地址无法验证也是如此。
结账会话完成后,您可以选择使用 provideValidationFeedback
方法向 Google 发送有关特定地址验证尝试的反馈。
总结
本文档简要介绍了在 Google 地图上实现自动补全、地址验证和直观确认的结账流程。请参考本文档,按照建议的地址输入流程设计您的实现。
后续步骤
下载利用可靠的地址改进结账、配送和运营 白皮书,并观看利用地址验证改进结账、配送和运营 在线讲座。
建议的补充阅读材料:
贡献者
Henrik Valve | 解决方案工程师
Thomas Anglaret | 解决方案工程师
Sarthak Ganguly | 解决方案工程师
-
美国邮政的非独家许可人。以下商标归 United States Postal Service® 所有,并已获得使用许可:CASS™、USPS®、DPV®。↩