Eigene Besucher-ID (eingebettete Formulare)

Wenn du ein NueForm in deine eigene App einbettest, weißt du normalerweise bereits, wer der Nutzer ist — er hat ein Konto in deinem System, du hast eine interne Nutzer-ID, und du möchtest, dass das Formular seine früheren Antworten bei jedem Öffnen stillschweigend wiederherstellt. Ohne dass du NueForm-Cookies oder Browser-Speicher verwalten musst und ohne dass deine Teilnehmer eine Abfrage wie „Fortsetzen oder neu beginnen?" sehen.

Der URL-Parameter nf_visitor übernimmt das. In Kombination mit den Formulareinstellungen Fortsetzen erlauben + Auto-Fortsetzen sehen deine Endnutzer nur das Formular — nie die Fortsetzen-Oberfläche von NueForm.

Schnelles Beispiel

text

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

Existiert eine Teilantwort für user-12345, stellt das Formular sie stillschweigend wieder her. Falls nicht, startet das Formular neu. Der Nutzer sieht nie ein Modal, wählt nie zwischen „Fortsetzen oder neu beginnen" und weiß überhaupt nicht, dass es einen Fortsetzen-Mechanismus gibt.

Um einen Nutzer „zurückzusetzen" (ihm einen Neustart zu geben), wähle einen neuen nf_visitor-Wert:

text

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

Die Identitätsverfolgung liegt in deiner Verantwortung — wähle das Schema, das zu deiner App passt.

Einrichtungs-Checkliste

Öffne dein Formular im NueForm-Builder.
Klappe den Abschnitt Fortsetzen erlauben auf.
Aktiviere Teilnehmern erlauben, dort fortzusetzen, wo sie aufgehört haben.
Aktiviere den neuen untergeordneten Schalter Auto-Fortsetzen.
Bette das Formular mit dem obigen URL-Muster ein und übergib deinen eigenen nf_visitor-Wert.

Das war's.

So funktioniert es

nf_visitor wird bei jedem Laden von der Formular-Teilnehmerseite gelesen.
Er ersetzt die Cookie-basierte Besucher-ID, die NueForm normalerweise für Fortsetzen + Deduplizierung verwendet.
Wenn nf_visitor vorhanden ist, wird nichts in localStorage geschrieben — dein Wert ist die alleinige Wahrheitsquelle, und der Browser deiner Teilnehmer bleibt sauber.
Übermittlungen, Teilspeicherungen und Fortsetzen-Abfragen basieren alle auf deinem Wert.
Der Parameter wird vor der Formularvariablen-Ersetzung aus urlVariables entfernt, sodass er nie in versteckte Felder, Webhook-Payloads oder die Traffic-Quellen-Erkennung der Analytics gelangt.

Validierungsregeln

Der Wert muss:

1–256 Zeichen lang sein
[A-Za-z0-9_\-:.@]+ entsprechen — Buchstaben, Ziffern, Unterstrich, Bindestrich, Doppelpunkt, Punkt und @

UUIDs, E-Mail-Adressen und die meisten opaken IDs aus deiner eigenen Datenbank passen problemlos. Wenn der Wert nicht dem Muster entspricht, ignoriert NueForm ihn stillschweigend und greift auf die Cookie-basierte Besucher-ID zurück. Es wird kein Fehler angezeigt — überprüfe das Verhalten daher mit deinem Test-Setup, bevor du live gehst.

Wann `nf_visitor` ignoriert wird

nf_visitor wird vollständig ignoriert, wenn beim Formular Teilnehmer-Anmeldung erforderlich aktiviert ist.

Diese beiden Funktionen schließen sich gegenseitig aus — beides zusammen geht nicht. Ist Teilnehmer-Anmeldung erforderlich aktiviert, verwendet NueForm die authentifizierte Identität des Teilnehmers (Auth0-Session), und der URL-Parameter wird behandelt, als wäre er nie übergeben worden. Alles läuft dann ganz normal wie beim Laden eines Formulars mit angemeldetem Nutzer.

Wenn du beide Verhaltensweisen im selben Formular brauchst, musst du dich für eine entscheiden — sie beantworten grundlegend verschiedene Fragen:

Teilnehmer-Anmeldung erforderlich sagt: „Ich brauche eine verifizierte Identität, der ich bei jeder Übermittlung vertrauen kann."
nf_visitor sagt: „Ich bürge selbst für die Identität — bitte verwende diese opake ID."

Auf Formularebene lassen sich die beiden nicht vereinbaren. Wenn du eine verifizierte Identität in einem eingebetteten Szenario brauchst, verwende Teilnehmer-Anmeldung erforderlich und lass deine Nutzer sich direkt bei NueForm anmelden.

Kombination mit Auto-Fortsetzen

Auto-Fortsetzen ist die Funktion, die nf_visitor in eingebetteten Szenarien glänzen lässt. Mit beidem aktiviert:

Wiederkehrende Nutzer sehen ihre zuvor eingegebenen Antworten sofort. Keine Abfrage, keine Auswahl.
Neue Nutzer (ein frischer nf_visitor-Wert) sehen ein leeres Formular.
„Schreibgeschützt nach dem Absenden" wird respektiert — sobald der Nutzer abgeschickt hat, zeigen nachfolgende Aufrufe mit demselben nf_visitor die schreibgeschützte abgeschlossene Ansicht. Genau das, was du für ein eingebettetes Beleg-/Quittungsszenario möchtest.

Ohne Auto-Fortsetzen würden wiederkehrende Nutzer trotz deiner mitgelieferten Identität weiterhin das Modal „Fortsetzen oder neu beginnen?" von NueForm sehen — ein UX-Makel für eingebettete Anwendungsfälle. Auto-Fortsetzen beseitigt ihn.

Hinweise zum Datenschutz

nf_visitor wird zum primären Suchschlüssel für die Antwort in der NueForm-Datenbank. Wähle Werte, die du kontrollierst und die zwischen verschiedenen Nutzern nicht kollidieren.
Lege keine personenbezogenen Daten in den Wert, die du nicht in NueForm gespeichert haben möchtest (übergib z. B. keine rohen E-Mail-Adressen, wenn stattdessen eine opake ID möglich ist). Der Wert wandert mit in Webhook-Payloads + Analytics für die Antwort.
Der Wert ist für jeden mit der URL sichtbar — behandle ihn wie jedes andere URL-Token. Wenn dein eingebettetes Szenario dem Nutzer die Adressleiste zeigt, erwäge eine opake ID statt eines erratbaren Werts.

Kombination mit versteckten Feldern

Andere URL-Parameter funktionieren neben nf_visitor weiterhin als Formularvariablen. Zum Beispiel:

text

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

plan und source stehen für die Variableninterpolation in Fragetiteln, Logiksprüngen usw. zur Verfügung — gemäß dem Standardverhalten versteckter Felder. Nur nf_visitor ist reserviert.