चेकआउट के लिए पते की पुष्टि करना

मकसद

इस दस्तावेज़ में, ई-कॉमर्स चेकआउट में किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा, Address Validation API1, और Maps को एक साथ इस्तेमाल करने के तरीकों के बारे में बताया गया है. ऐसा, अच्छी क्वालिटी वाले पते पाने के लिए किया जाता है.

ज़रूरी शर्तें

Google का सुझाव है कि आपको इन विषयों की जानकारी होनी चाहिए:

  • किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा JavaScript डेवलपर के लिए, दस्तावेज़.
    • तकनीकी नज़रिए से समझें कि किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा कैसे काम करती है और इसे लागू करने के कौनसे विकल्प उपलब्ध हैं.
  • किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के लिए, चेकआउट लागू करने से जुड़ी गाइड.
    • ई-कॉमर्स चेकआउट में, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा को लागू करने के सबसे सही तरीकों के उदाहरण.
  • Address Validation API के प्रॉडक्ट से जुड़ा दस्तावेज़. इसमें, पुष्टि करने की लॉजिक बनाना पर फ़ोकस किया गया है.
    • तकनीकी नज़रिए से समझें कि Address Validation API कैसे काम करता है. साथ ही, उन सिग्नल की समीक्षा करें जिनसे पते की क्वालिटी तय होती है.

पते की पुष्टि करना क्या होता है?

Address Validation API एक ऐसी सेवा है जो पता स्वीकार करती है. यह पते के कॉम्पोनेंट की पहचान करती है और उनकी पुष्टि करती है. यह पते को इस हिसाब से बनाती है कि उस पर डाक या कूरियर भेजा जा सके. साथ ही, उसके लिए सबसे सटीक अक्षांश/देशांतर वाले निर्देशांक का पता लगाती है. अमेरिका और प्योर्तो रिको में मौजूद पतों के लिए, आपके पास Coding Accuracy Support System (CASS™) को चालू करने का विकल्प होता है.

चेकआउट के दौरान, पते की पुष्टि करने की ज़रूरत क्यों होती है?

ऑर्डर करने की प्रोसेस के दौरान, सटीक पते इकट्ठा करना:
यह, डिलीवरी को कामयाब बनाने, समय पर ऑर्डर पूरा करने की दर बढ़ाने, और पते में सुधार करने के लिए लगने वाले खर्च को कम करने के लिए ज़रूरी है.

ग्राहकों को पता तेज़ी से और सटीक तरीके से डालने में मदद करना:
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा से, पता डालने की प्रोसेस तेज़ हो जाती है और इनपुट में गड़बड़ियां कम होती हैं. इससे ग्राहक आसानी से चेकआउट कर पाते हैं. Address Validation API, पते की कुल क्वालिटी के बारे में सुझाव देता है. साथ ही, पते में सुधार करता है. जैसे, उसे इस हिसाब से बनाना कि उस पर डाक या कूरियर भेजा जा सके और स्पेलिंग की गलतियां ठीक करना. इसके अलावा, यह मेटाडेटा को बेहतर बनाता है. जैसे, रिहायशी या व्यावसायिक पता बताने वाला इंडिकेटर उपलब्ध कराना. यह सुविधा, चुनिंदा इलाकों में उपलब्ध है.

लागू करने से जुड़ी खास जानकारी

इस सेक्शन में, ई-कॉमर्स चेकआउट के लिए, पता डालने के सुझाए गए वर्कफ़्लो के बारे में बताया गया है. इस प्रोसेस में तीन चरण शामिल हैं:

  1. शुरुआत में पता पाने के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करना.
  2. डाले गए पते की पुष्टि करने के लिए, Address Validation API का इस्तेमाल करना.
  3. डाले गए पते की जगह को मैप पर दिखाना, ताकि ग्राहकों को डिलीवरी के बारे में भरोसा दिलाया जा सके.

इसके बाद, हम हर चरण के बारे में अलग-अलग जानकारी देंगे.

पहला चरण: पता डालने का फ़्लो - किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करना

पता डालने वाले फ़ॉर्म की पहली लाइन पर, JavaScript API का इस्तेमाल करके, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा लागू करें.

किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा, ग्राहक के पता डालने पर सुझाव देती है. JavaScript API का इस्तेमाल करके, इस सुविधा को लागू करने पर, उपयोगकर्ता के टाइप करते ही, पता डालने वाले फ़ॉर्म फ़ील्ड के नीचे एक ड्रॉप-डाउन दिखता है. इसमें, ऑटोकंप्लीट की सुविधा से मिले नतीजे दिखते हैं. हर कीस्ट्रोक के साथ ये नतीजे अपडेट होते हैं. जब उपयोगकर्ता के पास पता ढूंढने के लिए ज़रूरी जानकारी आ जाती है, तो वह ड्रॉप-डाउन से पता चुनता है. इस कार्रवाई से, फ़ॉर्म के फ़ील्ड में पते का डेटा अपने-आप भर जाता है.

किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा की मदद से, उपयोगकर्ता को फ़ॉर्म में जानकारी डालने की दो स्टाइल दी जा सकती हैं: सभी पता फ़ील्ड के साथ दिखने वाली स्टाइल या सिर्फ़ एक इनपुट फ़ील्ड के साथ दिखने वाली स्टाइल. सिर्फ़ एक इनपुट फ़ील्ड वाली स्टाइल में, उपयोगकर्ता को पते के कॉम्पोनेंट अलग-अलग डालने के बजाय, टाइप करते ही खोज शुरू करने का विकल्प मिलता है. ऑटोकंप्लीट की सुविधा से पता भरने के बाद, वर्कफ़्लो, फ़ॉर्म के फ़ील्ड में पते का डेटा डाल देता है. इससे ग्राहक, पते की समीक्षा कर सकते हैं और उसमें बदलाव कर सकते हैं. उदाहरण के लिए, अपार्टमेंट या यूनिट नंबर जोड़ा जा सकता है.

यहां एक इनपुट फ़ील्ड का इस्तेमाल करके, इस फ़्लो के दिखने का एक उदाहरण दिया गया है:

इमेज

पतों की पुष्टि करने के लिए, Address Validation API का इस्तेमाल करना

उपयोगकर्ता के पता डालने के बाद, Google का सुझाव है कि आप चेकआउट के दौरान, Address Validation API को कॉल करें. इससे यह पुष्टि की जा सकेगी कि पता मान्य है और उसमें पूरी जानकारी मौजूद है. जब उपयोगकर्ता, पते वाले फ़ॉर्म पर मौजूद 'अगला' या 'जारी रखें' बटन पर क्लिक करे, तो Address Validation API को कॉल करें. यह बटन अक्सर पेमेंट पेज पर ले जाता है.

Google का सुझाव है कि हर लेन-देन के लिए, Address Validation API को कॉल करें.

यहां दिए गए फ़्लो डायग्राम में, चेकआउट के दौरान, Address Validation API को पूरी तरह से इंटिग्रेट करने का एक उदाहरण दिखाया गया है:

इमेज

इस दस्तावेज़ में, पते स्वीकार करने की स्थितियों के बारे में बाद में बताया गया है.

विज़ुअल पुष्टि की सुविधा देना

पता डालने के बाद, उपयोगकर्ता को डिलीवरी की जगह की विज़ुअल पुष्टि की सुविधा दें. इसके लिए, मैप पर डिलीवरी की जगह दिखाएं. इससे ग्राहक को यह भरोसा मिलता है कि पता सही है. साथ ही, डिलीवरी या पिकअप में होने वाली समस्याएं कम होती हैं.

मैप को चेकआउट की प्रोसेस के दौरान दिखाया जा सकता है या लेन-देन की पुष्टि करने वाले ईमेल में भेजा जा सकता है. इन दोनों स्थितियों में, इन एपीआई का इस्तेमाल किया जा सकता है.

Maps JavaScript API, उपयोगकर्ता की जगह दिखाने के लिए, इंटरैक्टिव मैप उपलब्ध कराता है. Maps Static API की मदद से, वेब पेज में या ईमेल में बाद में, इमेज एम्बेड की जा सकती है.

ज़्यादा जानकारी - पते स्वीकार करने की स्थितियां

Address Validation API से मिले जवाबों को तीन मुख्य स्थितियों में बांटा जा सकता है:

  • ठीक करें—पते की क्वालिटी खराब है. आपको ज़्यादा जानकारी के लिए प्रॉम्प्ट करना चाहिए.
  • पुष्टि करें—पते की क्वालिटी अच्छी है, लेकिन डाले गए पते में बदलाव किए गए हैं. आपको पुष्टि के लिए प्रॉम्प्ट करना पड़ सकता है.
  • स्वीकार करें—पते की क्वालिटी अच्छी है. आपके पास, दिया गया पता स्वीकार करने का विकल्प है.

इस कॉन्सेप्ट के बारे में, Address Validation API के दस्तावेज़ों के पुष्टि करने की लॉजिक बनाना सेक्शन में बताया गया है. हम इस सेक्शन में, हर स्थिति के बारे में चर्चा करेंगे.

