Tính năng đăng ký và đăng nhập chương trình khách hàng thân thiết cho phép người dùng tì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ọ ngay trong Google Wallet. Người dùng sẽ được chuyển hướng đến trang web phù hợp 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 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é "động" được liên kết với API. 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 tính năng đăng ký, đăng nhập và nâng cấp thẻ của 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 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 lớp thử nghiệm: Định cấu hình Google Wallet để thử nghiệm quy trình của bạn.
- Phát triển trang: Tạo trang đăng ký/đăng nhập bằng
SharedDataTypecủa Google Wallet. - 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 để được xem xét và yêu cầu kích hoạt bản 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 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ẻ và vé L1 (Do người dùng thêm) | Thẻ cấp 2 (Do đối tác cấp) |
|---|---|---|
| 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ố thẻ. | Được tạo và gửi 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 thể xem hoặc kiểm soát thẻ/vé này. | Sống động. Đối tác có toàn quyền kiểm soát bằng cách sử dụng API. |
| Chức năng | Hình ảnh tĩnh của 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, hiển thị ưu đãi được cá nhân hoá và nhận thông báo. |
Lộ trình nâng cấp: "Cầu nối" đến chương trình của bạn
Bằng cách xây dựng 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 xây dựng một "cầu nối" để nâng cấp người dùng từ thẻ và vé L1 tĩnh lên thẻ và vé L2 chính thức của bạn. Có hai yếu tố kích hoạt nâng cấp chính:
- Nâng cấp thẻ và vé từ L1 lên L2: Nếu trước đây người dùng đã thêm thẻ của bạn theo cách thủ công (L1), thì Google Wallet có thể nhắc họ truy cập vào quy trình đăng nhập mới để nâng cấp lên thẻ và vé động chính thức (L2).
- Nâng cấp thẻ đượ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ẻ L2 chính thức.
Bước 1: Thiết lập lớp thử nghiệm trong Google Wallet
Xác định URL đăng ký và đăng nhập, biểu trưng của chương trình và các trường người dùng đã chọn. Sau đó, hãy sử 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 thử nghiệm có thể nhìn thấy thông tin này, hãy xác minh rằng người thử nghiệm 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 and 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 tiện ích hỗ trợ liên hệ trong Google Pay and Wallet Console. Trong bảng điều khiển, hãy chọn Google Wallet API trong phần chủ đề, rồi chọn Đăng nhập/đăng ký chương trình khách hàng thân thiết trong phần chủ đề phụ.
Bước 2: Phát triển 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, họ sẽ được chuyển đế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 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à trang đăng ký của bạn phải đáp ứng các yêu cầu sau:
- Mang đến trải nghiệm thân thiện với thiết bị di động cho người dù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 đi một cách an toàn. - Đảm bảo thời gian hoạt động của trang đăng nhập và trang đăng ký đạt í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ỉ cần chấp nhận điều khoản dịch vụ trên trang.
- 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 tài khoản và ngay lập tức gửi lại thẻ khách hàng thân thiết cho họ. - Sau đó, bạn có thể gửi cho người dùng mật khẩu một lần hoặc đường liên kết để định cấu hình mật khẩu và thông tin chi tiết không bắt buộc về tài khoản.
- Điều này giúp giảm khả năng người dùng bỏ dở quy trình đăng ký, vì mỗi bước bổ sung đều có thể khiến người dùng bỏ dở.
Khi hiển thị trang đăng nhập hoặc trang đăng ký, Google Wallet sẽ tạo một
Android WebView và một 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 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ã bưu chính | ✓ |
| country | ✓ |
| điện thoại | ✓ |
Hãy tham khảo nội dung sau đây để 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 ngay lập tức đến 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 trở lại Google Wallet.
Bạn có thể đẩy 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. 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 các đối tượng lớn hơn không vượt quá 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ã đối tượng trong JWT.
Quy trình giao tiếp thông thường
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 sau. Bạn có trách nhiệm triển khai tất cả các 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ử quy trình đăng ký/đăng nhập, bạn phải gửi yêu cầu để được xem xét và kích hoạt đầy đủ quy trình triển khai.
- Chuyển đến Google Pay and Wallet Console.
- 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 xem xét đầy đủ quá trình triển khai của bạn để xác nhận chức năng chính xác 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 tính năng đăng ký/đăng nhập để đảm bảo bạn luôn tuân thủ các yêu cầu của 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ị 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 sử 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ữ ở một vị trí
HTTPS, nếu không thì 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, giúp bạn 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 đề xuất cụ thể bất kỳ bên thứ ba nào như vậy.
Làm cách nào để xử lý đúng cách 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á theo chuẩn UTF-8, 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 RFC 3548 mục 4.