ई-कॉमर्स चेकआउट के लिए पते की पुष्टि करना

मकसद

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

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

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

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

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

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

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

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

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

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

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

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

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

पहला चरण: पता डालने का फ़्लो - Place Autocomplete सेवा का इस्तेमाल करना

पता डालने वाले फ़ॉर्म की पहली लाइन पर, JavaScript API का इस्तेमाल करके Place Autocomplete को लागू करें.

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

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

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

इमेज

दूसरा चरण: पतों की पुष्टि करने के लिए, 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 की किसी खास कोशिश के बारे में Google को सुझाव भेजने के लिए, provideValidationFeedback तरीके का इस्तेमाल करें. यह तरीका इस्तेमाल करना ज़रूरी नहीं है.

नतीजा

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

अगले चरण

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

योगदानकर्ता

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


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