कस्टम विज़िटर आईडी (एम्बेडेड फ़ॉर्म)

जब आप अपने स्वयं के ऐप के अंदर NueForm एम्बेड करते हैं, तो आप आमतौर पर पहले से जानते हैं कि उपयोगकर्ता कौन है — उनका आपके सिस्टम में एक खाता है, आपके पास एक आंतरिक उपयोगकर्ता आईडी है, और आप चाहेंगे कि हर बार जब वे फ़ॉर्म खोलें तो वह उनके पिछले उत्तरों को चुपचाप पुनर्स्थापित कर दे। आपको NueForm की कुकीज़, ब्राउज़र स्टोरेज, या आपके रेस्पॉन्डेंट को «जारी रखें या नए सिरे से शुरू करें?» जैसा प्रॉम्प्ट दिखाने का प्रबंधन नहीं करना पड़े।

nf_visitor URL पैरामीटर इसे संभालता है। फ़ॉर्म के पुनरारंभ की अनुमति दें + ऑटो-रिज़्यूम सेटिंग्स के साथ मिलकर, आपके अंतिम उपयोगकर्ता केवल फ़ॉर्म देखते हैं — कभी भी NueForm का रिज़्यूम UI नहीं।

त्वरित उदाहरण

text

https://nueform.io/f/your-form-slug?nf_visitor=user-12345

यदि user-12345 के लिए कोई आंशिक प्रतिक्रिया मौजूद है, तो फ़ॉर्म उसे चुपचाप पुनर्स्थापित कर देता है। यदि नहीं, तो फ़ॉर्म नए सिरे से शुरू होता है। उपयोगकर्ता कभी कोई मॉडल नहीं देखता, कभी «जारी रखें या नए सिरे से शुरू करें» नहीं चुनता, और यह तक नहीं जानता कि कोई रिज़्यूम मैकेनिज़्म है।

किसी उपयोगकर्ता को «रीसेट» करने के लिए (उन्हें नई शुरुआत देने के लिए), एक नया nf_visitor मान चुनें:

text

https://nueform.io/f/your-form-slug?nf_visitor=user-12345-attempt-2

पहचान ट्रैकिंग आपकी ज़िम्मेदारी है — वह योजना चुनें जो आपके ऐप के अनुकूल हो।

सेटअप चेकलिस्ट

NueForm बिल्डर में अपना फ़ॉर्म खोलें।
पुनरारंभ की अनुमति दें अनुभाग का विस्तार करें।
उत्तरदाताओं को वहीं से फिर से शुरू करने दें जहाँ उन्होंने छोड़ा था चालू करें।
नया ऑटो-रिज़्यूम चाइल्ड टॉगल चालू करें।
ऊपर दिए गए URL पैटर्न का उपयोग करके फ़ॉर्म एम्बेड करें, अपना स्वयं का nf_visitor मान प्रदान करें।

बस इतना ही।

यह कैसे काम करता है

nf_visitor को रेस्पॉन्डेंट पेज द्वारा हर लोड पर पढ़ा जाता है।
यह कुकी-आधारित विज़िटर आईडी को बदल देता है जिसका NueForm आमतौर पर रिज़्यूम और डीडुप के लिए उपयोग करता है।
जब nf_visitor मौजूद हो तो localStorage में कुछ नहीं लिखा जाता — आपका मान सत्य का स्रोत है, और रेस्पॉन्डेंट का ब्राउज़र साफ़ रहता है।
सबमिशन, आंशिक सेव और रिज़्यूम लुक-अप सभी आपके मान के आधार पर होते हैं।
फ़ॉर्म-वेरिएबल प्रतिस्थापन चलने से पहले पैरामीटर को urlVariables से हटा दिया जाता है, इसलिए यह कभी भी छिपे फ़ील्ड, वेबहुक पेलोड, या एनालिटिक्स ट्रैफ़िक-स्रोत डिटेक्शन में लीक नहीं होता।

मान्यता नियम

मान आवश्यक है:

1–256 वर्ण लंबा हो
[A-Za-z0-9_\-:.@]+ से मेल खाए — अक्षर, अंक, अंडरस्कोर, हाइफ़न, कोलन, पीरियड और @

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

`nf_visitor` कब अनदेखा किया जाता है

nf_visitor को पूरी तरह से अनदेखा कर दिया जाता है जब फ़ॉर्म पर रेस्पॉन्डेंट लॉगिन आवश्यक है चालू हो।

