Setting up your website invitation popup widget

Some times you may want to place an invitation widget on your website so that you can invite website visitors to complete your surveys.

You may also want to capture participants for a short term discussion, a mini community, a live online focus group, interview or usability test. The GroupQuality's survey tool built-in widget facilitates this process for you.

How to set up the survey invitation widget for your website.

When setting up the survey make sure you select it as an "Intercept" type of survey.

Once you have completed setting up your intercept survey, you will need to Start the survey. This will to generate a survey ID and intercept link. At the same time you will see a blue button located under the survey intercept link "Generate survey widget code" - click on this button to go to the widget configuration page.

Once you have clicked on the generate widget button you will be take to the widget configuration page. This is where you can customise your widget settings before adding the code snippet to on your website.

The settings area includes a number of customisable fields.

The intercept ID must not be change as this is the ID your widget will use to point to the correct survey. (Should you want to get fancy, you can use this ID to dynamically change the survey reference in your widget code. To do this you will need help from a website coder.)

The Title is the title that will appear at the top of your survey widget and would need to be something like "We need you feedback!".

The Body area is where you add any text or instructions for visitors to your website who see the widget.

The Button is where you change the text on the button website visitors select to take them to your survey.

The Display time is how many seconds before the website widget appears on the page you put the widget code snippet.

The Position option enables you to choose where the widget will appear you have four options to choose from.

The Format option is how the survey will appear to the website visitor once the select the start button. The Compact view will present a mobile view of the survey which is ideal for short feedback surveys. The Full desktop version will show a full desktop view of the survey (Note: it may still show as a mobile view if opened in a smart phone).

The Effect option is how you would like the widget to appear on the visitors screen. You can choose either Fade in and out or Slide in and out.

The Popup option is how you would like the survey to appear. If selected the survey will pop open a new window. If not selected the survey will open in a new tab for the desktop version, and open in an overlay on the same page for the compact version.

Option 1. If you selected Compact mobile view and did not select the Popup option you would create the following light box version for the survey:

Option 2. If you selected Compact mobile view and did selected the Popup option you would create the following popup new browser window:

Option 3. If you selected Desktop view and did not select the Popup option you would open the full survey view in a new browser tab (recommended for larger surveys).

Option 4. If you selected Desktop view and did select the Popup option you would open the full survey view in a new browser window.

Checking your settings & generating the code

Once you have added all your custom settings you are ready to generate the code and preview your widget. You do this by selecting the green Regenerate widget code button. The widget will appear on this screen based on the settings you have selected.

Select the button on the widget to preview how the survey will look for the website visitor.

Once you are happy with the setting copy the code that appears in the box above and paste it just before the closing <body/> tag on pages you want the widget to appear.

Trouble shooting

The code in your pages

The survey widget will appear on every page which has the widget code. Once the website visitor has completed the survey it places a completed cookie on the client (visitors) computer. As long as they have cookies enabled for their website browser the widget will not show again.

Style sheets

Sometimes a website's style sheets can unintentionally interfere with the behaviour of the survey widget. If this occurs you will need to get your website developer or website administrator to identify the conflict in your style sheets and make the appropriate adjustments. You can also try selecting a different appearance position for the widget. Common style sheet issue that may occur usually present themselves as a survey widget hidden by a website menu, or conflicts with other popup code on the same page.