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