मकसद
इस दस्तावेज़ में, अच्छी क्वालिटी के पते कैप्चर करने के मकसद से, ई-कॉमर्स चेकआउट में जगह की जानकारी के लिए ऑटोकंप्लीट, पते की पुष्टि करने वाले एपीआई1, और Maps को जोड़ने के तरीकों के बारे में बताया गया है.
ज़रूरी शर्तें
Google का सुझाव है कि आप इनके बारे में जानकारी रखें:
- जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के लिए JavaScript डेवलपर के दस्तावेज़.
- तकनीकी तौर पर जानें कि जगह की जानकारी के लिए ऑटोकंप्लीट की सुविधा कैसे काम करती है और इसे लागू करने के विकल्प क्या हैं.
- चेकआउट की सुविधा लागू करने के लिए, जगह की जानकारी अपने-आप भरने की सुविधा से जुड़ी गाइड.
- ई-कॉमर्स चेकआउट पेज पर, जगह की जानकारी अपने-आप पूरी होने की सुविधा को लागू करने के सबसे सही तरीकों के उदाहरण.
- Address Validation API प्रॉडक्ट के दस्तावेज़, जिसमें पुष्टि करने का लॉजिक बनाएं पर फ़ोकस किया गया है.
- तकनीकी दृष्टिकोण से समझें कि Address Validation API कैसे काम करता है और पते की क्वालिटी तय करने वाले सिग्नल की समीक्षा करें.
पते की पुष्टि करने का क्या मतलब है?
Address Validation API एक ऐसी सेवा है जो किसी पते को स्वीकार करती है. यह पते के कॉम्पोनेंट की पहचान करता है और उनकी पुष्टि करता है. यह मेलिंग के लिए पते को स्टैंडर्ड भी बनाता है और इसके लिए सबसे सही अक्षांश/देशांतर के निर्देशांक ढूंढता है. इसके अलावा, अमेरिका और प्योर्तो रिको के पतों के लिए, कोडिंग सटीक बनाने के लिए सहायता देने वाला सिस्टम (सीएएसएस™) चालू किया जा सकता है.चेकआउट के समय, पते की पुष्टि क्यों ज़रूरी है?
ऑर्डर करने की प्रोसेस के दौरान सटीक पते इकट्ठा करना:
यह एक अहम चरण है. इससे डिलीवरी को बेहतर बनाने, समय पर ऑर्डर डिलीवर करने, और पते में बदलाव करने के लिए खरीदार से लिए जाने वाले शुल्क को कम करने में मदद मिलती है.
ग्राहकों को पता जल्दी और सही तरीके से डालने में मदद करें:
ऑटोकंप्लीट की सुविधा से, पता डालने में लगने वाला समय कम हो जाता है और इनपुट से जुड़ी गड़बड़ियां कम हो जाती हैं. इससे खरीदार आसानी से चेकआउट कर पाते हैं. पते की पुष्टि करने की सुविधा, पते की क्वालिटी के बारे में जानकारी देती है. साथ ही, उसमें सुधार करती है. जैसे, स्टैंडर्ड बनाने और वर्तनी की गड़बड़ियों को ठीक करना. साथ ही, मेटाडेटा को बेहतर बनाती है. जैसे, घर या कारोबार का इंडिकेटर देना. यह सुविधा चुनिंदा इलाकों में उपलब्ध है.
लागू करने के बारे में खास जानकारी
इस सेक्शन में, ई-कॉमर्स चेकआउट के लिए, पते डालने के सुझाए गए वर्कफ़्लो के बारे में बताया गया है. इस प्रोसेस में तीन चरण होते हैं:
- शुरुआत में पता कैप्चर करने के लिए, जगह के नाम के लिए ऑटोकंप्लीट की सुविधा का इस्तेमाल करें.
- डाले गए पते की पुष्टि करने के लिए, Address Validation API का इस्तेमाल करें.
- मैप पर डाले गए पते की जगह दिखाएं, ताकि खरीदारों को डिलीवरी के बारे में भरोसा दिलाया जा सके.
इसके बाद, हम हर चरण के बारे में अलग-अलग तरीके से बताएंगे.
पहला चरण: पते की जानकारी डालने का फ़्लो - जगह की जानकारी अपने-आप भरने की सेवा का इस्तेमाल करना
पते डालने के फ़ॉर्म की पहली लाइन पर, JavaScript API का इस्तेमाल करके जगह का नाम अपने-आप भरने की सुविधा लागू करें.
जगह की जानकारी अपने-आप पूरी होने की सुविधा, खरीदार को पते की जानकारी डालते समय सुझाव देती है. JavaScript API का इस्तेमाल करके लागू करने पर, उपयोगकर्ताओं के टाइप करने पर, पते के लिए जानकारी डालने वाले फ़ॉर्म फ़ील्ड के नीचे एक ड्रॉप-डाउन दिखता है. इसमें, ऑटोकंप्लीट की सुविधा से मिले नतीजे दिखते हैं, जो हर कीस्ट्रोक के साथ अपडेट होते रहते हैं. जब उपयोगकर्ता, पता ढूंढने के लिए ज़रूरी जानकारी डाल लेता है, तो वह ड्रॉप-डाउन से उसे चुनता है. इस ऐक्शन से, फ़ॉर्म फ़ील्ड में पते का डेटा अपने-आप भर जाता है.
जगह की जानकारी अपने-आप भरने की सुविधा की मदद से, उपयोगकर्ता को फ़ॉर्म में जानकारी डालने के दो तरीके दिए जा सकते हैं: एक तो पते के सभी फ़ील्ड वाला डिसप्ले और दूसरा एक इनपुट फ़ील्ड वाला डिसप्ले. इस एक इनपुट फ़ील्ड में, उपयोगकर्ता को पता के अलग-अलग कॉम्पोनेंट को अलग-अलग डालने के बजाय, टाइप करते ही खोज शुरू करने के लिए कहा जाता है. ऑटोमैटिक भरने की सुविधा से पता भरने के बाद, वर्कफ़्लो, पते के डेटा के साथ फ़ॉर्म फ़ील्ड को बड़ा कर देता है. इससे ग्राहक, पते की समीक्षा कर सकता है और उसमें बदलाव कर सकता है. उदाहरण के लिए, अपार्टमेंट या यूनिट नंबर जोड़ना.
यहां एक इनपुट फ़ील्ड का इस्तेमाल करके, यह फ़्लो कैसा दिख सकता है, इसका उदाहरण दिया गया है:
दूसरा चरण: पतों की पुष्टि करने के लिए, Address Validation API का इस्तेमाल करना
Google का सुझाव है कि उपयोगकर्ता के पते डालने के बाद, चेकआउट के समय पते की पुष्टि करने वाले एपीआई को कॉल करें. इससे यह पक्का किया जा सकेगा कि पता मान्य और पूरा है. जब उपयोगकर्ता, पते के फ़ॉर्म पर अगला या जारी रखें बटन पर क्लिक करता है, तो पते की पुष्टि करने वाले एपीआई को कॉल ट्रिगर करें. यह बटन अक्सर पेमेंट पेज पर ले जाता है.
Google का सुझाव है कि हर लेन-देन के लिए, Address Validation API को कॉल करें.
यहां दिए गए फ़्लो डायग्राम में, चेकआउट के दौरान पता की पुष्टि करने वाले एपीआई के एंड-टू-एंड इंटिग्रेशन का उदाहरण दिया गया है:
इस दस्तावेज़ में, पते को स्वीकार करने की स्थितियों के बारे में बाद में बताया गया है.
तीसरा चरण: विज़ुअल की मदद से पुष्टि करना
पते की जानकारी डालने के बाद, उपयोगकर्ता को मैप पर डिलीवरी की जगह की जानकारी दिखाकर, विज़ुअल तौर पर पुष्टि करें. इससे खरीदार को यह भरोसा भी बढ़ता है कि पता सही है. साथ ही, डिलीवरी या पिकअप में होने वाली गड़बड़ियों की संख्या भी कम हो जाती है.
मैप को चेकआउट की प्रोसेस के दौरान दिखाया जा सकता है या लेन-देन की पुष्टि करने वाले ईमेल में भेजा जा सकता है. इन दोनों इस्तेमाल के उदाहरणों को, यहां दिए गए एपीआई की मदद से पूरा किया जा सकता है.
Maps JavaScript API, उपयोगकर्ता की जगह की जानकारी दिखाने के लिए इंटरैक्टिव मैप उपलब्ध कराता है. | Maps Static API की मदद से, वेब पेज या ईमेल में बाद में इमेज जोड़ी जा सकती है. |
---|---|
ज़्यादा जानकारी - पते को स्वीकार करने की स्थितियां
पते की पुष्टि करने वाले एपीआई के रिस्पॉन्स को तीन मुख्य स्थितियों में बांटा जा सकता है:
- ठीक करें—पते की क्वालिटी खराब है. आपको ज़्यादा जानकारी के लिए कहना चाहिए.
- पुष्टि करें—पता अच्छी क्वालिटी का है, लेकिन इसमें इनपुट पते से बदलाव किए गए हैं. आपसे पुष्टि करने के लिए कहा जा सकता है.
- स्वीकार करें—पता अच्छी क्वालिटी का है. आपके पास, दिए गए पते को स्वीकार करने का विकल्प है.
इस कॉन्सेप्ट के बारे में, पते की पुष्टि करने वाले एपीआई के दस्तावेज़ों के पुष्टि करने का लॉजिक बनाएं सेक्शन में बताया गया है. हम इस सेक्शन में हर स्थिति के बारे में बात करेंगे.
ठीक करें
इस सेक्शन में, पता डालने में हुई गड़बड़ी को ठीक करने का तरीका बताया गया है. अमान्य पते की जानकारी देने के लिए, Address Validation API से मिलने वाले खास सिग्नल के बारे में जानने के लिए, पुष्टि करने का लॉजिक बनाने से जुड़े दस्तावेज़ में पते को ठीक करना देखें.
अगर पते की पुष्टि करने वाले एपीआई से मिले जवाब में पता अमान्य बताया गया है, तो ग्राहक को पते की जानकारी डालने वाले फ़ॉर्म पर रीडायरेक्ट करें. इससे, डाले गए डेटा की जांच की जा सकेगी. पता ठीक होने के बाद, आपकी सेवा को Address Validation API को फिर से भेजना चाहिए, ताकि यह पक्का किया जा सके कि किए गए सुधार मान्य हैं.
addressComponents
लेवल पर मिले सिग्नल का इस्तेमाल करके, पते की लाइन में मौजूद गड़बड़ियों को हाइलाइट भी किया जा सकता है. इसका उदाहरण, दाईं ओर दिए गए स्क्रीनशॉट में देखा जा सकता है.
पुष्टि करें
इस सेक्शन में, पते की पुष्टि करने का तरीका बताया गया है. पते की पुष्टि करने वाले एपीआई से मिलने वाले खास सिग्नल के बारे में जानकारी पाने के लिए, पुष्टि करने के लॉजिक के दस्तावेज़ में पते की पुष्टि करें देखें.
अक्सर आपका सिस्टम, उपयोगकर्ता से पते की पुष्टि करने के लिए कहेगा. उदाहरण के लिए, अगर कोई ग्राहक शहर का नाम गलत तरीके से लिखता है, तो पते की पुष्टि करने वाले एपीआई की मदद से उस नाम को ठीक किया जा सकता है. आपको खरीदार से इस बात की पुष्टि करनी चाहिए कि समस्या ठीक हो गई है. ऐसा इसलिए है, क्योंकि एपीआई की ओर से किए गए बदलावों से, मूल रूप से डाली गई जानकारी में बदलाव हो सकता है.
ग्राहक को जानकारी दिखाने के लिए, इंटरस्टीशियल मॉडल का इस्तेमाल करें. इससे, आगे बढ़ने के लिए तीन विकल्प मिलेंगे:
- एपीआई से मिले पते की पुष्टि करें. इसके बाद, सही पते का इस्तेमाल करके चेकआउट की प्रोसेस जारी रहेगी.
- पते की पुष्टि करने वाले एपीआई से मिले सुधार को अनदेखा करके, वह पता चुनें जो मूल रूप से डाला गया था. चेकआउट की प्रोसेस सामान्य तरीके से जारी रह सकती है. साथ ही, अगर आपकी प्रोसेस की अनुमति है, तो शिपिंग से पहले ऑर्डर को डाउनस्ट्रीम की समीक्षा के लिए फ़्लैग किया जा सकता है.
- ग्राहक, मॉडल को रद्द कर देता है या उससे बाहर निकल जाता है. इससे वह चेकआउट की प्रोसेस के पते डालने वाले चरण पर वापस आ जाता है. यहां वह फिर से अपना पता डालकर, प्रोसेस को फिर से शुरू कर सकता है.
इसका उदाहरण, दाईं ओर दिए गए स्क्रीनशॉट में देखा जा सकता है.
स्वीकार करें
इस सेक्शन में, किसी पते को स्वीकार करने का तरीका बताया गया है. पते की पुष्टि करने वाले एपीआई से मिलने वाले खास सिग्नल के बारे में जानकारी पाने के लिए, पुष्टि करने के लॉजिक के दस्तावेज़ में पते को स्वीकार करना देखें. इन सिग्नल से पता चलता है कि पते की क्वालिटी अच्छी है और उसे स्वीकार किया जाना चाहिए.
इस स्थिति में, चेकआउट की प्रोसेस अगले चरण पर चली जानी चाहिए. हो सकता है कि यह पेमेंट कैप्चर करने का चरण हो. इस दौरान, खरीदार को पते की क्वालिटी के बारे में कोई प्रॉम्प्ट नहीं दिखेगा. एपीआई ने पुष्टि की है कि ग्राहक ने जो पता डाला है वह अच्छी क्वालिटी का है और डिलीवर किया जा सकता है.
हमारा सुझाव है कि आप ऑर्डर के लिए, पते की पुष्टि करने वाले एपीआई से मिले पते के डेटा का इस्तेमाल करें. ऐसा इसलिए, क्योंकि इसमें छोटे-मोटे सुधार और अतिरिक्त जानकारी शामिल हो सकती है. जैसे:
- अक्षर बड़े करना
- फ़ॉर्मैटिंग में सुधार करना. उदाहरण के लिए,
- Street to St
- पते के कॉम्पोनेंट का सही क्रम
- अमेरिका में पिन कोड के साथ चार अंकों वाली संख्या.
कार्यान्वयन विचार
पते को स्वीकार करने का लॉजिक बनाते समय, पक्का करें कि गलत पता डालने की वजह से, खरीदारों को चेकआउट करने से न रोका जाए. लॉजिक को इस तरह से बनाएं कि अगर एपीआई बार-बार यह बताता है कि एंट्री अमान्य है, तो अनलिमिटेड लूप की संभावना को रोका जा सके.
Google का सुझाव है कि आप खरीदारों को अपना पता डालने के लिए दो मौके दें. साथ ही, दूसरे मौके पर, उनके डाले गए पते को स्वीकार कर लें, भले ही वह पुष्टि न हो पाए. दूसरे प्रयास में, पुष्टि किए बिना भी उन्हें आगे बढ़ने की अनुमति दी जाती है.
दूसरा अनुरोध स्वीकार करने के लिए, ये दो तरीके सुझाए गए हैं:
- मज़बूरी से आगे बढ़ना: ग्राहक को एक मॉडल दिखाएं, जिसमें बताया गया हो कि पते की पुष्टि नहीं हो पा रही है. हालांकि, टाइप किए गए पते का इस्तेमाल करके आगे बढ़ने का विकल्प दें.
- बिना पुष्टि के स्वीकार करना: पुष्टि करने के चरण के बिना, दूसरे प्रयास को अपने-आप स्वीकार करना. भले ही, पते की पूरी तरह से पुष्टि न हुई हो.
अगर हो सके, तो अपने सिस्टम को ऐसे पतों को फ़्लैग करने के लिए डिज़ाइन करें जिनकी पुष्टि नहीं हुई है. इससे ऑर्डर शिप होने से पहले, ग्राहक सेवा प्रतिनिधि उनकी समीक्षा कर सकता है. इस अतिरिक्त तरीके से, आपको किसी भी तरह की गड़बड़ी का पता चलता है.
नई इमारत बनाने के लिए, यह जांच क्यों ज़रूरी है, इसकी जानकारी यहां दी गई है. नई इमारत का निर्माण पूरा होने और डाक पते के डेटाबेस में उस इमारत का पता भरने के बीच में समय लग सकता है. खरीदारों के पास, टाइप किए गए पते के साथ चेकआउट पेज पर जाने का विकल्प होना चाहिए. भले ही, पते की पुष्टि न हो.
चेकआउट सेशन पूरा होने के बाद, किसी पते की पुष्टि करने की कोशिश के बारे में Google को सुझाव/राय देने के लिए, provideValidationFeedback
के तरीके का इस्तेमाल करें. हालांकि, ऐसा करना ज़रूरी नहीं है.
नतीजा
इस दस्तावेज़ में, चेकआउट फ़्लो के बारे में खास जानकारी दी गई है. इसमें, Google Map पर ऑटोमैटिक भरने की सुविधा, पते की पुष्टि, और विज़ुअल पुष्टि की सुविधा को लागू करने के बारे में बताया गया है. इस दस्तावेज़ को शुरुआती पॉइंट के तौर पर इस्तेमाल करें. साथ ही, पते डालने के लिए सुझाए गए फ़्लो का पालन करें.
अगले चरण
भरोसेमंद पतों की मदद से चेकआउट, डिलीवरी, और ऑपरेशंस को बेहतर बनाएं व्हाइट पेपर डाउनलोड करें और पते की पुष्टि करने की सुविधा की मदद से चेकआउट, डिलीवरी, और ऑपरेशंस को बेहतर बनाएं वेबिनार देखें.
इसके बारे में और पढ़ने के लिए:
- जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा से जुड़ा दस्तावेज़
- Address Validation API का दस्तावेज़
- Google Maps Platform की रिपोर्टिंग
योगदानकर्ता
हेनरिक वाल्व | समाधान इंजीनियर
थॉमस एंगलरेट | समाधान इंजीनियर
सार्थक गंगुली | समाधान इंजीनियर
-
United States Postal Service का नॉन-एक्सक्लूज़िव लाइसेंसी. यहां दिए गए ट्रेडमार्क का मालिकाना हक, United States Postal Service® के पास है. इनका इस्तेमाल, अनुमति मिलने पर ही किया जाता है: CASS™, USPS®, DPV®. ↩