عندما تضمّن نموذج NueForm داخل تطبيقك الخاص، فأنت عادةً تعرف بالفعل من هو المستخدم — لديه حساب في نظامك، ولديك معرّف مستخدم داخلي، وتودّ أن يستعيد النموذج إجاباته السابقة بصمت في كل مرة يفتحه فيها. وذلك دون الحاجة إلى إدارة ملفات تعريف الارتباط (cookies) الخاصة بـ NueForm، أو تخزين المتصفح، أو أن يرى مستجيبوك مطالبة «المتابعة أم البدء من جديد؟».
يتولى معامل URL nf_visitor ذلك. وعند اقترانه بإعدادَي السماح بالاستئناف + الاستئناف التلقائي، لا يرى المستخدمون النهائيون سوى النموذج — ولا يرون أبداً واجهة الاستئناف الخاصة بـ NueForm.
مثال سريع
https://nueform.io/f/your-form-slug?nf_visitor=user-12345
إذا كانت هناك إجابة جزئية للمستخدم user-12345، فإن النموذج يستعيدها بصمت. وإن لم تكن موجودة، يبدأ النموذج جديداً. لا يرى المستخدم أبداً نافذة منبثقة، ولا يختار «المتابعة أم البدء من جديد»، ولا يعرف حتى أن آلية استئناف موجودة أصلاً.
لـ«إعادة تعيين» مستخدم (إعطاؤه بداية جديدة)، اختر قيمة nf_visitor جديدة:
https://nueform.io/f/your-form-slug?nf_visitor=user-12345-attempt-2
تتبّع الهوية مسؤوليتك — اختر النظام الذي يناسب تطبيقك.
قائمة الإعداد
- افتح نموذجك في منشئ NueForm.
- وسّع قسم السماح بالاستئناف.
- فعّل السماح للمستجيبين بالاستئناف من حيث توقفوا.
- فعّل المفتاح الفرعي الجديد الاستئناف التلقائي.
- ضمّن النموذج باستخدام نمط URL أعلاه، مع توفير قيمة
nf_visitorالخاصة بك.
هذا كل شيء.
كيف يعمل
- يُقرأ
nf_visitorبواسطة صفحة المستجيب في كل تحميل. - يحلّ محلّ معرّف الزائر المعتمد على ملفات تعريف الارتباط الذي يستخدمه NueForm عادةً للاستئناف وإزالة التكرار.
- لا يُكتب أي شيء في
localStorageعند وجودnf_visitor— قيمتك هي مصدر الحقيقة، ويبقى متصفح المستجيب نظيفاً. - تستند عمليات الإرسال والحفظ الجزئي وعمليات البحث للاستئناف إلى قيمتك.
- يُستبعَد المعامل من
urlVariablesقبل تشغيل استبدال متغيرات النموذج، فلا يتسرّب أبداً إلى الحقول المخفية أو حمولات webhook أو اكتشاف مصدر حركة المرور في التحليلات.
قواعد التحقّق
يجب أن تكون القيمة:
- بطول من 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 حتى مع توفيرك للهوية — وهو خلل في تجربة المستخدم لحالات الاستخدام المضمّنة. الاستئناف التلقائي يزيله.
ملاحظات الخصوصية
- يصبح
nf_visitorالمفتاح الأساسي للبحث عن الإجابة في قاعدة بيانات NueForm. اختر قيماً تتحكم فيها ولا تتعارض بين مستخدمين غير مرتبطين. - لا تضع في القيمة معلومات تعريف شخصية (PII) لا تريد تخزينها في NueForm (على سبيل المثال، لا تمرّر عناوين بريد إلكتروني خام إن أمكن استخدام معرّف مُعَتَّم بدلاً منها). تنتقل القيمة إلى حمولات webhook والتحليلات الخاصة بالإجابة.
- القيمة مرئية لأي شخص لديه عنوان URL — تعامَل معها كأي رمز URL آخر. إذا كان السيناريو المضمّن يُظهر شريط عنوان URL للمستخدم، ففكّر في معرّف مُعَتَّم بدلاً من شيء يمكن تخمينه.
الدمج مع الحقول المخفية
تستمر معاملات URL الأخرى في العمل كمتغيرات للنموذج جنباً إلى جنب مع nf_visitor. على سبيل المثال:
https://nueform.io/f/your-form-slug?nf_visitor=user-12345&plan=premium&source=upgrade-flow
يتوفر plan وsource لاستبدال المتغيرات في عناوين الأسئلة وقفزات المنطق، إلخ، وفقاً للسلوك القياسي للحقول المخفية. nf_visitor فقط هو المحجوز.