Mục tiêu
Tài liệu này mô tả các phương thức kết hợp Place Autocomplete, Address Validation API1 và Maps trong quy trình thanh toán của trang thương mại điện tử nhằm mục đích thu thập địa chỉ chất lượng cao.
Điều kiện tiên quyết
Bạn nên nắm rõ những điều sau:
- Tài liệu dành cho nhà phát triển về JavaScript Place Autocomplete.
- Tìm hiểu về cách hoạt động của tính năng Tự động hoàn thành địa điểm và các lựa chọn triển khai tính năng này theo quan điểm kỹ thuật.
- Hướng dẫn triển khai tính năng thanh toán cho tính năng Tự động hoàn thành địa điểm.
- Ví dụ về các phương pháp hay nhất để triển khai tính năng Tự động hoàn thành địa điểm trên trang thanh toán của một trang web thương mại điện tử.
- Tài liệu về sản phẩm Address Validation API, tập trung vào Xây dựng logic xác thực.
- Tìm hiểu từ góc độ kỹ thuật về cách hoạt động của Address Validation API và xem xét các tín hiệu xác định chất lượng địa chỉ.
Xác thực địa chỉ là gì?
Address Validation API là một dịch vụ chấp nhận địa chỉ. Dịch vụ này xác định các thành phần của địa chỉ và xác thực chúng. Thao tác này cũng chuẩn hoá địa chỉ để gửi thư và tìm toạ độ vĩ độ/kinh độ chính xác nhất cho địa chỉ đó. Bạn có thể bật Hệ thống hỗ trợ độ chính xác của mã (CASS™) cho địa chỉ ở Hoa Kỳ và Puerto Rico (không bắt buộc).Tại sao bạn cần xác thực địa chỉ khi thanh toán?
Thu thập địa chỉ chính xác trong quá trình đặt hàng:
Đây là một bước quan trọng để thúc đẩy việc giao hàng thành công, tăng tỷ lệ hoàn tất đúng hạn và giảm phí chỉnh sửa địa chỉ tốn kém.
Hướng dẫn khách hàng nhập địa chỉ một cách nhanh chóng và chính xác:
Tính năng Tự động hoàn thành địa điểm giúp tăng tốc độ nhập địa chỉ và giảm lỗi nhập, cho phép khách hàng dễ dàng chuyển sang bước thanh toán. Xác thực địa chỉ cung cấp thông tin phản hồi về chất lượng tổng thể của địa chỉ, thực hiện các bước chỉnh sửa như chuẩn hoá và lỗi chính tả, đồng thời nâng cao siêu dữ liệu, chẳng hạn như cung cấp chỉ báo về địa chỉ nhà ở hoặc địa chỉ thương mại (có ở một số khu vực.
Tổng quan về quy trình triển khai
Phần này trình bày quy trình nhập địa chỉ được đề xuất cho quy trình thanh toán của trang web thương mại điện tử. Quy trình này bao gồm 3 bước:
- Sử dụng tính năng Tự động hoàn thành địa điểm để ban đầu ghi nhận địa chỉ.
- Sử dụng Address Validation API để xác nhận địa chỉ đã nhập.
- Hiển thị vị trí của địa chỉ đã nhập trên bản đồ để khách hàng tin tưởng vào việc giao hàng.
Tiếp theo, chúng ta sẽ tìm hiểu từng bước riêng lẻ.
Bước 1: Quy trình nhập địa chỉ – sử dụng dịch vụ Tự động hoàn thành địa điểm
Triển khai tính năng Tự động hoàn thành địa điểm bằng API JavaScript trên dòng đầu tiên của biểu mẫu nhập địa chỉ.
Tính năng Tự động hoàn thành địa điểm cung cấp đề xuất cho khách hàng khi họ nhập thông tin chi tiết về địa chỉ. Khi được triển khai bằng JavaScript API, khi người dùng bắt đầu nhập, một trình đơn thả xuống sẽ xuất hiện bên dưới trường biểu mẫu nhập địa chỉ, cho thấy kết quả từ dịch vụ Tự động hoàn thành được cập nhật theo mỗi lần nhấn phím. Sau khi người dùng nhập đủ thông tin để tìm địa chỉ, họ sẽ chọn địa chỉ đó trong trình đơn thả xuống. Thao tác này sẽ tự động điền sẵn dữ liệu địa chỉ vào các trường trong biểu mẫu.
Bạn có thể cung cấp cho người dùng 2 kiểu nhập biểu mẫu bằng tính năng Tự động hoàn thành địa điểm: một kiểu hiển thị tất cả các trường địa chỉ hoặc một kiểu hiển thị một trường nhập duy nhất. Trường nhập liệu duy nhất này nhắc người dùng bắt đầu tìm kiếm khi họ nhập, thay vì nhập từng thành phần địa chỉ. Sau khi tính năng tự động hoàn thành điền sẵn địa chỉ, quy trình công việc sẽ mở rộng các trường biểu mẫu bằng dữ liệu địa chỉ, cho phép khách hàng xem xét và chỉnh sửa, ví dụ: thêm số căn hộ hoặc số đơn vị.
Sau đây là ví dụ về cách quy trình này có thể xuất hiện, sử dụng một trường nhập duy nhất:
Bước 2: Sử dụng Address Validation API để xác thực địa chỉ
Sau khi người dùng nhập địa chỉ, Google khuyên bạn nên gọi Address Validation API (API xác thực địa chỉ) khi thanh toán để xác nhận rằng địa chỉ đó hợp lệ và đầy đủ. Kích hoạt lệnh gọi đến Address Validation API khi người dùng nhấp vào nút Tiếp theo hoặc Tiếp tục trên biểu mẫu địa chỉ. Nút này thường dẫn đến trang thanh toán.
Bạn nên gọi Address Validation API cho mọi giao dịch.
Sơ đồ quy trình sau đây minh hoạ một ví dụ về quy trình tích hợp toàn diện của Address Validation API trong quy trình thanh toán:
Tài liệu này sẽ thảo luận về các trường hợp chấp nhận địa chỉ sau.
Bước 3: Cung cấp thông tin xác nhận bằng hình ảnh
Sau khi người dùng nhập địa chỉ, hãy cung cấp thông tin xác nhận trực quan về vị trí giao hàng bằng cách hiển thị vị trí đó trên bản đồ. Điều này giúp khách hàng yên tâm hơn rằng địa chỉ là chính xác, đồng thời giảm tình trạng giao hàng hoặc nhận hàng không thành công.
Bạn có thể cho thấy bản đồ trong quá trình thanh toán hoặc gửi trong email xác nhận giao dịch. Bạn có thể thực hiện cả hai trường hợp sử dụng này bằng các API sau.
| Maps JavaScript API cung cấp một bản đồ tương tác để hiển thị vị trí của người dùng. | Maps Static API cho phép nhúng hình ảnh vào trang web hoặc ở giai đoạn sau trong email. |
|---|---|
 |
 |
Tìm hiểu sâu – các trường hợp chấp nhận địa chỉ
Bạn có thể phân loại các phản hồi của Address Validation API thành 3 trường hợp chính:
- Khắc phục – địa chỉ có chất lượng thấp. Bạn nên yêu cầu thêm thông tin.
- Xác nhận – địa chỉ có chất lượng cao nhưng có thay đổi so với địa chỉ đầu vào. Bạn có thể được nhắc xác nhận.
- Chấp nhận – địa chỉ có chất lượng cao. Bạn có thể chấp nhận địa chỉ được cung cấp.
Khái niệm này được đề cập trong phần Xây dựng logic xác thực trong tài liệu về Address Validation API và chúng ta sẽ thảo luận về từng trường hợp trong phần này.
Cách khắc phục
Phần này cho biết cách sửa lỗi khi nhập địa chỉ. Để biết thông tin về các tín hiệu cụ thể mà Address Validation API trả về để cho biết địa chỉ có chất lượng thấp, hãy xem phần Khắc phục địa chỉ trong tài liệu Xây dựng logic xác thực.
Nếu phản hồi từ Address Validation API cho biết địa chỉ không hợp lệ, hãy chuyển hướng khách hàng đến biểu mẫu nhập địa chỉ để kiểm tra dữ liệu mà họ đã nhập. Sau khi bạn sửa địa chỉ, dịch vụ của bạn phải gửi lại đến Address Validation API để đảm bảo các nội dung chỉnh sửa là hợp lệ.
Bạn cũng có thể làm nổi bật các lỗi cụ thể trong dòng địa chỉ bằng cách sử dụng các tín hiệu được trả về ở cấp addressComponents. Bạn có thể xem ví dụ về vấn đề này trong ảnh chụp màn hình ở bên phải.
Xác nhận
Phần này cho biết cách xác nhận địa chỉ. Để biết thông tin về các tín hiệu cụ thể mà Address Validation API trả về để cho biết bạn nên xác nhận một địa chỉ, hãy xem phần Xác nhận địa chỉ trong tài liệu Xây dựng logic xác thực.
Thường thì hệ thống của bạn sẽ muốn nhắc người dùng xác nhận địa chỉ. Ví dụ: khách hàng viết sai tên thành phố, sau đó tên thành phố sẽ được Address Validation API sửa. Bạn nên xác nhận với khách hàng về bản sửa lỗi này. Điều này là do những thay đổi mà API thực hiện có thể làm thay đổi cơ bản nội dung đã được nhập ban đầu.
Sử dụng một phương thức xen kẽ để hiển thị thông tin cho khách hàng, cho phép 3 lựa chọn để tiếp tục:
- Xác nhận địa chỉ do API trả về và quy trình thanh toán sẽ tiếp tục bằng địa chỉ đã được sửa.
- Chọn địa chỉ như đã nhập ban đầu, bỏ qua thông tin chỉnh sửa của Address Validation API. Quy trình thanh toán có thể tiếp tục như bình thường và đơn đặt hàng có thể được gắn cờ để xem xét ở các bước tiếp theo trước khi vận chuyển, nếu quy trình của bạn cho phép.
- Khách hàng huỷ hoặc thoát khỏi cửa sổ phương thức, đưa họ trở lại giai đoạn nhập địa chỉ của quy trình thanh toán, nơi họ có thể nhập lại địa chỉ từ đầu, bắt đầu lại quy trình.
Bạn có thể xem ví dụ về việc này trong ảnh chụp màn hình ở bên phải.
Chấp nhận
Phần này cho biết cách chấp nhận một địa chỉ. Để biết thông tin về các tín hiệu cụ thể mà Address Validation API trả về để cho biết địa chỉ có chất lượng tốt và nên được chấp nhận, hãy xem phần Chấp nhận địa chỉ trong tài liệu Xây dựng logic xác thực.
Trong trường hợp này, quy trình thanh toán sẽ chuyển sang giai đoạn tiếp theo, có thể là thu thập thông tin thanh toán, mà không có lời nhắc nào cho khách hàng về chất lượng địa chỉ. API đã xác nhận rằng địa chỉ do khách hàng nhập có chất lượng tốt và có thể giao hàng.
Bạn nên sử dụng dữ liệu địa chỉ được trả về từ Address Validation API (API Xác thực địa chỉ) so với đơn đặt hàng, vì dữ liệu này có thể chứa các nội dung điều chỉnh và bổ sung nhỏ, chẳng hạn như:
- Cách viết hoa
- Chỉnh sửa định dạng, ví dụ:
- Đường đến Đường
- Sắp xếp chính xác các thành phần địa chỉ
- Mã ZIP+4 ở Hoa Kỳ.
Cân nhắc khi triển khai
Khi xây dựng logic chấp nhận địa chỉ, hãy đảm bảo rằng việc triển khai của bạn không chặn khách hàng thanh toán do nhập địa chỉ không hợp lệ. Xây dựng logic theo cách ngăn chặn khả năng xảy ra vòng lặp vô hạn nếu API liên tục cho biết mục nhập của chúng không hợp lệ.
Bạn nên cho khách hàng tối đa 2 cơ hội để nhập địa chỉ và chấp nhận thông tin họ nhập vào lần thứ hai, ngay cả khi thông tin đó không hợp lệ. Trong lần thử thứ hai, mục tiêu là cho phép họ tiếp tục bất kể quá trình xác thực.
Hai phương thức được đề xuất để chấp nhận lần thử thứ hai:
- Buộc tiếp tục: Cho khách hàng thấy một phương thức giải thích rằng địa chỉ không xác thực, nhưng cho phép họ tiếp tục với địa chỉ đã nhập.
- Chấp nhận thầm lặng: Tự động chấp nhận lần thử thứ hai mà không cần bước xác nhận, ngay cả khi địa chỉ không được xác thực đầy đủ.
Nếu có thể, hãy thiết kế hệ thống để gắn cờ những địa chỉ không hợp lệ, để nhân viên dịch vụ khách hàng có thể xem xét những địa chỉ đó trước khi đơn đặt hàng được vận chuyển. Biện pháp bổ sung này giúp bạn phát hiện mọi lỗi.
Việc xây dựng công trình mới là một ví dụ minh hoạ rõ ràng cho lý do bạn nên thực hiện quy trình kiểm tra này. Có thể có một khoảng thời gian từ khi công trình xây dựng mới hoàn thành cho đến khi địa chỉ của công trình đó được điền sẵn vào cơ sở dữ liệu địa chỉ bưu chính. Khách hàng phải có lựa chọn buộc tiếp tục qua trang thanh toán bằng địa chỉ đã nhập, ngay cả khi địa chỉ đó không hợp lệ.
Sau khi hoàn tất một phiên thanh toán, bạn có thể dùng phương thức provideValidationFeedback để gửi cho Google ý kiến phản hồi về một lần xác thực địa chỉ cụ thể.
Kết luận
Tài liệu này đã cung cấp thông tin tổng quan về một quy trình thanh toán triển khai tính năng Tự động hoàn thành, Xác thực địa chỉ và xác nhận trực quan trên Google Maps. Hãy sử dụng tài liệu này làm điểm bắt đầu để thiết kế quy trình triển khai, theo các quy trình nhập địa chỉ được đề xuất.
Các bước tiếp theo
Tải Cải thiện quy trình thanh toán, giao hàng và hoạt động bằng địa chỉ đáng tin cậy xuống Sách trắng và xem Cải thiện quy trình thanh toán, giao hàng và hoạt động bằng tính năng Xác thực địa chỉ trong Hội thảo trực tuyến.
Tài liệu đọc thêm được đề xuất:
- Tài liệu về tính năng Tự động hoàn thành địa điểm
- Tài liệu về Address Validation API
- Báo cáo của Nền tảng Google Maps
Người đóng góp
Henrik Valve | Kỹ sư giải pháp
Thomas Anglaret | Kỹ sư giải pháp
Sarthak Ganguly | Kỹ sư giải pháp
-
Bên được cấp phép không độc quyền của Dịch vụ Bưu chính Hoa Kỳ. (Các) nhãn hiệu sau đây thuộc sở hữu của Dịch vụ Bưu chính Hoa Kỳ® và được sử dụng khi đã được cho phép: CASS™, USPS®, DPV®. ↩