Tính năng đăng ký và đăng nhập khách hàng thân thiết cho phép người dùng tìm kiếm chương trình khách hàng thân thiết và tham gia hoặc đăng nhập vào tài khoản của họ từ Google Wallet. Người dùng sẽ được chuyển đến trang web thân thiện với thiết bị di động của bạn để hoàn tất sau đó họ có thể thêm thẻ của họ vào Google Wallet.
Hướng dẫn này cung cấp thông tin tổng quan về các bước triển khai cần thiết để bật tính năng này cho chương trình khách hàng thân thiết.
Tổng quan
Để bắt đầu, hãy đảm bảo rằng bạn đã thiết lập dự án trước đó và có quyền truy cập vào API Google Wallet.
Bạn phải làm theo 4 bước sau để triển khai tính năng đăng ký và đăng nhập cho chương trình khách hàng thân thiết của bạn:
- Thiết lập lớp kiểm tra trong Google Wallet để kiểm tra quy trình đăng ký/đăng nhập của bạn.
- Phát triển các trang đăng ký/đăng nhập có sử dụng Google Wallet
SharedDataType. - Triển khai chế độ đẩy thẻ khách hàng thân thiết về Google Wallet sau khi đăng ký/đăng nhập.
- Yêu cầu xác minh và kích hoạt.
Thiết lập lớp học kiểm tra trong Google Wallet
Xác định các URL đăng ký và đăng nhập, biểu trưng chương trình của bạn và các trường người dùng đã chọn. Sau đó:
hãy sử dụng các trường discoverableProgram lồng nhau trong
loyaltyclass để đặt
các giá trị phù hợp.
Đặt các giá trị trong discoverableProgram để tạo phiên bản nháp của
chương trình khách hàng thân thiết hỗ trợ đăng ký/đăng nhập. Để đảm bảo người kiểm thử có thể thấy phần này, hãy xác minh
người kiểm thử có quyền truy cập vào Google Pay và Bảng điều khiển Wallet của bạn. Để biết chi tiết về cách chia sẻ
Quyền truy cập của Google Pay và Bảng điều khiển Wallet với người khác, hãy xem
Tìm hiểu về trang Người dùng.
Để hoàn tất quy trình xác minh chức năng triển khai của bạn trong quá trình phát triển hãy liên hệ với chúng tôi qua tiện ích liên hệ với bộ phận hỗ trợ trong Google Pay và Bảng điều khiển Wallet. Trong khi ở bảng điều khiển, chọn API Google Wallet trong chủ đề rồi chọn Đăng nhập/Đăng ký cho chương trình khách hàng thân thiết trong chủ đề phụ.
Phát triển trang đăng ký và đăng nhập có sử dụng dữ liệu người dùng Google Wallet
Khi người dùng chọn đăng nhập hoặc đăng ký chương trình khách hàng thân thiết, họ sẽ được chuyển đến một trang phù hợp trên trang web của bạn để hoàn tất quá trình đăng ký hoặc đăng nhập. Nếu người dùng chọn đăng ký, Google Wallet sẽ yêu cầu người dùng phê duyệt việc chia sẻ dữ liệu người dùng của họ với bạn.
Bạn phải cung cấp 1 trong 2 trang hoặc cả 2 trang cho phép người dùng hoàn tất các thao tác này.
- URL đăng nhập mà người dùng có thể đăng nhập vào tài khoản hiện có.
- URL đăng ký để người dùng có thể tạo tài khoản mới.
Trang đăng nhập và đăng ký của bạn phải đáp ứng các yêu cầu sau:
- Cung cấp trải nghiệm người dùng thân thiện với thiết bị di động.
- Giảm thiểu số lượng các trường bắt buộc trong quá trình đăng ký.
- Cho phép người dùng hoàn tất quy trình đăng nhập hoặc đăng ký trong một trang.
- Sử dụng phương thức mã hoá
HTTPSvới một chứng chỉ hợp lệ để đảm bảo dữ liệu người dùng được truyền một cách an toàn. - Đảm bảo các trang đăng nhập và đăng ký đạt thời gian hoạt động ít nhất 99,9%.
Ngoài các yêu cầu nêu trên, bạn nên cho phép người dùng để đăng ký tham gia chương trình khách hàng thân thiết mà không cần điền vào bất kỳ biểu mẫu nào hoặc giữ trang chỉ chấp nhận điều khoản dịch vụ của bạn.
- Bằng cách tận dụng dữ liệu người dùng được cung cấp trong
SharedDataType, bạn có thể tạo một tài khoản và ngay lập tức rút lại thẻ khách hàng thân thiết của họ. - Sau đó, bạn có thể gửi cho người dùng mật khẩu một lần hoặc một đường liên kết qua email để định cấu hình mật khẩu và thông tin tài khoản không bắt buộc.
- Điều này giúp giảm khả năng người dùng bỏ qua quy trình đăng ký, vì mỗi bước bổ sung có thể dẫn đến người dùng bỏ ngang nhiều hơn.
Khi hiển thị trang đăng nhập hoặc đăng ký, Google Wallet sẽ tạo
một Android WebView và một yêu cầu POST được gửi đến bạn đã cung cấp
URL. Dữ liệu người dùng được cung cấp trong thông số SharedDataType
có trong yêu cầu POST bằng cách sử dụng
thông tin về loại nội dung application/x-www-form-urlpersonalized và
UTF-8. Giá trị của SharedDataType
là một đối tượng JSON được mã hoá Base64.
Tuỳ thuộc vào hành động mà người dùng chọn và các trường mà bạn đã chỉ định yêu cầu từ người dùng, thì đối tượng JSON có thể chứa các trường sau.
| Trường | Đăng ký |
|---|---|
| ✓ | |
| firstName | ✓ |
| lastName | ✓ |
| địa chỉ [1-3] | ✓ |
| thành phố | ✓ |
| tiểu bang | ✓ |
| mã zip | ✓ |
| country | ✓ |
| điện thoại | ✓ |
Tham khảo phần bên dưới để biết đối tượng JSON mẫu đã được giải mã
có trong SharedDataType.
Tài nguyên
{
"firstName": "Jane",
"lastName": "Doe",
"addressLine1": "1600 Amphitheatre Pkwy",
"addressLine2": "Apt 123",
"addressLine3": "Attn:Jane",
"city": "Mountain View",
"state": "CA",
"zipcode": "94043",
"country": "US",
"email": "jane.doe@example.com",
"phone": "555-555-5555"
}
Triển khai hệ thống đẩy ngay thẻ khách hàng thân thiết về Google Wallet
Sau khi xác thực (đăng nhập) hoặc sau khi tạo tài khoản (đăng ký), trang của bạn sẽ đẩy ngay thẻ khách hàng thân thiết của người dùng về Google Wallet.
Bạn có thể đẩy lại thẻ khách hàng thân thiết về Google Wallet bằng cách chuyển hướng đến theo cấu trúc bên dưới.
https://pay.google.com/gp/v/save/{jwt_generated}
Độ dài an toàn cho một URL là 2.000 ký tự. Đường liên kết của bạn sẽ vẫn nằm dưới giới hạn này. Các đối tượng được mã hoá trong JWT phải nhỏ, chỉ chứa dữ liệu cụ thể cho người dùng. Cố gắng giữ lại hầu hết dữ liệu trong lớp của đối tượng, tạo trước khi tạo JWT. Đối với các đối tượng lớn hơn không vừa với giới hạn, hãy cân nhắc trước tiên hãy tạo đối tượng trong Google Wallet API và chỉ gửi mã đối tượng trong JWT.
Quy trình giao tiếp điển hình
Quy trình giao tiếp để người dùng hoàn tất việc đăng ký hoặc đăng nhập được minh hoạ trong hình ảnh tiếp theo. Tất cả thao tác giữa "Máy chủ của bạn" bạn có trách nhiệm triển khai.
Yêu cầu xác minh và kích hoạt
Sau khi bạn hoàn tất công việc phát triển và kiểm thử quy trình đăng ký/đăng nhập, hãy gửi yêu cầu thông qua Liên hệ với bộ phận hỗ trợ về Google Pay và Bảng điều khiển Wallet tiện ích.
Sau khi xem xét toàn bộ việc triển khai của bạn, trong đó xác nhận chức năng chính xác trong kết hợp với ứng dụng Google Wallet, tính năng đăng ký/đăng nhập khách hàng thân thiết sẽ được giới thiệu công khai cho chương trình khách hàng thân thiết của mình. Điều này sẽ cho phép mọi người dùng xem và sử dụng chức năng này.
Để đảm bảo trải nghiệm người dùng tối ưu, hãy kiểm tra định kỳ hoạt động đăng ký/đăng nhập của bạn sẽ được tiến hành để đảm bảo luôn tuân thủ các yêu cầu về tính năng. Bạn sẽ được thông báo trong trường hợp có sự khác biệt và chức năng đăng nhập/đăng ký có thể bị vô hiệu hoá cho đến khi vấn đề được giải quyết.
Câu hỏi thường gặp
- Có yêu cầu nào đối với hình ảnh dùng trong chương trình khách hàng thân thiết của tôi không?
- Có, hình ảnh của bạn phải được lưu trữ ở
HTTPSvị trí vì chúng sẽ không hiển thị trong Google Wallet.
- Có, hình ảnh của bạn phải được lưu trữ ở
- Có công cụ nào giúp đơn giản hoá việc triển khai và gỡ lỗi JWT không?
- Có, các nền tảng như www.jwt.io cho phép bạn giải mã gỡ lỗi mã thông báo trong quá trình phát triển, cho phép bạn xác minh nội dung bạn đang gửi. Xin lưu ý rằng Google không có liên kết và không đề xuất cụ thể bất kỳ bên thứ ba nào như vậy.
- Làm cách nào để chúng tôi xử lý chính xác dữ liệu SharedDataType được mã hoá theo Base64?
- Đảm bảo rằng bạn đang sử dụng bộ mã hoá UTF-8 trong suốt quy trình của mình. Chuỗi JSON được mã hoá UTF-8 đầu tiên, sau đó được mã hoá bằng android.util.Base64 với các tuỳ chọn NO_WRAP và URL_SAFE. Điều này tương ứng với Mục 4 của RFC 3548.