Identifiant de visiteur personnalisé (formulaires intégrés)

Lorsque vous intégrez un NueForm dans votre propre application, vous savez généralement déjà qui est l'utilisateur — il a un compte dans votre système, vous avez un identifiant utilisateur interne, et vous aimeriez que le formulaire restaure silencieusement ses réponses précédentes à chaque ouverture. Sans avoir à gérer les cookies de NueForm, le stockage du navigateur, ni que vos répondants voient une invite « Continuer ou recommencer ? ».

Le paramètre d'URL nf_visitor s'occupe de cela. Associé aux paramètres Permettre la reprise + Reprise automatique du formulaire, vos utilisateurs finaux ne voient que le formulaire — jamais les éléments d'interface de reprise de NueForm.

Exemple rapide

https://nueform.io/f/votre-form-slug?nf_visitor=utilisateur-12345

Si une réponse partielle existe pour utilisateur-12345, le formulaire la restaure silencieusement. Sinon, le formulaire démarre vierge. L'utilisateur ne voit jamais de modal, ne choisit jamais « Continuer ou recommencer », et ne sait même pas qu'il existe un mécanisme de reprise.

Pour « réinitialiser » un utilisateur (lui donner un nouveau départ), choisissez une nouvelle valeur nf_visitor :

https://nueform.io/f/votre-form-slug?nf_visitor=utilisateur-12345-tentative-2

Le suivi de l'identité est de votre responsabilité — choisissez le schéma adapté à votre application.

Liste de configuration

1. Ouvrez votre formulaire dans le constructeur NueForm.
2. Développez la section Permettre la reprise.
3. Activez Permettre aux répondants de reprendre là où ils se sont arrêtés.
4. Activez le nouveau sous-bouton Reprise automatique.
5. Intégrez le formulaire en utilisant le modèle d'URL ci-dessus, en fournissant votre propre valeur nf_visitor.

C'est tout.

Comment cela fonctionne

• nf_visitor est lu par la page de réponse à chaque chargement.
• Il remplace l'identifiant de visiteur basé sur les cookies que NueForm utilise normalement pour la reprise + la déduplication.
• Rien n'est écrit dans localStorage lorsque nf_visitor est présent — votre valeur est la source de vérité, et le navigateur de votre répondant reste propre.
• Les soumissions, les sauvegardes partielles et les recherches de reprise sont toutes basées sur votre valeur.
• Le paramètre est retiré de urlVariables avant que la substitution des variables du formulaire ne s'exécute, donc il n'apparaît jamais dans les champs cachés, les payloads de webhook, ni dans la détection de source de trafic des analyses.

Règles de validation

La valeur doit :

• Faire entre 1 et 256 caractères
• Correspondre à [A-Za-z0-9_\-:.@]+ — lettres, chiffres, tiret bas, tiret, deux-points, point et @

Les UUID, adresses e-mail et la plupart des identifiants opaques de votre propre base de données conviennent naturellement. Si la valeur ne correspond pas, NueForm l'ignore silencieusement et revient à l'identifiant de visiteur dérivé des cookies. Aucune erreur n'est affichée à l'utilisateur, vérifiez donc le comportement avec votre environnement de test avant la mise en production.

Quand nf_visitor est ignoré

nf_visitor est complètement ignoré lorsque le formulaire a Exiger la connexion du répondant activé.

Ces deux fonctionnalités sont mutuellement exclusives — vous ne pouvez pas avoir les deux. Si Exiger la connexion du répondant est activé, NueForm utilise l'identité authentifiée du répondant (session Auth0) et le paramètre d'URL est traité comme s'il n'avait jamais été fourni. Tout se déroule naturellement comme un chargement normal de formulaire avec session connectée.

Si vous avez besoin des deux comportements sur le même formulaire, vous devez en choisir un — ils répondent à des questions fondamentalement différentes :

• Exiger la connexion du répondant dit : « J'ai besoin d'une identité vérifiée à laquelle je peux faire confiance pour chaque soumission. »
• nf_visitor dit : « Je me porte garant de l'identité moi-même, veuillez utiliser cet identifiant opaque. »

Les deux ne peuvent pas être conciliés au niveau du formulaire. Si vous avez besoin d'une identité vérifiée dans un scénario intégré, utilisez Exiger la connexion du répondant et laissez vos utilisateurs se connecter directement à NueForm.

Association avec la Reprise automatique

La Reprise automatique est la fonctionnalité qui fait briller nf_visitor dans les scénarios intégrés. Avec les deux activées :

• Les utilisateurs qui reviennent voient immédiatement leurs réponses précédemment saisies. Pas d'invite, pas de choix.
• Les nouveaux utilisateurs (une nouvelle valeur nf_visitor) voient un formulaire vide.
• « Lecture seule après envoi » est respecté — une fois que l'utilisateur a soumis, les chargements suivants avec le même nf_visitor affichent la vue terminée en lecture seule, ce qui est exactement ce que vous voulez pour un scénario intégré d'enregistrement/reçu.

Sans la Reprise automatique, les utilisateurs qui reviennent verraient toujours le modal « Continuer ou recommencer ? » de NueForm même si vous avez fourni l'identité — un défaut UX pour les cas d'utilisation intégrés. La Reprise automatique le supprime.

Notes de confidentialité

• nf_visitor devient la clé de recherche principale pour la réponse dans la base de données NueForm. Choisissez des valeurs que vous contrôlez et qui ne se chevauchent pas entre des utilisateurs sans rapport.
• Ne mettez pas dans la valeur des informations personnelles identifiables (PII) que vous ne voulez pas voir stockées dans NueForm (par exemple, ne passez pas d'adresses e-mail brutes si vous pouvez utiliser un identifiant opaque à la place). La valeur est transmise aux payloads de webhook + aux analyses de la réponse.
• La valeur est visible pour quiconque a l'URL — traitez-la comme n'importe quel autre jeton d'URL. Si votre scénario intégré affiche la barre d'URL à l'utilisateur, envisagez un identifiant opaque plutôt que quelque chose de devinable.

Combinaison avec les champs cachés

D'autres paramètres d'URL fonctionnent toujours comme des variables de formulaire aux côtés de nf_visitor. Par exemple :

https://nueform.io/f/votre-form-slug?nf_visitor=utilisateur-12345&plan=premium&source=flux-mise-a-niveau

plan et source sont disponibles pour l'interpolation de variables dans les titres des questions, les sauts logiques, etc., conformément au comportement standard des champs cachés. Seul nf_visitor est réservé.