URL parameters

The URL Parameters addon allows you to send data to be attached to the results from other sources.

What are Query Variables?

The parameter in the URL will be passed as a query variable. If you are not familiar with query variables, these are the small bits of text found at the end of URLs after a "?" character. Here's an example:

https://quizandsurveymaster.com/some-post?author=3

In this example, "author" is the parameter. The value being passed is "3". If you had multiple parameters or the page already has some query variables, you would separate them with a "&" character. For example:

https://quizandsurveymaster.com/some-post?age=27&event=Party

Example Use Case

Let's say you are sending an email with a link from an email service such as MailChimp or Drip. These allow you to add dynamic text in the emails. So, we can add those to the end of our URL.

For example, if our survey URL was:

https://quizandsurveymaster.com/event-survey

We may want to get the subscriber ID to be attached to the results for tracking purposes. So, we could have a parameter of "subscriber" such as:

https://quizandsurveymaster.com/event-survey?subscriber=34

Now, the results will show the subscriber was 34. Luckily, in Drip, they automatically append the subscriber ID as a parameter. However, if you are using a different service, you may need to use their templating which may look like this:

https://quizandsurveymaster.com/event-survey?subscriber={{ subscriber.id }}

Using that link, you would be able to send the subscriber ID from your system to be attached to the result of the survey.

INSTALLATION/SETUP

Once you have purchased the addon, you will have access to download the addon. To install, upload the addon as a normal WordPress plugin. To do so, go to the Plugins page and click Add New. Then, click Upload.

From there, upload the zip file that you downloaded when downloading the addon. Once the addon has uploaded, you should now have the plugin QSM - URL Parameters listed in your list of plugins. Activate that plugin. Once activated, the addon will add a new tab in the Addon Settings labeled "URL Parameters".

SETTINGS/CONFIGURE

Addon Settings For Flashcards Addon

First, enter your license key from your account into the "Addon License Key" field on the "URL Parameters" tab of the "Addon Settings". Be sure to click "Save Changes".

Once you have the license key entered, you can then use the new "URL Parameters" tab when editing your quiz or survey.

Example of quiz settings tab for URL Parameters

You can have as many parameters as you need on each of your quizzes and surveys.

To get started, click the "Create New Parameter" button.

Create new parameter popup that is empty

Each parameter will have 3 options you need to set:

  1. Parameter - This is the exact value that will be used in the URL.
  2. Label - This is what is shown to you when you review the results to designate what this is
  3. Default Value - If the parameter is not present in the URL, this value is what is attached to the result.

Here is an example set up:

Example parameter set up using the create new parameter popupNow that the popup is filled in, we need to click "Add Parameter".

Screenshot after we clicked add parameter button

Once you are finished, you will need to click "Save Parameters" to save your changes.

We can now use the "a" parameter to send data to our survey. For example:

http://example.com/example-survey?a=55

This will attach the value of "55" to our "Age" parameter. This can be seen when viewing the results in the Admin:

Example of seeing the URL Parameter values in the results

This will appear at the very bottom when viewing the results.

You are now set up and ready to go!