ये दो सुविधाएँ परस्पर अनन्य हैं — आप दोनों नहीं रख सकते। यदि रेस्पॉन्डेंट लॉगिन आवश्यक है चालू है, तो NueForm रेस्पॉन्डेंट की प्रमाणित पहचान (Auth0 सत्र) का उपयोग करता है और URL पैरामीटर को ऐसे माना जाता है जैसे यह कभी प्रदान ही नहीं किया गया था। सब कुछ स्वाभाविक रूप से एक सामान्य लॉग्ड-इन फ़ॉर्म लोड के रूप में प्रवाहित होता है।

यदि आपको एक ही फ़ॉर्म पर दोनों व्यवहार चाहिए, तो आपको चुनना होगा — वे मूलभूत रूप से अलग प्रश्नों का उत्तर देते हैं:

रेस्पॉन्डेंट लॉगिन आवश्यक है कहता है: «मुझे एक सत्यापित पहचान चाहिए जिस पर मैं हर सबमिशन में भरोसा कर सकूँ।»
nf_visitor कहता है: «मैं स्वयं पहचान की ज़मानत लूँगा, कृपया इस ओपेक आईडी का उपयोग करें।»

दोनों को फ़ॉर्म स्तर पर समाधान नहीं किया जा सकता। यदि आपको एम्बेडेड परिदृश्य के अंदर सत्यापित पहचान चाहिए, तो रेस्पॉन्डेंट लॉगिन आवश्यक है का उपयोग करें और अपने उपयोगकर्ताओं को सीधे NueForm में साइन इन करने दें।

ऑटो-रिज़्यूम के साथ संयोजन

ऑटो-रिज़्यूम वह सुविधा है जो एम्बेडेड परिदृश्यों में nf_visitor को चमकदार बनाती है। दोनों चालू होने पर:

लौटने वाले उपयोगकर्ता तुरंत अपनी पहले से दर्ज की गई प्रतिक्रियाएँ देखते हैं। कोई प्रॉम्प्ट नहीं, कोई विकल्प नहीं।
नए उपयोगकर्ता (नया nf_visitor मान) एक खाली फ़ॉर्म देखते हैं।
«सबमिट करने के बाद केवल पढ़ने योग्य» का सम्मान किया जाता है — एक बार जब उपयोगकर्ता ने सबमिट कर दिया, तो उसी nf_visitor के साथ बाद के लोड्स पूर्ण किए गए केवल पढ़ने योग्य दृश्य दिखाते हैं, जो एक एम्बेडेड रिकॉर्ड/रसीद परिदृश्य के लिए बिल्कुल वही है जो आप चाहते हैं।

ऑटो-रिज़्यूम के बिना, लौटने वाले उपयोगकर्ता अभी भी NueForm का «जारी रखें या नए सिरे से शुरू करें?» मॉडल देखेंगे भले ही आपने पहचान प्रदान की हो — एम्बेडेड उपयोग मामलों के लिए एक UX समस्या। ऑटो-रिज़्यूम इसे हटा देता है।

गोपनीयता नोट्स

nf_visitor NueForm के डेटाबेस में प्रतिक्रिया के लिए प्राथमिक लुकअप कुंजी बन जाता है। ऐसे मान चुनें जिन्हें आप नियंत्रित करते हैं और जो असंबंधित उपयोगकर्ताओं के बीच टकराव न करें।
मान में ऐसी PII न डालें जिसे आप NueForm में संग्रहीत नहीं करना चाहते (उदाहरण के लिए, यदि आप ओपेक आईडी का उपयोग कर सकते हैं तो कच्चे ईमेल पते पास न करें)। मान प्रतिक्रिया के लिए वेबहुक पेलोड + एनालिटिक्स में जाता है।
मान URL वाले किसी भी व्यक्ति को दिखाई देता है — इसे किसी अन्य URL टोकन की तरह मानें। यदि आपका एम्बेडेड परिदृश्य उपयोगकर्ता को URL बार दिखाता है, तो अनुमान लगाने योग्य चीज़ के बजाय एक ओपेक आईडी पर विचार करें।

छिपे हुए फ़ील्ड के साथ संयोजन

अन्य URL पैरामीटर अभी भी nf_visitor के साथ-साथ फ़ॉर्म वेरिएबल के रूप में काम करते हैं। उदाहरण के लिए:

text

https://nueform.io/f/your-form-slug?nf_visitor=user-12345&plan=premium&source=upgrade-flow

plan और source मानक छिपे फ़ील्ड व्यवहार के अनुसार प्रश्न शीर्षकों, लॉजिक जंप आदि में वेरिएबल इंटरपोलेशन के लिए उपलब्ध हैं। केवल nf_visitor आरक्षित है।