Tính năng đăng ký và đăng nhập vào chương trình 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, đồng thời tham gia hoặc đăng nhập vào tài khoản của họ ngay trong Google Wallet. Người dùng sẽ được chuyển hướng đế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ẻ chính thức của mình vào Google Wallet.
Việc triển khai tính năng này là điều kiện tiên quyết để chuyển đổi thẻ và vé "tĩnh" do người dùng thêm thành thẻ và vé được liên kết với API "động". Hướng dẫn này cung cấp thông tin tổng quan về các lợi ích 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 việc đăng ký, đăng nhập và nâng cấp thẻ/vé.
Tổng quan
Để bắt đầu, hãy đảm bảo rằng bạn đã thiết lập dự án và có quyền truy cập vào Google Wallet API.
Bạn phải làm theo 4 bước sau để triển khai tính năng này:
- Thiết lập một lớp kiểm thử: Định cấu hình Google Wallet để kiểm thử các quy trình của bạn.
- Phát triển các trang: Tạo các trang đăng ký/đăng nhập bằng Google Wallet
SharedDataType. - Triển khai tính năng đẩy lại: Gửi thẻ khách hàng thân thiết đến Google Wallet sau khi thực hiện hành động.
- Yêu cầu xác minh: Gửi yêu cầu xem xét và kích hoạt cấp độ nâng cấp.
Tại sao nên triển khai tính năng đăng ký tham gia chương trình khách hàng thân thiết?
Để hiểu được giá trị của việc tích hợp này, bạn cần phân biệt giữa hai loại thẻ và vé có trong Google Wallet: L1 (Do người dùng thêm) và L2 (Do đối tác phát hành).
Sự khác biệt giữa L1 và L2
| Tính năng | Thẻ L1 (do người dùng thêm) | Thẻ L2 (Do đối tác phát hành) |
|---|---|---|
| Origin | Được tạo khi người dùng quét thẻ vật lý theo cách thủ công hoặc nhập số. | Được tạo và đẩy bằng Wallet API sau khi người dùng đăng ký hoặc đăng nhập bằng quy trình của bạn. |
| Điều khiển | Tĩnh. Đối tác không có quyền xem hoặc kiểm soát thẻ và vé này. | Động. Đối tác có toàn quyền kiểm soát bằng API. |
| Chức năng | Hình ảnh tĩnh của một mã vạch. Không thể cập nhật. | Có thể cập nhật số dư điểm, trạng thái cấp bậc, hiển thị ưu đãi dành riêng cho bạn và nhận thông báo. |
Các đường dẫn nâng cấp: "Cầu nối" đến chương trình của bạn
Bằng cách tạo quy trình Đăng ký chương trình khách hàng thân thiết ("đích đến"), bạn cho phép Google tạo một "cầu nối" để nâng cấp người dùng từ thẻ L1 tĩnh lên thẻ L2 chính thức của bạn. Có 2 điều kiện chính để nâng cấp:
- Nâng cấp thẻ và vé từ cấp 1 lên cấp 2: Nếu trước đây người dùng đã tự thêm thẻ của bạn (L1), thì Google Wallet có thể nhắc họ truy cập vào quy trình đăng nhập mới của bạn để nâng cấp lên thẻ và vé chính thức, linh hoạt (L2).
- Nâng cấp thẻ/vé được nhập từ Gmail: Nếu Google Wallet phát hiện thấy thẻ khách hàng thân thiết bằng Gmail của người dùng, thì Google Wallet có thể nhắc người dùng truy cập vào quy trình của bạn và xác thực để nhận thẻ/vé L2 chính thức.
Bước 1: Thiết lập một lớp kiểm thử trong Google Wallet
Xác định URL đăng ký và đăng nhập, biểu trưng chương trình và các trường người dùng đã chọn. Sau đó, hãy dùng các trường lồng nhau discoverableProgram 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ó bật tính năng đăng ký/đăng nhập. Để đảm bảo người kiểm thử nhìn thấy thông báo 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à Wallet Console. Để biết thông tin chi tiết về cách chia sẻ quyền truy cập vào Google Pay và Wallet Console với người khác, hãy xem bài viết Tìm hiểu về trang Người dùng.
Để hoàn tất quy trình xác minh chức năng của quá trình triển khai trong quá trình phát triển, hãy liên hệ với chúng tôi bằng cách sử dụng tiện ích liên hệ với nhóm hỗ trợ trong Google Pay và Wallet Console. Trong bảng điều khiển, hãy chọn Google Wallet API trong chủ đề và chọn Đăng nhập/đăng ký chương trình khách hàng thân thiết trong chủ đề phụ.
Bước 2: Phát triển các trang đăng ký và đăng nhập
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 hướng đến một trang phù hợp 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 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 một trong hai trang hoặc cả hai trang để cho phép người dùng hoàn tất các hành động sau:
- URL đăng nhập nơi người dùng có thể đăng nhập vào một tài khoản hiện có.
- URL đăng ký nơi 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:
- Mang đến trải nghiệm phù hợp cho người dùng trên 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ý trên một trang duy nhất.
- Sử dụng phương thức mã hoá
HTTPSbằng 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 thời gian hoạt động của trang đăng nhập và đăng ký là ít nhất 99,9%.
Ngoài những yêu cầu này, 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 chỉ giữ 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 gửi 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 dùng một lần hoặc đường liên kết để họ đị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ỏ ngang 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.
Khi trình bày trang đăng nhập hoặc đăng ký, Google Wallet sẽ tạo một Android WebView và yêu cầu POST đượ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 có trong yêu cầu POST với Content-Type là application/x-www-form-urlencoded và 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 hành động mà người dùng chọn và các trường mà bạn đã chỉ định để yêu cầu người dùng cung cấp, đối tượng JSON có thể chứa các trường sau.
| Trường | Đăng ký |
|---|---|
| ✓ | |
| firstName | ✓ |
| lastName | ✓ |
| addressLine [1-3] | ✓ |
| thành phố | ✓ |
| tiểu bang | ✓ |
| mã zip | ✓ |
| country | ✓ |
| điện thoại | ✓ |
Hãy tham khảo thông tin sau để 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"
}
Bước 3: Triển khai tính năng đẩy lại ngay lập tức vào 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 phải ngay lập tức gửi thẻ khách hàng thân thiết của người dùng trở lại Google Wallet.
Bạn có thể chuyển thẻ khách hàng thân thiết trở lại Google Wallet bằng cách chuyển hướng đến một đường liên kết có cấu trúc như sau.
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 không được vượt quá 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ữ hầu hết dữ liệu trong lớp của đối tượng, tạo dữ liệu đó trước khi tạo JWT. Đối với những đối tượng lớn hơn không có giới hạn, hãy cân nhắc việc tạo đối tượng trong Google Wallet API trước tiên và chỉ gửi mã nhận dạng đối tượng trong JWT.
Quy trình giao tiếp điển hình
Luồng giao tiếp 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. Bạn phải chịu trách nhiệm thực hiện mọi hành động giữa "Máy chủ của bạn".
Bước 4: Yêu cầu xác minh và kích hoạt
Sau khi hoàn tất công việc phát triển và kiểm thử các quy trình đăng ký/đăng nhập, bạn phải gửi yêu cầu để chúng tôi xem xét và kích hoạt hoàn toàn việc triển khai của bạn.
- Chuyển đến Bảng điều khiển Google Pay và Wallet.
- Sử dụng tiện ích Liên hệ với nhóm hỗ trợ.
- Thông báo cho nhóm hỗ trợ rằng bạn đã hoàn tất việc tích hợp tính năng Đăng ký chương trình khách hàng thân thiết.
Sau khi chúng tôi xem xét đầy đủ việc triển khai của bạn và xác nhận rằng chức năng hoạt độ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 chương trình 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.
Để đảm bảo trải nghiệm tối ưu cho người dùng, chúng tôi sẽ tiến hành kiểm tra định kỳ việc triển khai quy trình đăng ký/đăng nhập của bạn để đảm bảo bạn luôn tuân thủ các yêu cầu của tính năng. Bạn sẽ nhận được thông báo nếu 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 được 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ữ ở vị trí
HTTPSvì nếu không, hình ảnh sẽ không xuất hiện trong Google Wallet.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ờ đó bạn có thể xác minh nội dung mà bạn đang gửi. Xin lưu ý rằng Google không liên kết và không đặc biệt đề xuất 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 đang sử dụng phương thức mã hoá UTF-8 trong suốt quá trình. Trước tiên, chuỗi JSON được mã hoá UTF-8 và sau đó được mã hoá bằng android.util.Base64 với các lựa chọn NO_WRAP và URL_SAFE. Điều này tương ứng với RFC 3548 phần 4.