लॉयल्टी प्रोग्राम में रजिस्टर और साइन इन करने की सुविधा, लोगों को आपका लॉयल्टी प्रोग्राम खोजने और Google Wallet से अपने खाते में शामिल होने या साइन इन करने की सुविधा देती है. उपयोगकर्ताओं को प्रक्रिया पूरी करने के लिए, आपकी मोबाइल-फ़्रेंडली वेबसाइट पर भेजा जाएगा. इसके बाद, वे Google Wallet में अपना कार्ड जोड़ सकते हैं.
इस गाइड में, लागू करने के उन चरणों के बारे में खास जानकारी दी गई है जो इस सुविधा के लिए आपके लॉयल्टी प्रोग्राम को चालू करने के लिए ज़रूरी हैं.
खास जानकारी
शुरू करने के लिए, पक्का करें कि आपने अपना प्रोजेक्ट पहले से सेट अप कर लिया हो और आपके पास Google Wallet API का ऐक्सेस हो.
अपने लॉयल्टी प्रोग्राम के लिए रजिस्टर करने और साइन-इन करने की सुविधा लागू करने के लिए, आपको इन चार चरणों को पूरा करना होगा:
- अपने रजिस्ट्रेशन/साइन-इन फ़्लो की जांच करने के लिए, Google Wallet में टेस्ट क्लास सेट अप करें.
- Google Wallet का इस्तेमाल करने वाले रजिस्ट्रेशन/साइन-इन पेज डेवलप करें
SharedDataType. - रजिस्ट्रेशन या साइन इन करने के बाद, Google Wallet में लॉयल्टी कार्ड का पुश बैक लागू करें.
- पुष्टि और चालू करने का अनुरोध करें.
Google Wallet में टेस्ट क्लास सेट अप करें
रजिस्ट्रेशन और साइन-इन करने के यूआरएल, अपने प्रोग्राम का लोगो, और उपयोगकर्ता के चुने गए फ़ील्ड तय करें. इसके बाद,
सही वैल्यू सेट करने के लिए,
loyaltyclass में
discoverableProgram नेस्ट किए गए फ़ील्ड
इस्तेमाल करें.
अपने रजिस्ट्रेशन/साइन-इन की सुविधा वाले लॉयल्टी प्रोग्राम का ड्राफ़्ट वर्शन बनाने के लिए, discoverableProgram में
वैल्यू सेट करें. यह पक्का करने के लिए कि यह टेस्टर को दिखे, पुष्टि करें कि
टेस्टर के पास आपके Google Pay और Wallet Console का ऐक्सेस है या नहीं. अपने
Google Pay और Wallet Console के ऐक्सेस को अन्य लोगों के साथ शेयर करने का तरीका जानने के लिए, उपयोगकर्ता पेज के बारे में जानें देखें.
डेवलपमेंट प्रोसेस के दौरान लागू करने के फ़ंक्शन की पुष्टि करने के लिए, Google Pay और Wallet Console में मौजूद 'सहायता' विजेट का इस्तेमाल करके, हमसे संपर्क करें. कंसोल में, विषय में Google Wallet API चुनें. इसके बाद, उप-विषय में लॉयल्टी साइन-इन/रजिस्ट्रेशन चुनें.
Google Wallet उपयोगकर्ता के डेटा का इस्तेमाल करने वाले रजिस्ट्रेशन और साइन इन पेज डेवलप करना
जब कोई उपयोगकर्ता आपके लॉयल्टी प्रोग्राम के लिए साइन इन या रजिस्टर करता है, तो उसे आपकी वेबसाइट के उस पेज पर भेज दिया जाता है जो उसके हिसाब से बनाया गया है. ऐसा इसलिए किया जाता है, ताकि रजिस्ट्रेशन या साइन इन की प्रोसेस पूरी की जा सके. अगर कोई उपयोगकर्ता नाम दर्ज करना चुनता है, तो Google Wallet उपयोगकर्ता से अपने उपयोगकर्ता का डेटा आपके साथ शेयर करने की अनुमति देने का अनुरोध करेगा.
आपको इन दोनों में से कोई एक या दोनों पेज उपलब्ध कराने होंगे, ताकि उपयोगकर्ता इन कार्रवाइयों को पूरा कर सकें.
- साइन-इन करने का यूआरएल, जहां उपयोगकर्ता किसी मौजूदा खाते में साइन इन कर सकता है.
- रजिस्ट्रेशन यूआरएल, जहां उपयोगकर्ता नया खाता बना सकता है.
आपके साइन इन और रजिस्ट्रेशन पेजों को इन ज़रूरी शर्तों को पूरा करना होगा:
- मोबाइल-फ़्रेंडली उपयोगकर्ता अनुभव देना.
- रजिस्ट्रेशन की प्रक्रिया के दौरान, ज़रूरी फ़ील्ड की संख्या कम से कम रखें.
- उपयोगकर्ता को एक ही पेज के अंदर, साइन इन या रजिस्ट्रेशन पूरा करने की अनुमति दें.
- यह पक्का करने के लिए कि उपयोगकर्ता का डेटा
सुरक्षित तरीके से ट्रांसमिट किया जाए, मान्य सर्टिफ़िकेट के साथ
HTTPSएन्क्रिप्ट (सुरक्षित) करने का तरीका इस्तेमाल करें. - पक्का करें कि आपके साइन इन और रजिस्ट्रेशन पेजों का कम से कम 99.9% अपटाइम हो.
ऊपर बताई गई ज़रूरी शर्तों के अलावा, हमारा सुझाव है कि आप उपयोगकर्ताओं को अपने लॉयल्टी प्रोग्राम में रजिस्टर करने की अनुमति दें. इसके लिए, कोई फ़ॉर्म न भरें या पेज को सिर्फ़ सेवा की शर्तें स्वीकार न करने दें.
SharedDataTypeमें दिए गए उपयोगकर्ता के डेटा का इस्तेमाल करके, खाता बनाया जा सकता है और उसका लॉयल्टी कार्ड तुरंत रद्द किया जा सकता है.- इसके बाद, उपयोगकर्ता को एक बार इस्तेमाल होने वाला पासवर्ड ईमेल किया जा सकता है. इसके अलावा, उसका पासवर्ड कॉन्फ़िगर करने और खाते की वैकल्पिक जानकारी को कॉन्फ़िगर करने के लिए, एक लिंक भी दिया जा सकता है.
- इससे उपयोगकर्ताओं के रजिस्ट्रेशन की प्रोसेस पूरी न करने की संभावना कम हो जाती है, क्योंकि हर अतिरिक्त चरण पूरा करने पर, लोगों को पेज छोड़कर जाने की संभावना बढ़ जाती है.
साइन इन या रजिस्ट्रेशन पेज प्रज़ेंट करते समय, Google Wallet एक Android वेबव्यू बनाएगा और आपके दिए गए यूआरएल पर POST का अनुरोध किया जाएगा. उपयोगकर्ता का डेटा SharedDataType पैरामीटर में दिया जाता है, जो POST अनुरोध में शामिल होता है. इसके लिए,
ऐप्लिकेशन/x-www-form-urlencoded कॉन्टेंट टाइप और
UTF-8 एन्कोडिंग का इस्तेमाल किया जाता है. SharedDataType पैरामीटर की वैल्यू, Base64 कोड में बदला गया JSON ऑब्जेक्ट है.
उपयोगकर्ता की चुनी गई कार्रवाई और उपयोगकर्ता से अनुरोध करने के लिए तय किए गए फ़ील्ड के आधार पर, JSON ऑब्जेक्ट में ये फ़ील्ड हो सकते हैं.
| फ़ील्ड | सेट अप | साइन इन करना |
|---|---|---|
| ईमेल | ✓ | ✓ |
| firstName | ✓ | |
| lastName | ✓ | |
| पते की लाइन [1-3] | ✓ | |
| city | ✓ | |
| state | ✓ | |
| पिन कोड | ✓ | |
| country | ✓ | |
| फ़ोन | ✓ |
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"
}
Google Wallet में लॉयल्टी कार्ड को तुरंत पुश बैक लागू करें
पुष्टि (साइन इन) होने या खाता बनाने (रजिस्ट्रेशन) के बाद, आपका पेज उपयोगकर्ता का लॉयल्टी कार्ड तुरंत Google Wallet में भेज देगा.
आपके पास लॉयल्टी कार्ड को Google Wallet में वापस भेजने का विकल्प है. इसके लिए, आपको नीचे दिए गए स्ट्रक्चर के हिसाब से बने लिंक पर रीडायरेक्ट करना होगा.
https://pay.google.com/gp/v/save/{jwt_generated}
यूआरएल के लिए सुरक्षित लंबाई 2000 वर्ण होती है. आपके लिंक इस सीमा से कम होने चाहिए. JWT में कोड में बदले गए ऑब्जेक्ट, छोटे होने चाहिए. इनमें सिर्फ़ ऐसा डेटा होना चाहिए जो उपयोगकर्ता के लिए खास हो. ज़्यादातर डेटा को ऑब्जेक्ट की क्लास में रखने की कोशिश करें और JWT बनाने से पहले इसे बनाएं. सीमा में फ़िट नहीं होने वाले बड़े ऑब्जेक्ट के लिए, पहले Google Wallet API में ऑब्जेक्ट बनाएं और JWT में सिर्फ़ ऑब्जेक्ट आईडी भेजें.
बातचीत करने का सामान्य तरीका
नीचे दी गई इमेज में, नाम दर्ज कराने या साइन इन करने वाले उपयोगकर्ता के लिए कम्यूनिकेशन फ़्लो को दिखाया गया है. "आपका सर्वर" के बीच होने वाली सभी कार्रवाइयों को लागू करना आपकी ज़िम्मेदारी है.
पुष्टि और खाता चालू करने का अनुरोध करें
डेवलपमेंट का काम और अपने रजिस्ट्रेशन/साइन-इन फ़्लो की जांच करने के बाद, Google Pay और Wallet Console के सहायता विजेट की मदद से अनुरोध सबमिट करें.
Google Wallet ऐप्लिकेशन के साथ काम करने की सुविधा के सही फ़ंक्शन की पुष्टि करने के बाद, पूरी समीक्षा करने के बाद, आपके लॉयल्टी प्रोग्राम के लिए लॉयल्टी प्रोग्राम में रजिस्टर करने/साइन इन करने की सुविधा सार्वजनिक रूप से लॉन्च कर दी जाएगी. ऐसा करने से, कोई भी उपयोगकर्ता प्रोग्राम को देख सकेगा और इस सुविधा का इस्तेमाल कर पाएगा.
लोगों को बेहतर अनुभव देने के लिए, खाते के रजिस्ट्रेशन/साइन इन करने की प्रोसेस की बार-बार जांच की जाएगी. इससे यह पक्का किया जा सकेगा कि सुविधा से जुड़ी ज़रूरी शर्तों का लगातार पालन किया जा रहा हो. अगर कोई गड़बड़ी होती है, तो आपको इसकी सूचना दी जाएगी. साथ ही, समस्या हल होने तक साइन इन/रजिस्ट्रेशन करने की सुविधा बंद हो सकती है.
अक्सर पूछे जाने वाले सवाल
- क्या मेरे लॉयल्टी प्रोग्राम में इस्तेमाल की गई इमेज के लिए कोई ज़रूरी शर्त है?
- हां, आपकी इमेज
HTTPSजगह पर होस्ट की जानी चाहिए क्योंकि वे Google Wallet में नहीं दिखेंगी.
- हां, आपकी इमेज
- क्या कोई ऐसा टूल है जो JWT को लागू करने और डीबग करने की प्रोसेस को आसान बना सकता है?
- हां, www.jwt.io जैसे प्लैटफ़ॉर्म आपको अपनी डेवलपमेंट प्रोसेस के दौरान, टोकन को डिकोड और डीबग करने की सुविधा देते हैं. इससे, सबमिट किए जाने वाले कॉन्टेंट की पुष्टि करने में भी मदद मिलती है. ध्यान दें कि Google का कोई संबंध नहीं है और वह ऐसे किसी भी तीसरे पक्ष को खास तौर पर इस्तेमाल करने का सुझाव नहीं देता है.
- हम Base64 कोड में बदले गए SharedDataType डेटा को सही तरीके से कैसे मैनेज करते हैं?
- पक्का करें कि आप अपनी पूरी प्रोसेस के दौरान UTF-8 एन्कोडिंग का इस्तेमाल कर रहे हैं. JSON स्ट्रिंग को पहले UTF-8 कोड में बदला गया है. इसके बाद, इसे android.util.Base64 का इस्तेमाल करके, NO_WRAP और URL_SAFE, के विकल्प के साथ एन्कोड किया जाता है. यह आरएफ़सी 3548 के सेक्शन 4 के मुताबिक है.