使用者會員方案註冊和票證升級

使用者可透過會員方案註冊和登入功能,直接在 Google 錢包搜尋會員方案,並加入或登入帳戶。使用者會導向至適合行動裝置瀏覽的網站完成程序,之後即可將正式卡片新增至 Google 錢包。

必須先導入這項功能,才能將使用者新增的「靜態」票證轉換為「動態」API 連結票證。 本指南將概略說明相關優點,以及啟用會員方案註冊、登入和票證升級功能所需的導入步驟。

總覽

首先,請確認您已設定專案,並可存取 Google Wallet API。

您必須按照下列四個步驟實作這項功能:

  1. 設定測試類別:設定 Google 錢包,以便測試流程。
  2. 開發網頁:使用 Google 錢包 SharedDataType 建立註冊/登入網頁。
  3. 建置推送機制:在使用者完成動作後,將會員卡傳送至 Google 錢包。
  4. 要求驗證:提交審查並要求啟用升級。

為什麼要導入會員註冊功能?

如要瞭解這項整合功能的價值,請務必區分 Google 錢包中的兩種票證類型:L1 (使用者新增) 和 L2 (合作夥伴核發)。

L1 和 L2 的差異

功能 L1 票證 (使用者新增) L2 憑證 (合作夥伴核發)
來源 使用者手動掃描實體卡片或輸入卡號時建立。 使用者透過您的流程註冊或登入後,使用 Wallet API 建立並推送。
控制 靜態:合作夥伴無法查看或控管這張票證。 動態:合作夥伴可透過 API 完整控管。
功能 條碼的靜態圖片。設定完成後即無法更新。 可更新點數餘額、等級狀態、顯示個人化優惠,以及接收通知。

升級路徑:通往會員方案的「橋樑」

只要建立會員註冊流程 (「目的地」),Google 就能建立「橋梁」,將使用者從靜態 L1 票證升級為官方 L2 票證。主要有兩種升級觸發條件:

  1. L1 升級至 L2 票證:如果使用者先前曾手動新增卡片 (L1),Google 錢包會提示他們前往新的登入流程,升級至官方動態票證 (L2)。
  2. 升級從 Gmail 匯入的票證:如果 Google 錢包偵測到使用者的 Gmail 中有會員卡,就會提示使用者前往您的流程並進行驗證,以取得官方 L2 票證。

步驟 1:在 Google 錢包中設定測試類別

決定註冊和登入網址、計畫標誌,以及所選的使用者欄位。然後,使用 loyaltyclass 中的 discoverableProgram 巢狀欄位設定適當的值。

在 discoverableProgram 中設定值,建立啟用註冊/登入功能的會員方案草稿版本。為確保測試人員能看到這項資訊,請確認他們有權存取 Google Pay 和錢包主控台。如要進一步瞭解如何與他人共用 Google Pay 和錢包控制台的存取權,請參閱「瞭解『使用者』頁面」。

如要在開發過程中完成實作功能驗證,請使用 Google Pay 和錢包主控台中的「與支援團隊聯絡」小工具與我們聯絡。在控制台中,選取主題中的「Google Wallet API」,然後選取子主題中的「會員方案登入/註冊」。

步驟 2:建立註冊和登入頁面

使用者選擇登入或註冊你的會員方案時,系統會將他們導向至你網站上的專屬網頁,方便他們完成註冊或登入程序。如果使用者選擇註冊,Google 錢包就會要求使用者決定是否與你分享他們的使用者資料,並提供相關核准。

您必須提供下列兩個網頁或其中之一,讓使用者完成上述動作:

  1. 登入網址:使用者可登入現有帳戶。
  2. 使用者可建立新帳戶的註冊網址。

登入和註冊頁面必須符合下列規定:

  • 提供適合行動裝置的使用者體驗。
  • 盡量減少註冊程序中的必填欄位。
  • 允許使用者在單一頁面中完成登入或註冊。
  • 使用 HTTPS 加密和有效憑證,確保使用者資料安全傳輸。
  • 確保登入網頁和註冊網頁的正常運作時間至少達 99.9%。

