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 của bạn 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 quy trình, sau đó họ có thể thêm thẻ của mình 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 chương trình khách hàng thân thiết cho tính năng này.
Tổng quan
Để bắt đầu, hãy đảm bảo trước đó bạn đã thiết lập dự án và có quyền truy cập vào Google Wallet API.
Bạn phải thực hiện 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 mình:
- Thiết lập một lớp kiểm thử trong Google Wallet để kiểm tra quy trình đăng ký/đăng nhập.
- Phát triển trang đăng ký/đăng nhập sử dụng Google Wallet
SharedDataType. - Triển khai đẩy lùi 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 kiểm tra trong Google Wallet
Xác định URL đăng ký và URL đă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 đó, sử dụng các trường discoverableProgram lồng nhau trong loyaltyclass để đặt các giá trị thích 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 có hỗ trợ đăng ký/đăng nhập. Để đảm bảo người kiểm thử nhìn thấy thông tin này, hãy xác minh rằng 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 thông tin chi tiết về cách chia sẻ cho người khác quyền truy cập
Google Pay và Bảng điều khiển Wallet của bạn, 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 bằng tiện ích hỗ trợ liên hệ trong Bảng điều khiển Google Pay và Wallet. Trong bảng điều khiển, chọn API Google Wallet trong chủ đề rồi chọn Đăng nhập/đăng ký với 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 sử dụng dữ liệu người dùng trên Google Wallet
Khi người dùng chọn đăng nhập hoặc đăng ký tham gia chương trình khách hàng thân thiết của bạn, họ sẽ được chuyển đến một trang được thiết kế riêng trên trang web của bạn để hoàn tất quy 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 chấp thuận việc chia sẻ dữ liệu người dùng của họ với bạn.
Bạn bắt buộc phải cung cấp một trong hai hoặc cả hai trang để cho phép người dùng hoàn tất các hành động này.
- URL đăng nhập để người dùng có thể đăng nhập vào một tài khoản hiện có.
- URL đăng ký mà 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 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 duy nhất.
- Sử dụng phương thức mã hoá
HTTPScó 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 ít nhất 99,9% thời gian hoạt động của trang đăng nhập và đăng ký.
Ngoài các yêu cầu ở trên, bạn nên cho phép người dùng đăng ký chương trình khách hàng thân thiết của mình mà không cần điền vào bất kỳ biểu mẫu nào hoặc chỉ để lại trang chấp nhận điều khoản dịch vụ.
- 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 huỷ bỏ thẻ khách hàng thân thiết của họ. - Sau đó, bạn có thể gửi cho người dùng đó email chứa mật khẩu một lần hoặc một đường liên kết để định cấu hình mật khẩu và thông tin tài khoản (không bắt buộc) của họ.
- Điều này làm 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 việc người dùng bỏ ngang thêm.
Khi đưa ra trang đăng nhập hoặc đăng ký, Google Wallet sẽ tạo một WebView trên Android và một yêu cầu POST sẽ được gửi đến URL mà bạn cung cấp. Dữ liệu người dùng được cung cấp trong tham số SharedDataType. Tham số này có trong yêu cầu POST bằng cách sử dụng loại nội dung
application/x-www-form-urlcoded và phương thức mã hoá UTF-8. Giá trị của tham số SharedDataType là một đối tượng JSON được mã hoá Base64.
Tuỳ thuộc vào thao tác mà người dùng chọn và các trường bạn chỉ định để yêu cầu người dùng, đối tượng JSON có thể chứa các trường sau.
| Trường | Đăng ký | Đăng nhập |
|---|---|---|
| ✓ | ✓ | |
| firstName | ✓ | |
| lastName | ✓ | |
| Dòng địa chỉ [1-3] | ✓ | |
| city | ✓ | |
| state | ✓ | |
| mã zip | ✓ | |
| country | ✓ | |
| điện thoại | ✓ |
Hãy tham khảo nội dung bên dưới để biết đối tượng JSON mẫu đã 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 việc chuyển ngay thẻ khách hàng thân thiết về lại 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ẽ ngay lập tức đẩy thẻ khách hàng thân thiết của người dùng về Google Wallet.
Bạn có thể đẩy thẻ khách hàng thân thiết về Google Wallet bằng cách chuyển hướng đến một đường liên kết tuâ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 URL là 2000 ký tự. Các đường liên kết của bạn không nên nằm dưới giới hạn này. Các đối tượng được mã hoá trong JWT phải có kích thước nhỏ, chỉ chứa dữ liệu dành riêng cho người dùng. Hãy cố gắng giữ lại hầu hết dữ liệu trong lớp của đối tượng, tạo đối tượng đó trước khi tạo JWT. Đối với các đối tượng lớn hơn không phù hợp với giới hạn, trước tiên hãy cân nhắc tạo đối tượng trong Google Wallet API và chỉ gửi mã nhận dạng đối tượng trong JWT.
Quy trình liên lạc thông thường
Quy trình liên lạc cho một người dùng hoàn tất quá trình đăng ký hoặc đăng nhập được minh hoạ trong hình ảnh sau đây. Bạn có trách nhiệm triển khai mọi hành động giữa "Máy chủ của bạn".
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 qua tiện ích liên hệ với bộ phận hỗ trợ của Google Pay và Wallet Console.
Sau khi đánh giá đầy đủ quy trình triển khai của bạn và xác nhận chức năng chính xác khi 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 ra mắt công khai cho chương trình khách hàng thân thiết của bạn. Điều này sẽ cho phép mọi người dùng thấy chương trình và sử dụng chức năng này.
Để đảm bảo người dùng có trải nghiệm tối ưu, chúng tôi sẽ kiểm tra định kỳ việc triển khai đăng ký/đăng nhập của bạn để đảm bảo việc luôn tuân thủ các yêu cầu về tính năng này. Bạn sẽ nhận đượ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ị tắt 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 không?
- Có, hình ảnh của bạn nên được lưu trữ tại vị trí
HTTPSvì nếu không thì hình ảnh sẽ không hiển thị trong Google Wallet.
- Có, hình ảnh của bạn nên được lưu trữ tại vị 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ã và gỡ lỗi mã thông báo trong quá trình phát triển, nhờ đó giúp bạn xác minh nội dung mình đang gửi. Xin lưu ý rằng Google không có mối liên kết nào 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 để xử lý chính xác dữ liệu SharedDataType được mã hoá Base64?
- Đảm bảo rằng bạn sử dụng bộ mã hoá UTF-8 trong suốt quá trì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. Giá trị này tương ứng với mục 4 của RFC 3548.