會員註冊與登入功能可讓使用者在 Google Pay 中搜尋並加入你的會員方案,或登入自己的帳戶。系統會將使用者導向至行動裝置適用的網站,以便他們完成相關程序,並隨後在 Google Pay 中輕鬆儲存會員卡。
本指南將概略介紹必要的實作步驟,協助你為會員方案啟用這項功能。
總覽
首先,請確認你先前已設定專案,並已取得 Google Pay API for Passes 的存取權。如果尚未完成前述動作,請按照 Google Pay API for Passes 中的指示操作。
如要為你的會員方案實作註冊與登入功能,請按照下列四個步驟操作:
- 在 Google Pay 中設定測試環境,以便測試註冊/登入流程。
- 開發可利用 Google Pay 使用者資料的註冊/登入網頁。
- 建置可在使用者註冊/登入後將會員卡推送回 Google Pay 的機制。
- 要求驗證及啟用。
在 Google Pay 中設定測試環境
請決定你的註冊和登入網址、會員方案標誌,以及所需的使用者欄位,然後使用 loyaltyclass
中的 discoverableProgram
巢狀欄位來設定適用的值。
設定 discoverableProgram
中的值,即可建立含有註冊/登入功能的會員方案草稿版本。為確保測試人員能看到這項資訊,請確認測試人員可存取你的商家主控台。關於如何與其他人分享商家主控台存取權的詳情,請參閱瞭解使用者頁面。
如要在開發過程中完成實作功能的驗證,請使用商家主控台中的 [與支援團隊聯絡] 小工具與我們聯絡。在主控台中,選取主題中的 [票證],然後選取子主題中的 [會員方案登入/註冊]。
開發可利用 Google Pay 使用者資料的註冊/登入網頁
使用者選擇登入或註冊您的會員方案時,系統會將他們導向至您網站上的專屬網頁,方便他們完成註冊或登入程序。如果使用者選擇註冊,Google Pay 就會要求使用者決定是否與您分享他們的使用者資料,並提供相關核准。
您必須提供下列兩個網頁或其中之一,讓使用者完成上述動作。
- 可讓使用者登入現有帳戶的登入網址。
- 可讓使用者建立新帳戶的註冊網址。
登入網頁和註冊網頁必須符合下列規定:
- 提供行動版的使用者體驗。
- 儘可能減少註冊程序中的必填欄位數量。
- 讓使用者可在單一網頁中完成登入或註冊程序。
- 使用有效憑證並採用
HTTPS
加密,確保使用者的資料在傳輸時能安全無虞。 - 確保登入網頁和註冊網頁的正常運作時間至少達 99.9%。
除了上述規定外,我們也建議您建立不須填寫任何表單即可註冊會員方案的程序,或是僅在網頁上要求使用者同意服務條款。
- 使用者提供資料後,您就能利用這些資料建立帳戶並立即推送會員卡。
- 您可以隨後再透過電子郵件將一次性的密碼寄送給使用者,或是提供可讓使用者設定密碼和選填帳戶資訊的連結。
- 這麼做可以降低使用者中途退出註冊程序的可能性,因為每增加一個步驟,都可能會讓使用者萌生放棄的念頭。
顯示登入或註冊網頁時,Google Pay 會建立 Android WebView,並向您提供的網址發出 POST
要求。系統會以 application/x-www-form-urlencoded 內容類型和 UTF-8
編碼傳送 POST
要求,並透過其中的 userProfile
參數提供使用者資料。userProfile
參數的值為採用 Base64 編碼的 JSON 物件。
JSON 物件可能會包含下列欄位,實際欄位視使用者選擇的動作和您指定使用者填寫的欄位而定。
欄位 | 註冊 | 登入 |
---|---|---|
電子郵件 | ✓ | ✓ |
firstName | ✓ | |
lastName | ✓ | |
addressLine [1-3] | ✓ | |
city | ✓ | |
state | ✓ | |
zipcode | ✓ | |
country | ✓ | |
phone | ✓ |
如需 userProfile
包含的已解碼 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" }
建置可立即將會員卡推送回 Google Pay 的機制
完成驗證 (登入) 或建立帳戶 (註冊) 後,您的網頁必須立即將使用者的會員卡推送回 Google Pay。
您可以重新導向至符合以下結構的連結,將會員卡推送回 Google Pay。如果您還不太熟悉如何為代表使用者會員卡的 LoyaltyObject
產生 JSON Web Token (JWT),請參閱產生一個代表物件的 JWT 一節。
https://pay.google.com/gp/v/save/{jwt_generated}
網址的長度上限為 2000 個字元,您的連結不應超過此限制。透過編碼編入 JWT 中的物件應精簡,且僅包含與使用者相關的資料。請試著將大部分資料存放在物件的類別中,並在建立 JWT 前先建立類別。對於超出限制的大型物件,請考慮先透過 Google Pay API for Passes 建立物件,且在 JWT 中只傳送物件 ID。
一般通訊流程
使用者完成註冊或登入程序的通訊流程如下圖所示。您必須負責實作您的伺服器 (下圖中的「Your Server」) 之間的所有動作。
![註冊登入流程](https://developers-dot-devsite-v2-prod.appspot.com/static/pay/passes/images/EnrollmentSigninFlows.png?authuser=2&hl=zh-tw)
提交驗證與啟用要求
完成開發工作並測試註冊/登入程序之後,請透過商家主控台中的「與支援團隊聯絡」小工具提交要求。
我們會徹底審查您實作的項目,確認相關功能可以與 Google Pay 應用程式搭配運作之後,就會公開發布您的會員方案註冊/登入功能。公開發布之後,任何使用者都能查看會員方案及使用這項功能。
為提供最優質的使用者體驗,我們每隔一段時間就會檢查您導入的註冊/登入機制,確保您持續遵守相關功能規定。如果發現不符合規定的情況,系統會通知您。另外,在問題解決之前,登入/註冊功能可能會遭到停用。
常見問題
- 會員方案中使用的圖片是否有任何規定?
- 有。您的圖片託管網址必須採用
HTTPS
通訊協定,否則將無法在 Google Pay 中顯示。
- 有。您的圖片託管網址必須採用
- 是否有任何工具能簡化 JWT 的實作和偵錯作業?
- 有。www.jwt.io 等平台可讓您在開發過程中為權杖解碼並進行偵錯,方便您驗證要提交的內容。請注意,Google 與該網站並無任何聯盟關係,也並未特別推薦你採用這類第三方服務。
- 該如何正確處理採用 Base64 編碼的 userProfile 資料?
- 請確認您在開發時全程採用 UTF-8 編碼。JSON 字串會先以 UTF-8 編碼,再以 android.util.Base64 編碼,並提供 NO_WRAP 和 URL_SAFE。(符合 RFC 3548 第 4 節的規定)。
註冊流程範例
![會員註冊流程](https://developers-dot-devsite-v2-prod.appspot.com/static/pay/passes/images/loyalty-enrollment-flow.jpg?authuser=2&hl=zh-tw)