除了上述規定外,我們也建議你建立不須填寫任何表單即可註冊會員方案的程序,或是僅在網頁上要求使用者同意服務條款。

  • 使用者提供 SharedDataType 中的資料後,你就能利用這些資料建立帳戶並立即推送會員卡。
  • 你可以隨後再透過電子郵件將動態密碼寄送給使用者,或是提供可讓使用者設定密碼和選填帳戶資訊的連結。
  • 這麼做可以降低使用者中途退出註冊程序的可能性,因為每增加一個步驟,都可能會讓使用者萌生放棄的念頭。

顯示登入或註冊網頁時,Google 錢包會建立 Android WebView,並向你提供的網址發出 POST 要求。系統會以 application/x-www-form-urlencoded 的 Content-Type 和 UTF-8 編碼傳送 POST 要求,並透過其中的 SharedDataType 參數提供使用者資料。SharedDataType 參數的值是以 Base64 編碼的 JSON 物件。

JSON 物件可能會包含下列欄位,實際欄位視使用者選擇的動作和你指定使用者填寫的欄位而定。

欄位 註冊
電子郵件 ✓
firstName ✓
lastName ✓
addressLine [1-3] ✓
城市 ✓
州 ✓
郵遞區號 ✓
國家/地區 ✓
手機 ✓

如需 SharedDataType 包含的已解碼 JSON 物件範例,請參閱以下內容。

資源

{
  "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"
}

步驟 3:建置可立即將會員卡推送回 Google 錢包的機制

完成驗證 (登入) 或建立帳戶 (註冊) 後,你的網頁必須立即將使用者的會員卡推送回 Google 錢包。

你可以重新導向至符合以下結構的連結,將會員卡推送回 Google 錢包。

https://pay.google.com/gp/v/save/{jwt_generated}

網址的長度上限為 2000 個字元,連結數量不應超過這項限制。透過編碼編入 JWT 中的物件應精簡,且僅包含與使用者相關的資料。請試著將大部分資料存放在物件的類別中,並在產生 JWT 前先建立類別。對於超出限制的大型物件,請考慮先透過 Google Wallet API 建立物件,且在 JWT 中只傳送物件 ID。

一般通訊流程

下圖說明使用者完成註冊或登入的通訊流程。你必須負責執行你的伺服器 (下圖中的「Your Server」) 之間的所有動作。

註冊登入流程

步驟 4:提交驗證與啟用要求

完成開發工作並測試註冊/登入流程後,請提交要求,讓我們審查並全面啟用您的實作項目。

  1. 前往 Google Pay 和錢包主控台。
  2. 使用「聯絡支援團隊」小工具。
  3. 通知支援團隊,你已完成會員註冊整合。

我們會全面審查你建置的項目,在確認相關功能可與 Google 錢包應用程式搭配運作之後,就會公開發布你的會員方案註冊/登入功能。

為確保最佳使用者體驗,我們會定期檢查您的註冊/登入功能,確認持續符合功能規定。如有不一致的情況,系統會通知您,且登入/註冊功能可能會停用,直到問題解決為止。

常見問題

  • 會員方案使用的圖片是否有任何規定? 有。你的圖片託管網址必須採用 HTTPS 通訊協定,否則將無法在 Google 錢包中顯示。

  • 是否有任何工具可以簡化 JWT 的實作和偵錯? 有。www.jwt.io 等平台可讓你在開發過程中為權杖解碼並進行偵錯,方便你驗證要提交的內容。請注意,Google 與該網站並無任何聯盟關係,也並未特別推薦你採用這類第三方服務。

  • 該如何正確處理採用 Base64 編碼的 SharedDataType 資料? 請確認你在開發時全程採用 UTF-8 編碼。JSON 字串會先經過 UTF-8 編碼,再以 android.util.Base64 編碼,並提供 NO_WRAP 和 URL_SAFE 選項。這與 RFC 3548 第 4 節相對應。