कैंपेन का मकसद
इस दस्तावेज़ में, ई-कॉमर्स चेकआउट में जगह की जानकारी अपने-आप पूरी होने की सुविधा, पते की पुष्टि करने वाला एपीआई1, और Maps को एक साथ जोड़ने के तरीके बताए गए हैं. इससे, अच्छी क्वालिटी के पतों को कैप्चर करने में मदद मिलती है.
ज़रूरी शर्तें
Google का सुझाव है कि आप इन चीज़ों के बारे में जानें:
- प्लेस ऑटोकंप्लीट JavaScript डेवलपर दस्तावेज़.
- तकनीकी नज़रिए से समझें कि जगह की जानकारी अपने-आप पूरी होने की सुविधा कैसे काम करती है और इसे लागू करने के विकल्प कैसे काम करते हैं.
- चेकआउट को लागू करने के लिए 'जगह की जानकारी अपने-आप पूरा होने की सुविधा' के लिए गाइड.
- ई-कॉमर्स चेकआउट पर, 'जगह की जानकारी अपने-आप पूरी होने वाली सुविधा' लागू करने के सबसे सही तरीकों के उदाहरण.
- पते की पुष्टि करने वाला एपीआई प्रॉडक्ट का दस्तावेज़. इसमें, पुष्टि करने वाला लॉजिक बनाने पर फ़ोकस किया गया है.
- पते की पुष्टि करने वाले एपीआई के काम करने के तरीके को तकनीकी नज़रिए से समझें और पते की क्वालिटी तय करने वाले सिग्नल की समीक्षा करें.
पते की पुष्टि क्या है?
पते की पुष्टि करने वाला एपीआई एक ऐसी सेवा है जो पते की पुष्टि करती है. यह पते के कॉम्पोनेंट की पहचान करता है और उनकी पुष्टि करता है. यह डाक के पते का भी मानक तय करता है और इसके लिए सबसे अच्छे अक्षांश/देशांतर निर्देशांक ढूंढता है. इसके अलावा, अमेरिका और प्योर्तो रिको में मौजूद पतों के लिए, कोडिंग सटीक सपोर्ट सिस्टम (CASSTM) को चालू किया जा सकता है.आपको चेकआउट के समय, पते की पुष्टि करने की ज़रूरत क्यों है?
ऑर्डर करने की प्रोसेस के दौरान सटीक पते इकट्ठा करें:
यह सही तरीके से डिलीवरी को बढ़ावा देने, समय पर ऑर्डर पूरा करने को बढ़ावा देने, और पते में सुधार करने वाले महंगे शुल्क को कम करने के लिए ज़रूरी है.
कारोबार का पता तुरंत और सही तरीके से डालने के लिए ग्राहकों को गाइड करें:
जगह की जानकारी अपने-आप पूरी होने की सुविधा से, पता डालने की प्रोसेस में तेज़ी आती है और इनपुट की गलतियां कम होती हैं. इससे ग्राहक आसानी से चेकआउट कर पाते हैं. पते की पुष्टि करने की सुविधा से, पते की क्वालिटी के बारे में सुझाव या राय मिलती है. इसमें स्टैंडर्ड के हिसाब से और स्पेलिंग की गलतियों जैसे सुधार किए जाते हैं. साथ ही, मेटाडेटा को बेहतर बनाया जाता है, जैसे कि रिहायशी या व्यावसायिक इंडिकेटर (यह सुविधा चुनिंदा इलाकों में उपलब्ध है).
लागू करने से जुड़ी खास जानकारी
इस सेक्शन में ई-कॉमर्स चेकआउट के लिए, सुझाया गया पता डालने के वर्कफ़्लो के बारे में बताया गया है. इस प्रोसेस में तीन चरण हैं:
- शुरुआत में पता कैप्चर करने के लिए, 'जगह की जानकारी अपने-आप भर जाने वाली सुविधा' का इस्तेमाल करें.
- डाले गए पते की पुष्टि करने के लिए, पते की पुष्टि करने वाले एपीआई का इस्तेमाल करें.
- ग्राहकों को डिलीवरी का भरोसा देने के लिए, मैप पर कारोबार के डाले गए पते की जगह दिखाएं.
इसके बाद, हम हर चरण की अलग-अलग जांच करेंगे.
चरण 1: पता डालने का फ़्लो - जगह के अपने-आप पूरे होने की सुविधा का इस्तेमाल करके
पता एंट्री फ़ॉर्म की पहली लाइन पर JavaScript API का इस्तेमाल करके जगह ऑटोकंप्लीट को लागू करें.
'जगह की जानकारी ऑटोकंप्लीट' की सुविधा, ग्राहक को पते की जानकारी डालते ही सुझाव देती है. JavaScript API का इस्तेमाल करके लागू किए जाने पर, जैसे ही उपयोगकर्ता लिखना शुरू करते हैं, पता डालने वाले फ़ॉर्म फ़ील्ड के नीचे एक ड्रॉप-डाउन दिखता है. इसमें, ऑटोकंप्लीट सेवा से मिलने वाले ऐसे नतीजे दिखते हैं जो हर कीस्ट्रोक पर अपडेट होते हैं. पता ढूंढने के लिए ज़रूरी जानकारी डालने के बाद, उपयोगकर्ता उसे ड्रॉप-डाउन से चुनें. यह कार्रवाई से, फ़ॉर्म फ़ील्ड में पते का डेटा अपने-आप भर जाता है.
जगह के अपने-आप पूरे होने की सुविधा की मदद से, उपयोगकर्ता को फ़ॉर्म एंट्री के लिए दो स्टाइल दिए जा सकते हैं: सभी पते के फ़ील्ड वाला डिसप्ले या एक इनपुट फ़ील्ड वाला डिसप्ले. यह एक इनपुट फ़ील्ड, पते के कॉम्पोनेंट को अलग-अलग डालने के बजाय, उपयोगकर्ता को टाइप करते ही खोज शुरू करने का प्रॉम्प्ट देता है. जब पता ऑटोकंप्लीट कर दिया जाता है, तो वर्कफ़्लो, फ़ॉर्म फ़ील्ड को पते के डेटा के साथ बड़ा कर देता है. इससे ग्राहक, समीक्षा करके उसमें बदलाव कर सकता है. जैसे, अपार्टमेंट या यूनिट नंबर जोड़ना.
यहां एक उदाहरण देकर बताया गया है कि एक इनपुट फ़ील्ड का इस्तेमाल करके यह फ़्लो कैसा दिख सकता है:
दूसरा चरण: पतों की पुष्टि करने के लिए, पते की पुष्टि करने वाले एपीआई का इस्तेमाल करना
Google का सुझाव है कि उपयोगकर्ता के पता डालने के बाद, आप चेकआउट के समय पते की पुष्टि करने वाले एपीआई को कॉल करें, ताकि इस बात की पुष्टि की जा सके कि पता मान्य और पूरा है. जब उपयोगकर्ता पते के फ़ॉर्म में 'आगे बढ़ें' या 'जारी रखें' बटन पर क्लिक करता है, तब पते की पुष्टि करने वाले एपीआई के लिए कॉल ट्रिगर किया जा सकता है. यह बटन अक्सर पेमेंट पेज पर ले जाता है.
Google, हर लेन-देन के लिए पते की पुष्टि करने वाले एपीआई को कॉल करने का सुझाव देता है.
इस फ़्लो डायग्राम में, चेकआउट के दौरान अड्रेस वैलिडिटी एपीआई के शुरू से आखिर तक इंटिग्रेशन का उदाहरण दिखाया गया है:
इस दस्तावेज़ में बाद में पता स्वीकार करने की स्थितियों के बारे में बताया गया है.
तीसरा चरण: विज़ुअल तौर पर पुष्टि करें
पता डालने के बाद, डिलीवरी की जगह की जानकारी मैप पर दिखाकर, उसकी पुष्टि उपयोगकर्ता को दिखाएं. इससे ग्राहक को ज़्यादा भरोसा मिलता है कि पता सही है. साथ ही, इससे डिलीवरी या पिकअप में होने वाली गड़बड़ियां कम होती हैं.
मैप को चेकआउट प्रोसेस के दौरान दिखाया जा सकता है या लेन-देन की पुष्टि करने वाले ईमेल के अंदर भेजा जा सकता है. इस्तेमाल के इन दोनों उदाहरणों को यहां दिए गए एपीआई की मदद से पूरा किया जा सकता है.
Maps JavaScript API उपयोगकर्ता की जगह की जानकारी दिखाने के लिए एक इंटरैक्टिव मैप की सुविधा देता है. | Maps स्टैटिक एपीआई की मदद से, वेब पेज में या ईमेल में इमेज को जोड़ा जा सकता है. |
---|---|
डीप डाइव - स्वीकार करने की स्थितियों से जुड़ी समस्याएं हल करना
पते की पुष्टि करने वाले एपीआई के जवाबों को तीन मुख्य स्थितियों में बांटा जा सकता है:
- ठीक करें—पते की क्वालिटी खराब है. आपको ज़्यादा जानकारी के लिए अनुरोध करना चाहिए.
- पुष्टि करें—पता अच्छी क्वालिटी का है, लेकिन इसमें इनपुट के पते में बदलाव किए गए हैं. आपको पुष्टि करने के लिए कहा जा सकता है.
- स्वीकार करें—पता अच्छी क्वालिटी का है. दिया गया पता स्वीकार किया जा सकता है.
इस सिद्धांत के बारे में जानकारी की पुष्टि वाले एपीआई दस्तावेज़ के पुष्टि करने का लॉजिक बनाएं सेक्शन में बताया गया है. साथ ही, हम इस सेक्शन में हर स्थिति पर चर्चा करेंगे.
समाधान
इस सेक्शन में, पते के इनपुट को ठीक करने का तरीका बताया गया है. पते की पुष्टि करने वाला एपीआई, खराब क्वालिटी वाले पते दिखाने के लिए जो खास सिग्नल दिखाता है उनके बारे में जानने के लिए, 'पुष्टि करने वाला लॉजिक बनाएं' दस्तावेज़ में मौजूद पता ठीक करें देखें.
अगर पते की पुष्टि करने वाले एपीआई से मिला जवाब अमान्य पता दिखाता है, तो ग्राहक का डाला गया डेटा देखने के लिए उसे पता एंट्री फ़ॉर्म पर रीडायरेक्ट करें. पता ठीक हो जाने के बाद, आपकी सेवा पते की पुष्टि करने वाले एपीआई को फिर से भेजी जानी चाहिए, ताकि यह पक्का किया जा सके कि किए गए सुधार सही हैं.
addressComponents
लेवल पर दिखाए गए सिग्नल का इस्तेमाल करके भी, ऐड्रेस लाइन की खास गड़बड़ियों को हाइलाइट किया जा सकता है. इसका उदाहरण दाईं ओर दिए गए स्क्रीनशॉट में देखा जा सकता है.
पुष्टि करें
इस सेक्शन में पते की पुष्टि करने का तरीका बताया गया है. ऐसे खास सिग्नल के बारे में जानकारी पाने के लिए जो पते की पुष्टि करने वाला एपीआई दिखाता है, जिससे पता चलता है कि पते की पुष्टि करनी है, 'अपने पुष्टि करने वाले लॉजिक' दस्तावेज़ में पते की पुष्टि करें देखें.
अक्सर आपका सिस्टम किसी उपयोगकर्ता से पते की पुष्टि करने का अनुरोध करना चाहेगा. उदाहरण के लिए, कोई ग्राहक शहर के नाम की गलत स्पेलिंग लिखता है, जिसे पते की पुष्टि करने वाले एपीआई से ठीक किया जाएगा. इस समस्या को ठीक करने के लिए, आपको ग्राहक से बात करनी चाहिए. ऐसा इसलिए है, क्योंकि एपीआई में किए गए बदलावों से मूल रूप से उसकी वैल्यू बदल सकती है.
ग्राहक को जानकारी दिखाने के लिए पेज पर अचानक दिखने वाले मॉडल का इस्तेमाल करें. इससे आगे बढ़ने के लिए तीन विकल्प मिलेंगे:
- एपीआई से मिले पते की पुष्टि करें और सही किए गए पते का इस्तेमाल करके चेकआउट की प्रोसेस जारी रहती है.
- पता की पुष्टि वाले एपीआई में किए गए सुधार को अनदेखा करते हुए, वही पता चुनें जो आपने पहले डाला था. चेकआउट की प्रोसेस सामान्य तरीके से जारी रह सकती है. साथ ही, अगर आपकी प्रोसेस अनुमति देती है, तो ऑर्डर को शिपिंग से पहले डाउनस्ट्रीम समीक्षा के लिए फ़्लैग किया जा सकता है.
- ग्राहक, मॉडल को रद्द कर देता है या उससे पीछे हट जाता है और उसे चेकआउट प्रोसेस के पते पर पहुंचने वाले चरण पर वापस भेज देता है, जहां वह प्रोसेस को फिर से शुरू करके, पते की जानकारी फिर से डाल सकता है.
इसका एक उदाहरण दाईं ओर दिए गए स्क्रीनशॉट में देखा जा सकता है.
स्वीकार करें
इस सेक्शन में पते को स्वीकार करने का तरीका बताया गया है. ऐसे खास सिग्नल के बारे में जानकारी पाने के लिए जो पते की पुष्टि करने वाला एपीआई दिखाता है, जिससे पता चलता है कि कोई पता अच्छी क्वालिटी का है और इसे स्वीकार किया जाना चाहिए, 'अपने पुष्टि करने वाले लॉजिक' दस्तावेज़ में पते को स्वीकार करना देखें.
ऐसी स्थिति में, चेकआउट की प्रोसेस अगले चरण पर होनी चाहिए. इससे पेमेंट मिलने की संभावना हो सकती है. साथ ही, क्वालिटी के बारे में ग्राहक को कोई संकेत नहीं देना चाहिए. एपीआई ने पुष्टि की है कि ग्राहक ने जो पता डाला है वह अच्छी क्वालिटी का है और डिलीवर किया जा सकता है.
हमारा सुझाव है कि आप ऑर्डर के लिए, पते की पुष्टि करने वाले एपीआई से मिले पते का डेटा इस्तेमाल करें. इसमें कुछ सुधार हो सकते हैं और कुछ चीज़ें जोड़ी जा सकती हैं, जैसे कि:
- कैपिटल लेटर का इस्तेमाल
- फ़ॉर्मैट में सुधार करना, उदाहरण के लिए
- सड़क से लेकर सेंट तक
- पते के कॉम्पोनेंट का सही क्रम
- ZIP+4 इस्तेमाल करें.
कार्यान्वयन विचार
पता स्वीकार करने का लॉजिक बनाते समय, पक्का करें कि लागू की गई प्रोसेस, किसी अमान्य पता डालने की वजह से खरीदारों को चेक आउट करने से न रोकती हो. लॉजिक को इस तरह से बनाएं जिससे अगर एपीआई बार-बार यह दिखाता है कि उसकी एंट्री अमान्य है, तो इनफ़ाइनाइट लूप की संभावना को रोका जा सकता है.
Google सुझाव देता है कि आप ग्राहकों को पता डालने के लिए, ज़्यादा से ज़्यादा दो मौके दें. साथ ही, दूसरी कोशिश में उनकी एंट्री स्वीकार करें, भले ही उसकी पुष्टि न हुई हो. दूसरे प्रयास में, उनका लक्ष्य यह होता है कि पुष्टि की प्रक्रिया पर ध्यान दिए बिना उन्हें आगे बढ़ने दिया जाए.
दूसरी कोशिश को स्वीकार करने के लिए सुझाए गए दो तरीके:
- हमेशा आगे बढ़ें: ग्राहक को दिखाएं कि पते की पुष्टि नहीं हो रही है. हालांकि, यह विकल्प दें कि वह दिए गए पते की पुष्टि कर सके.
- बिना पुष्टि के पुष्टि: पुष्टि के चरण के बिना, दूसरी बार कोशिश करने पर अपने-आप स्वीकार करें. भले ही, पते की पूरी तरह से पुष्टि न हुई हो.
अगर हो सके, तो अपने सिस्टम को उन पतों को फ़्लैग करने के लिए डिज़ाइन करें जिनकी पुष्टि नहीं हुई है, ताकि ऑर्डर भेजने से पहले ग्राहक सेवा प्रतिनिधि उन पतों की समीक्षा कर सके. इससे यह पक्का हो जाता है कि आप गलतियों का पता लगा लें.
नई बिल्डिंग बनाने से इस बात का अच्छा उदाहरण मिलता है कि इस जांच की सलाह क्यों दी जाती है. नई इमारत बनाने का काम पूरा होने और उस इमारत के पते की जानकारी, डाक पते के डेटाबेस में जमा होने के बाद भी अंतर हो सकता है. खरीदारों के पास चेकआउट पेज पर, टाइप किए गए पते का इस्तेमाल करके ज़बरदस्ती आगे बढ़ने का विकल्प होना चाहिए. भले ही, वह पता पुष्टि न करता हो.
चेकआउट सेशन पूरा होने के बाद, provideValidationFeedback
तरीके का इस्तेमाल करके, Google को पते की पुष्टि करने की किसी खास कोशिश के बारे में सुझाव भेजें.
नतीजा
इस दस्तावेज़ में चेकआउट फ़्लो की खास जानकारी दी गई है. यह जानकारी, Google Maps पर अपने-आप पूरा होने, पते की पुष्टि करने, और विज़ुअल की मदद से पुष्टि करने की सुविधा को लागू करने के लिए दी गई है. सुझाए गए पता एंट्री फ़्लो के मुताबिक, लागू करने के तरीके को डिज़ाइन करने के लिए, इस दस्तावेज़ का इस्तेमाल शुरुआत की जगह के तौर पर करें.
अगले चरण
भरोसेमंद पतों की मदद से चेकआउट, डिलीवरी, और कार्रवाइयों को बेहतर बनाएं व्हाइटपेपर डाउनलोड करें और पते की पुष्टि करने की सुविधा की मदद से, चेकआउट, डिलीवरी, और कार्रवाइयों को बेहतर बनाना वेबिनार देखें.
आगे पढ़ने का सुझाव:
- जगह के ऑटोकंप्लीट दस्तावेज़
- पते की पुष्टि करने वाले एपीआई से जुड़े दस्तावेज़
- Google Maps Platform रिपोर्टिंग
योगदानकर्ता
हेनरिक वाल्व | सॉल्यूशन इंजीनियर
थॉमस एंगलरेट | सलूशन इंजीनियर
सरथक गांगुली | सलूशन इंजीनियर
-
अमेरिका की पोस्टल सर्विस का लाइसेंस रखने वाला व्यक्ति, जिसके पास खास अधिकार नहीं है. इन ट्रेडमार्क का मालिकाना हक संयुक्त राज्य अमेरिका की पोस्टल सर्विस® के पास है और इनका इस्तेमाल अनुमति के साथ किया जाता है: CASSTM, USPS®, DPV®. ↩