ठीक करें

इमेज

इस सेक्शन में, डाले गए पते में गड़बड़ी ठीक करने का तरीका बताया गया है. Address Validation API, खराब क्वालिटी वाले पते की जानकारी देने के लिए, किन सिग्नल का इस्तेमाल करता है, यह जानने के लिए, पुष्टि करने की लॉजिक बनाना दस्तावेज़ में, पते में गड़बड़ी ठीक करना लेख पढ़ें.

अगर Address Validation API से मिले जवाब में पता अमान्य बताया जाता है, तो ग्राहक को पता डालने वाले फ़ॉर्म पर रीडायरेक्ट करें. इससे वह डाले गए डेटा की जांच कर पाएगा. पते में गड़बड़ी ठीक करने के बाद, आपकी सेवा को Address Validation API को फिर से अनुरोध भेजना चाहिए. इससे यह पक्का किया जा सकेगा कि किए गए सुधार मान्य हैं.

addressComponents लेवल पर मिले सिग्नल का इस्तेमाल करके, पते की किसी खास लाइन में मौजूद गड़बड़ियों को भी हाइलाइट किया जा सकता है. इसका एक उदाहरण, दाईं ओर दिए गए स्क्रीनशॉट में देखा जा सकता है.

पुष्टि करें

इमेज

इस सेक्शन में, पते की पुष्टि करने का तरीका बताया गया है. Address Validation API, किन सिग्नल का इस्तेमाल करके यह बताता है कि किसी पते की पुष्टि की जानी चाहिए, यह जानने के लिए, पुष्टि करने की लॉजिक बनाना दस्तावेज़ में, पते की पुष्टि करना लेख पढ़ें.

अक्सर, आपका सिस्टम किसी उपयोगकर्ता को पते की पुष्टि करने के लिए प्रॉम्प्ट करेगा. उदाहरण के लिए, कोई ग्राहक शहर का नाम गलत लिखता है. इसके बाद, Address Validation API उसे ठीक कर देगा. आपको ग्राहक से इस सुधार की पुष्टि करनी चाहिए. ऐसा इसलिए, क्योंकि एपीआई से किए गए बदलावों की वजह से, मूल रूप से डाला गया पता पूरी तरह से बदल सकता है.

ग्राहक को जानकारी दिखाने के लिए, इंटरस्टीशियल मॉडल का इस्तेमाल करें. इससे आगे बढ़ने के तीन विकल्प मिलते हैं:

  1. एपीआई से मिले पते की पुष्टि करें. इसके बाद, सुधारे गए पते का इस्तेमाल करके, चेकआउट की प्रोसेस जारी रहेगी.
  2. मूल रूप से डाले गए पते को चुनें. साथ ही, Address Validation API से मिले सुधार को अनदेखा करें. चेकआउट की प्रोसेस सामान्य तरीके से जारी रह सकती है. साथ ही, अगर आपकी प्रोसेस में इसकी अनुमति है, तो शिपिंग से पहले, ऑर्डर को डाउनस्ट्रीम समीक्षा के लिए फ़्लैग किया जा सकता है.
  3. ग्राहक, मॉडल को रद्द कर देता है या उससे बाहर निकल जाता है. इससे वह चेकआउट की प्रोसेस के पता डालने वाले चरण पर वापस आ जाता है. यहां वह पता फिर से डाल सकता है और प्रोसेस को फिर से शुरू कर सकता है.

इसका एक उदाहरण, दाईं ओर दिए गए स्क्रीनशॉट में देखा जा सकता है.

स्वीकार करें

इस सेक्शन में, पते को स्वीकार करने का तरीका बताया गया है. Address Validation API, किन सिग्नल का इस्तेमाल करके यह बताता है कि किसी पते की क्वालिटी अच्छी है और उसे स्वीकार किया जाना चाहिए, यह जानने के लिए, पुष्टि करने की लॉजिक बनाना दस्तावेज़ में, पते को स्वीकार करना लेख पढ़ें.

इस स्थिति में, चेकआउट की प्रोसेस अगले चरण पर जानी चाहिए. इसमें, पेमेंट की जानकारी इकट्ठा की जाती है. साथ ही, पते की क्वालिटी के बारे में ग्राहक को कोई प्रॉम्प्ट नहीं दिखना चाहिए. एपीआई ने पुष्टि की है कि ग्राहक ने जो पता डाला है उसकी क्वालिटी अच्छी है और उस पते पर डिलीवरी की जा सकती है.

