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

मकसद

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

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

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

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

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

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

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

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

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

लागू करने के बारे में खास जानकारी

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

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

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

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

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

किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा, ग्राहक को पते की जानकारी डालते समय सुझाव देती है. JavaScript API का इस्तेमाल करके इस सुविधा को लागू करने पर, जैसे ही उपयोगकर्ता टाइप करना शुरू करते हैं, पता डालने के फ़ॉर्म फ़ील्ड के नीचे एक ड्रॉप-डाउन दिखता है. इसमें 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 से मिले पते के डेटा का इस्तेमाल करें. ऐसा इसलिए, क्योंकि इसमें छोटे-मोटे सुधार और बदलाव शामिल हो सकते हैं. जैसे:

  • अक्षर बड़े करना
  • फ़ॉर्मैटिंग से जुड़ी गड़बड़ियां ठीक करना, जैसे कि
    • स्ट्रीट से सेंट
    • पते के कॉम्पोनेंट का सही क्रम
  • अमेरिका में ZIP+4.

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

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

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

दूसरे प्रयास को स्वीकार करने के लिए, ये दो तरीके सुझाए गए हैं:

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

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

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

चेकआउट सेशन पूरा होने के बाद, provideValidationFeedback तरीके का इस्तेमाल करके, Google को पते की पुष्टि करने की किसी कोशिश के बारे में सुझाव/राय दें या शिकायत करें. हालांकि, ऐसा करना ज़रूरी नहीं है.

नतीजा

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

अगले चरण

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

योगदानकर्ता

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

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