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

मकसद

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

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

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

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

अभी आज़माएं: Google Cloud Console पर जाएं और पते की पुष्टि करने वाला एपीआई चालू करें.

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

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

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

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

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

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

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

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

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

चरण 1: पता दर्ज करने का फ़्लो - स्थान ऑटोकंप्लीट सेवा का इस्तेमाल करना

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

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

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

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

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

दूसरा चरण: पतों की पुष्टि करने के लिए, पते की पुष्टि करने वाले एपीआई का इस्तेमाल करना

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

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

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

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

तीसरा चरण: विज़ुअल की पुष्टि करना

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

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

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

ध्यान दें: डाले गए पते की जगह दिखाने के लिए, Address Validation API से मिले जियोकोड का इस्तेमाल करें.

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

पता की पुष्टि करने वाले एपीआई के जवाबों को तीन मुख्य स्थितियों में रखा जा सकता है:

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

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

सलाह: यह लॉजिक, एक्सटेंडेड कॉम्पोनेंट लाइब्रेरी में, ओपन सोर्स वेब कॉम्पोनेंट के तौर पर भी उपलब्ध है.

ठीक करें

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

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

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

---

पुष्टि करें

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

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

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

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

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

---

स्वीकार करें

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

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

हमारा सुझाव है कि आप पते की पुष्टि करने वाले एपीआई से मिले पते के डेटा को ऑर्डर के सामने इस्तेमाल करें, क्योंकि इसमें कुछ मामूली सुधार किए जा सकते हैं और कुछ नई चीज़ें जोड़ी जा सकती हैं. जैसे:

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

सलाह: पेमेंट कैप्चर पेज पर, खरीदार को पता दिखाना न भूलें. भले ही, उस पर ध्यान न दिया गया हो.

---

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

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

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

दूसरी कोशिश को स्वीकार करने के लिए, सुझाए गए दो तरीके:

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

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

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

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

नतीजा

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

अगले चरण

भरोसेमंद पतों की मदद से चेकआउट, डिलीवरी, और कार्रवाइयों को बेहतर बनाएं व्हाइटपेपर डाउनलोड करें. इसके बाद, पते की पुष्टि करने की सुविधा की मदद से चेकआउट, डिलीवरी, और कार्रवाइयों को बेहतर बनाने का वेबिनार देखें.

इसके बारे में और पढ़ने के लिए:

• जगह के बारे में अपने-आप पूरा होने वाला दस्तावेज़
• Address Validation API का दस्तावेज़
• Google Maps Platform की रिपोर्टिंग

योगदानकर्ता

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

---

1. United States Postal Service का नॉन-एक्सक्लूज़िव लाइसेंसी. नीचे दिए गए ट्रेडमार्क का मालिकाना हक United States Postal Service® के पास है. इनका इस्तेमाल अनुमति के साथ किया जाता है: CASSTM, USPS®, DPV®. ↩