हमारा सुझाव है कि ऑर्डर के लिए, Address Validation API से मिले पते के डेटा का इस्तेमाल करें. ऐसा इसलिए, क्योंकि इसमें मामूली सुधार और जानकारी जोड़ी जा सकती है. जैसे:

  • कैपिटल लेटर का इस्तेमाल
  • फ़ॉर्मैटिंग में सुधार, जैसे
    • Street को St में बदलना
    • पते के कॉम्पोनेंट का सही क्रम
  • अमेरिका में ZIP+4.

कार्यान्वयन विचार

पते स्वीकार करने की लॉजिक बनाते समय, पक्का करें कि अमान्य पता डालने की वजह से, ग्राहक चेकआउट न कर पाएं. लॉजिक को इस तरह बनाएं कि अगर एपीआई बार-बार यह बताए कि डाला गया पता अमान्य है, तो इनफ़ाइनाइट लूप की संभावना न हो.

Google का सुझाव है कि ग्राहकों को पता डालने के लिए दो मौके दें. साथ ही, दूसरी बार में, उनके डाले गए पते को स्वीकार करें. भले ही, वह मान्य न हो. दूसरी बार में, हमारा लक्ष्य यह है कि ग्राहक, पुष्टि की प्रोसेस पूरी हुए बिना भी आगे बढ़ सकें.

दूसरी बार में, पते को स्वीकार करने के दो सुझाए गए तरीके:

  • फ़ोर्स-प्रोसीड: ग्राहक को एक मॉडल दिखाएं. इसमें बताया गया हो कि पते की पुष्टि नहीं हो रही है. हालांकि, उन्हें टाइप किए गए पते के साथ आगे बढ़ने का विकल्प दें.
  • साइलेंट ऐक्सेप्टेंस: पुष्टि के चरण के बिना, दूसरी बार में डाले गए पते को अपने-आप स्वीकार करें. भले ही, पते की पूरी तरह से पुष्टि न हुई हो.

अगर मुमकिन हो, तो अपने सिस्टम को इस तरह डिज़ाइन करें कि वह उन पतों को फ़्लैग करे जिनकी पुष्टि नहीं हुई है. इससे, ग्राहक सेवा प्रतिनिधि, ऑर्डर शिप होने से पहले उनकी समीक्षा कर पाएगा. इस अतिरिक्त मेज़र से, यह पक्का किया जा सकेगा कि कोई भी गलती न हो.

नई इमारत के निर्माण से, यह समझने में मदद मिलती है कि इस जांच की सलाह क्यों दी जाती है. ऐसा हो सकता है कि नई इमारत का निर्माण पूरा होने और डाक पते के डेटाबेस में उस इमारत का पता दिखने के बीच कुछ समय का अंतर हो. ग्राहकों के पास, टाइप किए गए पते के साथ चेकआउट पेज पर फ़ोर्स-प्रोसीड करने का विकल्प होना चाहिए. भले ही, पते की पुष्टि न हुई हो.

चेकआउट का सेशन पूरा होने के बाद, Address Validation API के किसी खास अनुरोध के बारे में Google को सुझाव भेजने के लिए, provideValidationFeedback तरीके का इस्तेमाल करें. यह तरीका इस्तेमाल करना ज़रूरी नहीं है.

नतीजा

इस दस्तावेज़ में, चेकआउट प्रोसेस की खास जानकारी दी गई है जिसमें Google Maps पर, ऑटोकंप्लीट की सुविधा, Address Validation API, और विज़ुअल पुष्टि की सुविधा लागू की गई है. अपने सिस्टम को डिज़ाइन करने के लिए, इस दस्तावेज़ को शुरुआती पॉइंट के तौर पर इस्तेमाल करें. साथ ही, पता डालने के सुझाए गए फ़्लो का पालन करें.

अगले चरण

इस बारे में और पढ़ें:

योगदानकर्ता

हेनरिक वाल्व | सलूशन इंजीनियर
थॉमस ऐंगलारेट | सलूशन इंजीनियर
सार्थक गांगुली | सलूशन इंजीनियर

  1. यूनाइटेड स्टेट्स पोस्टल सर्विस का नॉन-एक्सक्लूसिव लाइसेंस पाने वाला व्यक्ति या कंपनी. इन ट्रेडमार्क का मालिकाना हक, यूनाइटेड स्टेट्स पोस्टल सर्विस® के पास है और इनका इस्तेमाल अनुमति लेकर किया जाता है: CASS™, USPS®, DPV®. ↩