Skip to main content

Pre-populating the on-site survey link with identifiable URL parameters

S
Written by Steve Jones
Updated over 4 months ago

The on-site survey page also supports a number of variables that when incorporated into the URL, can be used to identify the respondent. This will prevent the personal detail fields appearing if the Enable name and email fields option has been enabled in the survey settings.

This powerful feature allows you to construct dynamic URLs using merge fields from within your email sending or marketing automation platform.

Distributing the on-site survey page URL with identifiable URL parameters ensures that respondents only need to answer the survey question, submit the survey and the Grapevine Surveys app will know who they are.

The following parameters are available for inclusion into the unique on-site survey page URL:

  • customer_id

  • order_id

  • first_name

  • last_name

  • email

Here's an example of how the on-site survey url would appear with identifiable URL parameters:

https://mystore.com/tools/survey/6cbf4819fcb64?first_name=David&last_name=Crane&[email protected]

Let's take a quick look at the use of these parameters.

customer_id

When a Shopify customer_id is present in the URL, no other personal details fields will appear, even if the Enable name and email fields option has been enabled.

Similarly, if a customer is logged in to their account on your store and visits an on-site survey page, the personal details fields will be hidden as the page will already know the respondents Shopify customer_id.

order_id

If a Shopify order_id is present in the URL, no other personal details fields will appear, even if the Enable name and email fields option has been enabled. The response submitted will be linked to a Shopify order and in turn, it will also be linked to the Shopify customer record associated with the order.

Whether or not you have enabled the Only capture one response per customer option on your survey (read more about limiting surveys to one response per customer), if we have already logged a response to the survey associated with that order_id, then the Response already submitted message will appear on the on-site survey page.

If every single parameter were present in the on-site survey page URL, we would always use the order_id as the main identifiable attribute.

first_name

If the Enable name and email fields option has been enabled and the first_name parameter has a value within the on-site survey page URL, we will populate the first name field within the personal details section of the survey.

When the response is submitted, if the email address is associated to an existing Shopify customer record that has a different first name, then we will store the response using the first_name value submitted with the survey response.

last_name

The same as above applies when the last_name parameter has a value within the on-site survey page URL.

email

If the Enable name and email fields option has been enabled and the email parameter has a value within the on-site survey page URL, we will populate the email field within the personal details section of the survey.

Need any help?

If you need any help pre-populating your on-site survey page URL with identifiable customer parameters, then please do just get in touch and we will do our best to help.

Did this answer your question?