When using public links to distribute questionnaires through e-satisfaction.com, understanding how URL parameters influence questionnaire behavior is key for a smooth and accurate feedback process.
A public link that includes only metadata fields looks like:
https://collection.e-satisfaction.com/q/pub/{questionnaire_id}?{metadata_name}={metadata_value}
Every time this link is opened, a new questionnaire instance is created.
Multiple submissions are allowed, even with the same metadata values.
Ideal for collecting independent responses from the same or different users.
When a reference_id is included in the URL, the behavior changes:
https://collection.e-satisfaction.com/q/pub/{questionnaire_id}/ref/{reference_id}?{metadata_name}={metadata_value}
A single questionnaire instance is tied to each unique reference_id.
If the link is opened again using the same reference_id, the same questionnaire instance is reopened.
Using a new reference_id always creates a new instance, regardless of metadata.
You can specify the questionnaire language (locale) by appending a locale value directly before the ?, before the metadata parameters. The structure becomes:
https://collection.e-satisfaction.com/q/pub/{questionnaire_id}/{locale}?{metadata_name}={metadata_value}
The /el? part sets the questionnaire language to Greek.
You can replace el with other supported locale codes like en, ro, bg, etc. Learn more about supported languages here.
The language shown to the user will correspond to the specified locale.
If no locale is provided, the system will default to the user’s browser default language.
This works with or without a reference_id.
reference_id: Uniquely identifies each questionnaire instance (e.g., per transaction).
locale: Controls the display language of the questionnaire.
Metadata fields: Add context to the submission (e.g., customer type, region, etc.).
Example Scenario
If you're sending out a feedback form in different languages, you could:
Use a unique reference_id per transaction.
Include a locale value to show the questionnaire in the customer’s preferred language.
Pass relevant metadata fields for tracking and analysis.
When distributing questionnaires via public links on e-satisfaction.com, the behavior of the link is influenced by three key URL parameters:
reference_id: Ensures each questionnaire instance is uniquely tied to an ID. Reopening the same link reopens the same instance. Without it, each visit creates a new instance.
locale: Sets the language of the questionnaire (e.g., /el, /en, /ro). If omitted, the user's browser language is used.
Metadata fields: Add extra context (e.g., customer type, region). These do not restrict multiple submissions unless combined with a reference_id.
Parameter Purpose Affects Questionnaire Instance?
reference_id Uniquely identifies a transaction/event ✅ Yes
locale Sets the questionnaire language ❌ No
Metadata Adds reporting and context data ❌ No
(e.g., customer_id,
store_code)
For help constructing links with locale, reference IDs, and metadata, feel free to contact our support team.